Places

A place (Place) is a GeoJSON Feature with Point geometry and a required string id. Its properties carry the address, POI details, entry points and the ids for follow-up calls. A list of places (Places) is a FeatureCollection of them.

Where places are used

Returned by search, geocoding, reverse geocoding and place details. EV charging availability adds real-time status to EV places.
Displayed by the places module, as markers with popups and interaction.

Place object structure

id: a unique string.
geometry.coordinates: [longitude, latitude].
bbox: the area the place covers, when it is wider than a point (a city, a country).
properties:
- type: the place type.
- address: the structured address.
- poi: POI details, when type is 'POI'.
- relatedPois: parent and child POIs.
- entryPoints: entrances.
- geographyType: administrative levels, when type is 'Geography'.
- chargingPark: EV charging infrastructure.
- addressRanges: house number ranges, when type is 'Address Range'.
- mapcodes: mapcodes for the location.
- dataSources: ids for follow-up calls.

Search and reverse geocoding results add their own properties.

Place types

place.properties.type is one of placeTypes:

Type	Meaning
`POI`	Point of interest: a business, landmark or facility
`Street`	A named street
`Geography`	An administrative area: city, state, country, postal code area
`Point Address`	A street address with a building number
`Address Range`	A range of house numbers along a street segment
`Cross Street`	An intersection of two streets

Address

place.properties.address; only freeformAddress is always present:

Full address: freeformAddress, formatted the way the place's country writes addresses.
Street: streetNumber, streetName, routeNumbers (road numbers such as highway designations).
Local areas: neighborhood (informal, no official boundary), municipalitySecondarySubdivision, municipalitySubdivision, municipality (city or town), localName.
Administrative divisions: countryTertiarySubdivision, countrySecondarySubdivision (county), countrySubdivision (state or province), countrySubdivisionName (its full name, when countrySubdivision is abbreviated), countrySubdivisionCodeIso (e.g. 'US-CA').
Postal codes: postalCode, extendedPostalCode, and postalName on a postal code area.
Country: country, countryCode (ISO 3166-1 alpha-2, e.g. 'NL'), countryCodeISO3 (alpha-3, e.g. 'NLD').

Point of interest (POI)

place.properties.poi, present when type is 'POI':

name: display name, in the request language.
phone, url, brands (e.g. ['Shell']).
categories: standardized POICategory codes, e.g. ['ITALIAN_RESTAURANT'], for filtering and icon mapping. The POI categories service resolves words to them.
localizedCategories: human-readable category names in the request language, e.g. ['italian', 'restaurant'], for display.
openingHours: when the call asked for it with openingHours: 'nextSevenDays'.
- mode: always 'nextSevenDays'.
- timeRanges: open periods, each a start and end with a Date and its parts (dateYYYYMMDD, year, month 1–12, day, hour, minute). An overnight period ends on the next day.
- alwaysOpenThisPeriod: true for a place open around the clock, whose timeRanges is then empty.
timeZone.ianaId: e.g. 'Europe/Amsterdam'.

Related POIs

place.properties.relatedPois links a POI to the ones it contains or sits in:

relationType: 'parent' when this POI is inside the referenced one (a store in a mall), 'child' when the referenced one is inside it.
id: pass it to place details to fetch the related POI.

Entry points

place.properties.entryPoints lists the entrances of a building or facility, for routing to the right door:

position: [longitude, latitude].
type: 'main' (at most one per place) or 'minor', when the service classifies it.
functions: what the entrance is for, e.g. 'FrontDoor', 'ServiceEntrance', 'ParkingGarage'.

Reverse geocoding returns entry points on the road network, where a vehicle arrives rather than where the door is, and leaves their type absent. getPosition picks the main entry point over the place's position when asked to.

Geography

place.properties.geographyType, present when type is 'Geography', from largest to smallest:

Country
CountrySubdivision: state, province
CountrySecondarySubdivision: county
CountryTertiarySubdivision
Municipality: city or town
MunicipalitySubdivision: district within a city
MunicipalitySecondarySubdivision
Neighbourhood
PostalCodeArea

An area with several administrative roles carries several types.

EV charging stations

place.properties.chargingPark, on EV charging station POIs:

connectors: connector counts, grouped by type and power.
- connector: type (e.g. 'IEC62196Type2CCS'), ratedPowerKW, chargingSpeed, currentType, voltageV, currentA.
- count: how many connectors of that kind the park has.
chargingStations: the charging stations, on search results.
- chargingPoints: each charging point (EVSE): capabilities, restrictions, its connectors, and evseId when the operator publishes one.

Neither carries real-time status: EV charging availability adds it, and shows how to read both.

Address ranges

place.properties.addressRanges, present when type is 'Address Range':

rangeLeft, rangeRight: the house numbers on each side, looking from from towards to.
from, to: the segment's end coordinates, [longitude, latitude].

Mapcodes

place.properties.mapcodes, short codes usable instead of coordinates:

type: 'Local' (shortest, needs its territory), 'International' (unambiguous worldwide) or 'Alternative' (another local code).
fullMapcode: the complete code, territory included, e.g. 'NLD 4J.P2'.
territory: on local and alternative codes, e.g. 'NLD'.
code: the code without the territory, e.g. '4J.P2'.

Data sources

place.properties.dataSources holds the ids for follow-up calls:

geometry.id: pass it to geometry data for the place's outline. On search results only; a reverse geocoded place has none.
poiDetails.id: pass it to place details.
chargingAvailability.id: read by EV charging availability, on search results and route charging stops.

Search-specific properties

Search results (SearchPlaceProps) add:

score: relevance; higher is a better match.
distance: meters from the geoBias position, when one was given.
info: the original data source.

Geocoding results (GeocodingProps) carry score and distance too, plus matchConfidence.score for how well the text matched; their type is never 'POI'.

Reverse geocoding properties

Reverse geocoded places (RevGeoAddressProps) add originalPosition: the [longitude, latitude] the service matched. The feature's own geometry holds the position you queried.