Filter by result type

HERE Geocoding and Search has an optional parameter types that allows limiting the results to specific types.

To simplify the usage of this feature, HERE Geocoding and Search API introduces a hierarchical system of values supported by the types filter. These values include:

• The same values as resultType and result sub-types.
• "Group" values, which group together logically related result types.

The customer application can set types to either of the values supported by the endpoint or combine values, using a comma separated list.

Note that not all of these values are or will be supported by the types filter for all or any of the endpoints. However, if a value is supported by any of the endpoints, its syntax and semantics will be the same.

Support of types filter by HERE Geocoding and Search endpoints

The values per endpoint which are supported:

"-" - currently not supported; "N/A" - not applicable

Description of the supported values:

• area: restricting results to result types: locality or administrativeArea including all the sub-types.
• city: restricting results to result type locality and locality type city.
• postalCode: restricting results to postal codes: either result type postalCodePoint or result type locality with locality type postalCode. Note that in Ireland and Singapore, where each address has unique postal code, postalCodePoint results are replaced by houseNumber results.
• address: restricting results to result types houseNumber, street, postalCodePoint, intersection, or addressBlock.
• street: restricting results to result type: street.
• houseNumber: restricting results to result type: houseNumber, including house number types PA (Point Address) and interpolated; including exact house number matches and house number fallbacks.

For more information about /types parameter, see: API Reference.

For lookup endpoint, types filter is not applicable and will not be supported at all.

All the values not covered by this table are not supported by the endpoint. For queries with parameters or values of parameters not supported by specific endpoints, HERE Geocoding and Search responds with a "400" error code.