Powered by Zoomin Software. For more details please contactZoomin

HERE Geocoding and Search - Developer Guide

Product category
Technology
Doc type
Version
Product lifecycle
This publication

HERE Geocoding and Search - Developer Guide: Place results

Table of Contents

Place results

  • Last UpdatedSep 16, 2024
  • 3 minute read

Place results

A place result represents a point of interest: A point feature with a name, a position, an address and a list of categories defining the functionality characterizing the point. A "place result" (shortly also name "place") can be as various as a restaurant, an EV charging station, an airport, a stadium, etc.

HERE Geocoding and Search place results can be identified through the place value of the resultType response element.

places categories and food types

The sub-type field categories contains a list of IDs referencing the different functionality of the location. For restaurant results (result with a level2 category ID 100-1000), the sub-type foodTypes contains a list of IDs for the cuisines that the restaurant offers.

For example, Glacier Vanille Noire (in Marseille):

{
    "title": "Vanille Noire",
    "id": "here:pds:place:250jx7ps-8f300d0f8ec60e31fb76a3d22f00f18f",
    "language": "en",
    "resultType": "place",
    "address": {
        "label": "Vanille Noire, 13 Rue Caisserie, 13002 Marseille, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "PAC",
        "state": "Provence-Alpes-Cote d'Azur",
        "county": "Bouches-du-Rhône",
        "city": "Marseille",
        "district": "2nd Arrondissement",
        "street": "Rue Caisserie",
        "postalCode": "13002",
        "houseNumber": "13"
    },
    "position": { "lat": 43.2972, "lng": 5.36871 },
    "access": [{ "lat": 43.29723, "lng": 5.36866 }],
    "categories": [
        { "id": "100-1000-0000", "name": "Restaurant", "primary": true },
        { "id": "600-6300-0064", "name": "Food/Beverage Specialty Store" },
        { "id": "700-7200-0253", "name": "Catering & Other Food Services" }
    ],
    "references": [
        { "supplier": { "id": "core" }, "id": "1149014863" },
        { "supplier": { "id": "tripadvisor" }, "id": "25550756" },
        { "supplier": { "id": "tripadvisor" }, "id": "6596803" },
        { "supplier": { "id": "yelp" }, "id": "LNW8pvVArKkCYg_SM0WfXQ" }
    ],
    "foodTypes": [{ "id": "800-063", "name": "Ice Cream", "primary": true }],
    "contacts": [
        {
            "phone": [{ "value": "+33777336819" }],
            "mobile": [{ "value": "+33777336819", "categories": [{ "id": "100-1000-0000" }, { "id": "600-6300-0064" }] }],
            "www": [{ "value": "https://www.facebook.com/275599309268684", "categories": [{ "id": "600-6300-0064" }] }],
            "email": [{ "value": "nicolas@vanillenoire.com", "categories": [{ "id": "100-1000-0000" }] }]
        }
    ],
    "openingHours": [
        {
            "text": ["Mon-Sun: 13:00 - 19:00"],
            "isOpen": true,
            "structured": [
                { "start": "T130000", "duration": "PT06H00M", "recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU" }
            ]
        }
    ]
}

A result of type place must have at least one category. From the list of categories a place might have, one must be primary. This is signaled by the boolean attribute primary set in one of the categories list element. In the previous example, the primary category is 100-1000-0000 (Restaurant). This restaurant serves the food type 800-063 (Ice Cream)

Note that the language in which the names of the categories and food types are given respects HERE Geocoding and Search language behavior.

Additional places base attributes

Beside the mandatory categories and the optional foodTyes fields, place results may have additional attributes specific to their type place:

  • contacts - a list of per place category contact details (phone, web, ...) for place results

  • openingHours - a list of per place category opening hours for place results

  • chains - place chains metadata to allow customers to choose a chain icon

  • accessRestriction - a list of per place category access restriction information.

    This information is currently only avalaible for places with one of the categories

    • Level 2 800-8500 : Parking
    • Level 3 700-7900-0131: Truck Parking
  • references - Data source ids, when the place result has a contribution from specific suppliers. For instance:

Endpoints returning place results: /discover, /autosuggest, /lookup, /browse, /geocode /revgeocode

Note

places returned by /geocode and /revgeocode do not contain any additional attribute.

Was this article helpful?
TitleResults for “How to create a CRG?”Also Available inAlert