GuidesAPI Reference
Guides

Search places near other places

To search from the position (45.75428,4.86505) in Lyon (France) for a "Decitre" bookshop close to the "Confluence" shopping mall, send the following request:\

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=45.75428,4.86505
    &limit=1
    &q=decitre+near+part-dieu
    &apiKey={YOUR_API_KEY}

The result lists detailed information about the related location objects:

{
  "items": [
    {
      "title": "Decitre",
      "id": "here:pds:place:250u05kq-e3ec62c2a2274a0aa9ff42f9f71d70b7",
      "resultType": "place",
      "address": {
        "label": "Decitre, 69003 Lyon, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "ARA",
        "state": "Auvergne-Rhône-Alpes",
        "county": "Rhône",
        "city": "Lyon",
        "district": "3e Arrondissement",
        "postalCode": "69003"
      },
      "position": { "lat": 45.76068, "lng": 4.85667 },
      "access": [{ "lat": 45.76068, "lng": 4.85667 }],
      "distance": 964,
      "categories": [{ "id": "600-6700-0087", "name": "Librairie", "primary": true }],
      "references": [
        { "supplier": { "id": "core" }, "id": "1178605849" },
        { "supplier": { "id": "yelp" }, "id": "DjM5s7AdHFSppm9uSa0kYg" },
        { "supplier": { "id": "yelp" }, "id": "upIk75QfMl_sDEwujNkVpQ" }
      ],
      "contacts": [
        {
          "phone": [{ "value": "+33426680030" }, { "value": "+33426680085" }, { "value": "+33426680087" }],
          "fax": [{ "value": "+33426680081" }],
          "www": [
            { "value": "http://www.decitre.fr" },
            { "value": "http://www.decitre.fr/magasins/librairie-lyon-part-dieu.aspx" }
          ],
          "email": [{ "value": "[email protected]" }]
        }
      ],
      "openingHours": [
        {
          "text": ["Mon-Sat: 09:30 - 20:00"],
          "isOpen": true,
          "structured": [{ "start": "T093000", "duration": "PT10H30M", "recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA" }]
        }
      ]
    }
  ]
}

More details about the /discover enpoint parameters can be found in the API Reference.