Places Categories

This parameterless method returns the complete list of place categories available in the currently used data. 

Output

If the request succeeds, the response is a list of place categories. For each category, the following fields are returned:

{
    "placeCategories": [
        {
            "id": "navteq-lcms:700-7400-0352",
            "name": "Recycling Center",
            "description": "A business that accepts, treats and processes waste material for reuse. "
        },
        {
            "id": "navteq-lcms:700-7200-0259",
            "name": "Human Resources and Recruiting Services",
            "description": "A business that provides advice and services to businesses and other organizations in the fields of human resources and recruiting."
        }
    ]
}

The ID of a category is used to identify the category in the Places by Position, Places by Text and Places by Area API endpoints. The categoryFilter parameter of these endpoints expects a comma-separated list of category IDs.

Categories can be grouped by prefixes of their IDs, like for example:

For convenience, the categoryFilter parameter also accepts these prefixes, so you can filter for all enclosed categories by giving just the prefix rather than the complete list of sub-categories. 

For example, when filtering for navteq-lcms:700-7200 you will get the corresponding child categories like navteq-lcms:700-7200-0252and navteq-lcms:700-7200-0254.
If you filter for navteq-lcms:700, you will get all its grandchildren categories, for example navteq-lcms:700-7200-0254 and navteq-lcms:700-7400-0352.
 

Requests using the prefix are also faster than the ones using the complete list, thus avoiding hitting the timeout.

Keep in mind that this endpoint does not support setting a different language or setting country filters.