Children APIs

API này trả về cho bạn địa chỉ và vị trí của các điểm con của một điểm.

mẹo

Hãy sử dụng Enterprise Dashboard hoặc hướng dẫn API Key để tạo API Key và trải nghiệm miễn phí!

Đối tượng sử dụng:

Sử dụng cho những địa điểm nào có dữ liệu trả về từ api GET /autocomplete tồn tại key "has_child": true.

Ví dụ :

/autocomplete?text=Bến Xe Mỹ Đình&size=1&boundary.circle.lat=21.300&boundary.circle.lon=105.900&boundary.circle.radius=100&apikey=YOUR_API_KEY

Dữ liệu trả về:

{
  "bbox": [105.76603, 21.018379, 105.790874, 21.038711000000003],
  "errors": null,
  "features": [
    {
      "geometry": {
        "coordinates": [105.778269, 21.02843],
        "type": "Point"
      },
      "properties": {
        "category": ["bus_stop"],
        "continent": "Asia",
        "country": "Việt Nam",
        "country_code": "VN",
        "county": "quận Nam Từ Liêm",
        "distance": 32729,
        "has_child": true,
        "housenumber": null,
        "id": "sCCOPkcjbElM1xGeOCRaRky9L5bScJS1zSRyONLIpaE9PeES0txFeGDhFD0g",
        "label": "Bến Xe Mỹ Đình, Mỹ Đình, phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
        "locality": "phường Mỹ Đình 2",
        "name": "Bến Xe Mỹ Đình",
        "opening_hours": null,
        "opening_hours_v2": null,
        "phone": null,
        "postalcode": null,
        "region": "thành phố Hà Nội",
        "short_address": "Mỹ Đình",
        "sid": "c5ef313f2234770f",
        "source": "openmapvn",
        "street": null,
        "website": null
      },
      "type": "Feature"
    }
  ],
  "type": "FeatureCollection"
}

Base URL

Mã URL chung cho tất các yêu cầu API:

https://mapapis.openmap.vn/v1

Endpoint

GET /place/children

Ví dụ

Yêu cầu:

/place/children?parent_id=sCCOPkcjbElM1xGeOCRaRky9L5bScJS1zSRyONLIpaE9PeES0txFeGDhFD0g&apikey=YOUR_API_KEY

Tham số để yêu cầu

Tham số	Miêu tả	Ví dụ
parent_id	Chuỗi ID của điểm cha (Bắt buộc)	sCCOPkcjbElM1xGeOCRaRky9L5bScJS1zSRyONLIpaE9PeES0txFeGDhFD0g

Dữ liệu trả về:

{
  "predictions": [
    {
      "description": "Cổng Nguyễn Hoàng, phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
      "distance_meters": null,
      "has_child": false,
      "matched_substrings": null,
      "place_id": "ea9YYk5TvRHIhlgtXXj-TGA",
      "structured_formatting": {
        "main_text": "Cổng Nguyễn Hoàng",
        "main_text_matched_substrings": null,
        "secondary_text": "phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
        "secondary_text_matched_substrings": null
      },
      "terms": [
        {
          "offset": 0,
          "value": "Cổng Nguyễn Hoàng"
        },
        {
          "offset": 23,
          "value": "phường Mỹ Đình 2"
        },
        {
          "offset": 48,
          "value": "quận Nam Từ Liêm"
        },
        {
          "offset": 71,
          "value": "thành phố Hà Nội"
        }
      ],
      "types": [""]
    },
    {
      "description": "Cổng Nguyễn Hoàng, phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
      "distance_meters": null,
      "has_child": false,
      "matched_substrings": null,
      "place_id": "ea9YYk5TvRHIhlgtXXj-TGA",
      "structured_formatting": {
        "main_text": "Cổng Nguyễn Hoàng",
        "main_text_matched_substrings": null,
        "secondary_text": "phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
        "secondary_text_matched_substrings": null
      },
      "terms": [
        {
          "offset": 0,
          "value": "Cổng Nguyễn Hoàng"
        },
        {
          "offset": 23,
          "value": "phường Mỹ Đình 2"
        },
        {
          "offset": 48,
          "value": "quận Nam Từ Liêm"
        },
        {
          "offset": 71,
          "value": "thành phố Hà Nội"
        }
      ],
      "types": [""]
    },
    {
      "description": "Điểm đón/trả khách - Phạm Hùng, phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
      "distance_meters": null,
      "has_child": false,
      "matched_substrings": null,
      "place_id": "JUJ4aLU1RAoljO1REjKZJTA",
      "structured_formatting": {
        "main_text": "Điểm đón/trả khách - Phạm Hùng",
        "main_text_matched_substrings": null,
        "secondary_text": "phường Mỹ Đình 2, quận Nam Từ Liêm, thành phố Hà Nội",
        "secondary_text_matched_substrings": null
      },
      "terms": [
        {
          "offset": 0,
          "value": "Điểm đón/trả khách - Phạm Hùng"
        },
        {
          "offset": 42,
          "value": "phường Mỹ Đình 2"
        },
        {
          "offset": 67,
          "value": "quận Nam Từ Liêm"
        },
        {
          "offset": 90,
          "value": "thành phố Hà Nội"
        }
      ],
      "types": [""]
    }
  ],
  "status": "OK"
}