Nearby APIs

Đề xuất các địa điểm tại một khu vực địa lý nhất định.

Mô tả

API Nearby cho phép ứng dụng của bạn đề xuất các địa điểm xung quanh một khu vực địa lý nhất định. API này sẽ trả về một danh sách các địa điểm gần khu vực được chỉ định, danh sách này bao gồm tọa độ của các địa điểm này, đặc tính, loại hình địa điểm. Bạn có thể tùy chỉnh các đề xuất này bằng cách thêm các tham số như categories,coordinates.

Base URL

Mã URL chung cho tất các yêu cầu API:https://mapapis.ndamaps.vn/v1

Endpoint

GET /nearby

Ví dụ

Yêu cầu:

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

Trả về:

{
  {
  "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"
}

Các nội dung tham khảo

Tham số

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	Trả về thông tin địa điểm mới sau sáp nhập địa giới hành chính
boundary.circle.radius	integer	no	5	5