Places (Search) API Developer's Guide

Place Categories Entrypoint

This entrypoint is used to obtain the place categories available for a given location. This entrypoint might be used to give a user a list of categories to choose from. The Place Categories Entrypoint represents sets of locally relevant categories that are organized in a directed acyclic graph. The category graph may change in the future and may differ depending on the location of the request. A set of permanent, top-level, place categories can be found at Categories.

The Place Categories Entrypoint is a Places (Search) API Core entrypoint.

Entrypoint URI


Entrypoint Parameters

Parameter Type Description
at Position (format: latitude,longitude[;cgen=(map|gps|sgps)][;u=\d+]); required, unless one of the Geolocation or X-Map-Viewport headers or the in are set. Coordinates of search location expressed as latitude, longitude. Additional parameters can be passed which provide more context such as the uncertainty and how the coordinates were generated. For example, "52.5304417,13.4111201", "52.5304417,13.4111201;cgen=gps;u=100" or "52.5304417,13.4111201;u=100". For a full description, see the Location Contexts documentation.
in Area; required, unless one of the Geolocation or X-Map-Viewport headers or the at parameter are set. This parameter limits results to the boundary of the specified area. The search area can be expressed as:
  • circle specified as a centre point with latitude and longitude; and a radius around that point. Format: latitude,longitude;r=\\d+(\\.\\d+)?[;cgen=(map|gps|sgps)][;u=\\d+]
  • bounding box specified as 4 values, denoting west longitude, south latitude, east longitude, north latitude.
  • polygon (Experimental) defined by the coordinates (latitude, longitude) of each of the polygon's point. At least 4 coordinates (8 values) are required. The first and the last coordinate must be the same
For a full description, see the Location Contexts documentation.

GET Method

The GET method provides access to the place categories relevant to a given position. When no such location is provided with the request, the response contains the graph with all place categories recognized by the API.

Response Media Type

Responses to requests to this endpoint will have the urn:nlp-types:category-graph media type. See the urn:nlp-types:category-graph media type documentation for details about the structure and content of the response.

Request Example

Response Example

  "items": [
      "id": "eat-drink",
      "title": "Eat & Drink",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ ]
      "id": "restaurant",
      "title": "Restaurant",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "eat-drink" ]
      "id": "snacks-fast-food",
      "title": "Snacks/Fast food",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "eat-drink" ]

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on