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}

Note

This request uses API key authentication. For more information about authentication options on the HERE platform, see the Identity & Access Management Guide.

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.

results matching ""

    No results matching ""