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

Base URL

https://mapapis.ndamaps.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": "ndamapvn"
      }
    },
    {
      "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": "ndamapvn"
      }
    },
    {
      "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": "ndamapvn"
      }
    },
    {
      "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": "ndamapvn"
      }
    },
    {
      "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": "ndamapvn"
      }
    }
  ],
  "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
admin_v2	boolean	no	false	Return information about new locations after administrative boundary consolidation
boundary.circle.radius	integer	no	5	5