Chain search

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

Authorization: Bearer [your token]

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.