Nearby

Search around the specified location

Description

The Nearby API allows you to search for places around a specified location. It returns a list of nearby features, including their coordinates, properties, and categories. You can customize the search by specifying parameters such as categories, coordinates

tip

When using that, just use our Enterprise Dashboard or guild API Key to create your API Key try for free!

Base URL

https://mapapis.openmap.vn/v1

Endpoint

GET /nearby

Example

Request:

GET /nearby?size=5&categories=restaurant&point.lon=105.852484&point.lat=21.0265361&boundary.circle.radius=5

Response:

{
  "errors": null,
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.852105, 21.0257],
        "type": "Point"
      },
      "properties": {
        "name": "Quán Ngon nhà Hầm",
        "housenumber": null,
        "street": null,
        "short_address": "29 Hàng Khay",
        "postalcode": null,
        "label": "Quán Ngon nhà Hầm, 29 Hàng Khay, phường Tràng Tiền, quận Hoàn Kiếm, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["restaurant"],
        "website": null,
        "opening_hours": null,
        "phone": "+84988383446",
        "region": "thành phố Hà Nội",
        "county": "quận Hoàn Kiếm",
        "locality": "phường Tràng Tiền",
        "distance": 100,
        "id": "EUpaSgu3tDhM10lKIyy1CE6JRQInHHN4NIlSSSV460-0U3MdIlm5eALOgWQ8",
        "continent": "Asia",
        "source": "openmapvn"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.852703, 21.025505],
        "type": "Point"
      },
      "properties": {
        "name": "Poke Hanoi",
        "housenumber": null,
        "street": null,
        "short_address": "11B Hàng Khay",
        "postalcode": null,
        "label": "Poke Hanoi, 11B Hàng Khay, phường Tràng Tiền, quận Hoàn Kiếm, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["restaurant"],
        "website": null,
        "opening_hours": "0,11,0,0,21,0,1,11,0,1,21,0,2,11,0,2,21,0,3,11,0,3,21,0,4,11,0,4,21,0,5,11,0,5,21,0",
        "phone": "+84903483218",
        "region": "thành phố Hà Nội",
        "county": "quận Hoàn Kiếm",
        "locality": "phường Tràng Tiền",
        "distance": 116,
        "id": "cFI4HBSJc7VM1-tJI094FkaeWrIks5bQRSWtLNAIPALV_sxhBPiVsHX-iEUI",
        "continent": "Asia",
        "source": "openmapvn"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.85217, 21.025347],
        "type": "Point"
      },
      "properties": {
        "name": "Bún Đậu Cô Tuyến Mắm Tôm Hàng Khay",
        "housenumber": null,
        "street": null,
        "short_address": "ngõ 31 Hàng Khay",
        "postalcode": null,
        "label": "Bún Đậu Cô Tuyến Mắm Tôm Hàng Khay, ngõ 31 Hàng Khay, phường Tràng Tiền, quận Hoàn Kiếm, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["restaurant"],
        "website": null,
        "opening_hours": "0,9,0,0,21,0,1,9,0,1,21,0,2,9,0,2,21,0,3,9,0,3,21,0,4,9,0,4,21,0,5,9,0,5,21,0,6,9,0,6,21,0",
        "phone": "+84348579436",
        "region": "thành phố Hà Nội",
        "county": "quận Hoàn Kiếm",
        "locality": "phường Tràng Tiền",
        "distance": 136,
        "id": "Yjumn15cWxoxxVsqWaY3OkicRNxpAp2oQjJthJkddN1yboF8dQSxcNQMOolw",
        "continent": "Asia",
        "source": "openmapvn"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.851221, 21.027248],
        "type": "Point"
      },
      "properties": {
        "name": "Little Hanoi Restaurant",
        "housenumber": null,
        "street": null,
        "short_address": "32 Lê Thái Tổ",
        "postalcode": null,
        "label": "Little Hanoi Restaurant, 32 Lê Thái Tổ, phường Hàng Trống, quận Hoàn Kiếm, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["restaurant"],
        "website": null,
        "opening_hours": "0,0,1,1,2,2,3,3,4,4,5,5,6,6",
        "phone": null,
        "region": "thành phố Hà Nội",
        "county": "quận Hoàn Kiếm",
        "locality": "phường Hàng Trống",
        "distance": 153,
        "id": "mQkxBlU3XG1ZwlsEWhphAqaaRy02UmYXXGJw4oYswWDpdIVPCpaZuOVLDT1Q",
        "continent": "Asia",
        "source": "openmapvn"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.853036, 21.025256],
        "type": "Point"
      },
      "properties": {
        "name": "Trung Nguyên Legend Café",
        "housenumber": null,
        "street": null,
        "short_address": "02 Hàng Bài",
        "postalcode": null,
        "label": "Trung Nguyên Legend Café, 02 Hàng Bài, phường Tràng Tiền, quận Hoàn Kiếm, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["coffee_shop", "restaurant"],
        "website": "https://trungnguyenlegend.com/",
        "opening_hours": null,
        "phone": "+842432181358",
        "region": "thành phố Hà Nội",
        "county": "quận Hoàn Kiếm",
        "locality": "phường Tràng Tiền",
        "distance": 153,
        "id": "JEY4y4Jwq1UTJFWSAKtNUBM4P5VzZfYeVShvrjlWDQpSPJWdkRoNTP74Pc6g",
        "continent": "Asia",
        "source": "openmapvn"
      }
    }
  ],
  "bbox": [],
  "type": "FeatureCollection"
}

API references

Parameters

Parameter	Type	Required	Default	Example
categories	string	yes	none	restaurant
point.lat	floating point number	no	none	21.0265361
point.lon	floating point number	no	none	105.852484
size	integer	no	5	5
boundary.circle.radius	integer	no	5	5