Search for a place using a chain

This tutorial demonstrates how to search for places by their chain.

Procedure

To search for Shell places from the position (52.33012,14.41896) in Germany near the polish border but only get results in Germany, send the following request:

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=52.33012,14.41896
    &q=Shell
    &limit=2
    &in=countryCode%3ADEU
    &apiKey={YOUR_API_KEY}

The result lists detailed information about the related location objects:

{
  "items": [
    {
      "title": "Shell",
      "id": "here:pds:place:276u361x-8134bdc570ac4bca89ea8de8f2e6ef2d",
      "ontologyId": "here:cm:ontology:shell",
      "resultType": "place",
      "address": {
        "label": "Shell, 15236 Jacobsdorf, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BB",
        "state": "Brandenburg",
        "countyCode": "LOS",
        "county": "Oder-Spree",
        "city": "Jacobsdorf",
        "postalCode": "15236"
      },
      "position": { "lat": 52.32121, "lng": 14.38886 },
      "access": [{ "lat": 52.32121, "lng": 14.38886 }],
      "distance": 2273,
      "categories": [
        { "id": "700-7600-0116", "name": "Tankstelle", "primary": true },
        { "id": "700-7900-0131", "name": "Lkw-Parkplatz" }
      ],
      "chains": [{ "id": "10" }],
      "contacts": [{ "phone": [{ "value": "+493360849300" }], "fax": [{ "value": "+493360849301" }] }],
      "openingHours": [
        {
          "text": ["Mon-Sun: 00:00 - 24:00"],
          "isOpen": true,
          "structured": [
            { "start": "T000000", "duration": "PT24H00M", "recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU" }
          ]
        }
      ]
    },
    {
      "title": "Shell",
      "id": "here:pds:place:276u361x-9b1a09934b3b43b397e01bae933e2ecf",
      "ontologyId": "here:cm:ontology:shell",
      "resultType": "place",
      "address": {
        "label": "Shell, 15236 Jacobsdorf, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BB",
        "state": "Brandenburg",
        "countyCode": "LOS",
        "county": "Oder-Spree",
        "city": "Jacobsdorf",
        "postalCode": "15236"
      },
      "position": { "lat": 52.32037, "lng": 14.38395 },
      "access": [{ "lat": 52.32037, "lng": 14.38395 }],
      "distance": 2615,
      "categories": [
        { "id": "700-7600-0116", "name": "Tankstelle", "primary": true },
        { "id": "600-6000-0061", "name": "kleiner Lebensmittelladen" },
        { "id": "700-7900-0131", "name": "Lkw-Parkplatz" }
      ],
      "chains": [{ "id": "10" }],
      "references": [
        { "supplier": { "id": "core" }, "id": "56108280" },
        { "supplier": { "id": "core" }, "id": "56108284" }
      ],
      "contacts": [
        {
          "phone": [{ "value": "+493360849621" }, { "value": "+493360881680" }, { "value": "+49493360881680" }],
          "fax": [{ "value": "033608 81682" }, { "value": "3360881682" }],
          "www": [
            { "value": "http://www.shell.de/" },
            { "value": "https://find.shell.com/de/fuel/10025882-pillgram-a12-bieg-helle-nord" },
            { "value": "https://find.shell.com/de/fuel/10025893-pillgram-a12-bieg-helle-sud" }
          ],
          "email": [{ "value": "shellcustomercare@shell.com" }]
        }
      ],
      "openingHours": [
        {
          "text": ["Mon-Sun: 00:00 - 24:00"],
          "isOpen": true,
          "structured": [
            { "start": "T000000", "duration": "PT24H00M", "recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU" }
          ]
        }
      ]
    }
  ]
}

Additional information

For more information about /discover parameters, see: API Reference.