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": "[email protected]", "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.

📘

Note:

place result type can return a postal code or a detailed postal code, depending on the coverage. For more information, see detailed postal codes in address results.

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:

  • yelp to be used against the Yelp Fusion API
  • tripadvisor to be used against the Tripadvisor location endpoint
  • core for HERE Map Data products with Core POI content (RDF, GDF, NAVSTREETS, File Geodatabase, POI XML)

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

📘

Note

Places returned by the /geocode and /revgeocode endpoints do not contain any additional attribute.