Place results
- Last UpdatedSep 16, 2024
- 3 minute read
Place results
A place result represents a point of interest: A point feature with a name, a position, an address and a list of categories defining the functionality characterizing the point. A "place result" (shortly also name "place") can be as various as a restaurant, an EV charging station, an airport, a stadium, etc.
HERE Geocoding and Search place results can be identified through the place
value of the resultType
response element.
places categories and food types
The sub-type field categories
contains a list of IDs referencing the different functionality of the location. For restaurant results (result with a level2 category ID 100-1000
), the sub-type foodTypes
contains a list of IDs for the cuisines that the restaurant offers.
For example, Glacier Vanille Noire (in Marseille):
A result of type place
must have at least one category. From the list of categories a place might have, one must be primary. This is signaled by the boolean attribute primary
set in one of the categories
list element. In the previous example, the primary category is 100-1000-0000
(Restaurant). This restaurant serves the food type 800-063
(Ice Cream)
Note that the language in which the names of the categories and food types are given respects HERE Geocoding and Search language behavior.
Additional places base attributes
Beside the mandatory categories
and the optional foodTyes
fields, place results may have additional attributes specific to their type place
:
-
contacts
- a list of per place category contact details (phone, web, ...) forplace
results -
openingHours
- a list of per place category opening hours forplace
results -
chains
- place chains metadata to allow customers to choose a chain icon -
accessRestriction
- a list of per place category access restriction information.This information is currently only avalaible for places with one of the categories
- Level 2
800-8500
: Parking - Level 3
700-7900-0131
: Truck Parking
- Level 2
-
references
- Data source ids, when the place result has a contribution from specific suppliers. For instance:yelp
to be used against the Yelp Fusion APItripadvisor
to be used against the Tripadvisor location endpointcore
for HERE Map Data products with Core POI content (RDF, GDF, NAVSTREETS, File Geodatabase, POI XML)
Endpoints returning place results: /discover
, /autosuggest
, /lookup
, /browse
, /geocode
/revgeocode
Note
places returned by
/geocode
and/revgeocode
do not contain any additional attribute.