Result types

HERE Geocoding and Search provide customers a flexible way to retrieve relevant results for textual queries.

All results are typed: Each result item contains a response element resultType with a well-defined value.

There are currently 9 values in this resultType , which is an enum of: place, locality, street, houseNumber, administrativeArea, addressBlock, intersection, postalCodePoint, chainQuery, categoryQuery.

🚧

WARNING

New resultType values can get added to the list without further notice. Applications using HERE Geocoding and Search must not assume the list is fixed. For instance intersection and postalCodePoint are newly introduced result types.

Following chapters are grouping all result types into 3 main kinds:

• a place (a "point of interest" in the GIS literature)
• an address related result (a city, a street, a house, ...)
• a follow-up query suggestion

📘

Note:

Detailed and area postal codes
In countries that use detailed postal codes, such as Great Britain or the USA, postal codes can be assigned to a small number of addresses or even a single building. Detailed postal codes are often used to precisely locate a place — sometimes as accurately as a specific house number.

For countries where HERE Geocoding & Search supports detailed postal codes, expect a detailed postal code for place and houseNumber results, depending on coverage. For all area results types, HERE Geocoding & Search returns the area postal code. For more information, see the Geocode local coverage.