Places (Search) API Developer's Guide

Filtering by Category

The Places (Search) API allows you to filter results by Point of Interest (POI) category, which describe and group POIs. Not all categories are applicable for all POIs and categories can be added and removed without advance notice.

Place Categories

The Places (Search) API provides the entrypoint Place Categories Entrypoint which allows you to obtain a list of the categories that are currently used in a given location.

Only a subset of the categories are permanent. Some categories may be removed in future releases. The permanent categories are as follows:

  • eat-drink
    • restaurant
    • coffee-tea
    • snacks-fast-food
  • going-out
  • sights-museums
  • transport
    • airport
  • accommodation
  • shopping
  • leisure-outdoor
  • administrative-areas-buildings
  • natural-geographical
  • petrol-station
  • atm-bank-exchange
  • toilet-rest-area
  • hospital-health-care-facility

Cuisine Categories

In addition to the POI categories, the Places (Search) API also supports cuisine categories. A list of cuisine categories can be obtained from the entrypoint Cuisine Categories Entrypoint. You can only use cuisine category filters in requests to the Explore entrypoint and Tiles entrypoint.