Yêu cầu và phản hồi đối với phần mô tả địa chỉ

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Bộ mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng các địa danh và khu vực. Hãy xem bản minh hoạ bộ mô tả địa chỉ để khám phá tính năng này.

Các tham số bổ sung

Bạn có thể bật bộ mô tả địa chỉ bằng cách sử dụng tham số extra_computations. Hãy thêm extra_computations=ADDRESS_DESCRIPTORS vào yêu cầu mã hoá địa lý , yêu cầu mã hoá địa lý ngược hoặc yêu cầu mã hoá địa lý địa điểm để nhận bộ mô tả địa chỉ trong phản hồi.

Ví dụ về mã hoá địa lý

Truy vấn sau đây chứa địa chỉ của một địa điểm ở Delhi:

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Ví dụ về mã hoá địa lý địa điểm

Truy vấn sau đây chứa mã địa điểm của một địa điểm ở Delhi:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Ví dụ về mã hoá địa lý ngược

Truy vấn sau đây chứa giá trị vĩ độ/kinh độ cho một vị trí ở Delhi:

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Phản hồi

Sau đây là ví dụ về address_descriptor:

{
  "address_descriptor" : {
     "areas" : [
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Turkman Gate"
           },
           "place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
        },
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Chandni Chowk"
           },
           "place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
        },
        {
           "containment" : "NEAR",
           "display_name" : {
              "language_code" : "en",
              "text" : "Katar Ganj"
           },
           "place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
        }
     ],
     "landmarks" : [
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delite Cinema"
           },
           "straight_line_distance_meters" : 29.9306755065918,
           "place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
           "travel_distance_meters" : 418.7794799804688,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "establishment", "movie_theater", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "YES Bank"
           },
           "straight_line_distance_meters" : 66.83731079101562,
           "place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
           "travel_distance_meters" : 489.0340270996094,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "UCO Bank"
           },
           "straight_line_distance_meters" : 25.38849639892578,
           "place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
           "travel_distance_meters" : 403.2246398925781,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delhi By Cycle Meeting Point"
           },
           "straight_line_distance_meters" : 44.02867126464844,
           "place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
           "travel_distance_meters" : 97.41281890869141,
           "spatial_relationship" : "AROUND_THE_CORNER",
           "types" : [
              "establishment",
              "point_of_interest",
              "tourist_attraction",
              "travel_agency"
           ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Axis Bank Branch"
           },
           "straight_line_distance_meters" : 102.3495178222656,
           "place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
           "travel_distance_meters" : 330.8566284179688,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        }
     ]
  }
}

Có 2 mảng trong mỗi đối tượng address_descriptor: landmarks và areas. Mảng landmarks chứa tối đa 5 kết quả được xếp hạng theo thứ tự mức độ liên quan bằng cách tính đến khoảng cách đến toạ độ được yêu cầu, mức độ phổ biến của địa danh và khả năng hiển thị của địa danh đó. Mỗi kết quả địa danh chứa các giá trị sau:

  • place_id là mã địa điểm của kết quả địa danh. Xem phần tổng quan về mã địa điểm.
  • display_name là tên hiển thị của địa danh và chứa language_code và text.
  • straight_line_distance_meters là khoảng cách theo đường thẳng tính bằng mét giữa toạ độ đầu vào và kết quả địa danh.
  • travel_distance_meters là khoảng cách tính bằng mét khi di chuyển qua mạng lưới đường bộ (bỏ qua các hạn chế về đường bộ) giữa toạ độ đầu vào và kết quả địa danh.
  • spatial_relationship là mối quan hệ ước tính giữa toạ độ đầu vào và kết quả địa danh:
    • "NEAR" là mối quan hệ mặc định khi không có mối quan hệ nào sau đây được áp dụng.
    • "WITHIN" khi toạ độ đầu vào nằm trong phạm vi của cấu trúc được liên kết với địa danh.
    • "BESIDE" khi toạ độ đầu vào nằm ngay cạnh địa danh hoặc điểm truy cập của địa danh.
    • "ACROSS_THE_ROAD" khi toạ độ đầu vào nằm ngay đối diện với địa danh ở phía bên kia của tuyến đường.
    • "DOWN_THE_ROAD" khi toạ độ đầu vào nằm trên cùng tuyến đường với địa danh, nhưng không phải là "BESIDES" hoặc "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER" khi toạ độ đầu vào nằm trên một tuyến đường vuông góc với địa danh (chỉ giới hạn ở một lượt rẽ).
    • "BEHIND" khi toạ độ đầu vào nằm gần địa danh về mặt không gian, nhưng cách xa điểm truy cập của địa danh.
  • types là Loại địa điểm của địa danh.

Đối tượng areas chứa tối đa 3 phản hồi và chỉ giới hạn ở những địa điểm đại diện cho các khu vực nhỏ, chẳng hạn như khu dân cư, tiểu khu và các khu phức hợp lớn. Các khu vực chứa toạ độ được yêu cầu sẽ được liệt kê trước và sắp xếp theo thứ tự từ nhỏ nhất đến lớn nhất. Mỗi kết quả areas chứa các giá trị sau:

  • place_id là mã địa điểm của kết quả khu vực. Xem phần tổng quan về mã địa điểm.
  • display_name là tên hiển thị của khu vực và chứa language_code và text.
  • containment là mối quan hệ chứa ước tính giữa toạ độ đầu vào và kết quả khu vực:
    • "NEAR" là mối quan hệ mặc định khi không có mối quan hệ nào sau đây được áp dụng.
    • "WITHIN" khi toạ độ đầu vào nằm gần trung tâm của khu vực.
    • "OUTSKIRTS" khi toạ độ đầu vào nằm gần rìa của khu vực.

Phạm vi tổng hợp dữ liệu

Bộ mô tả địa chỉ có ở tất cả các khu vực. Hãy xem phạm vi tổng hợp dữ liệu theo khu vực để biết thông tin chi tiết.

Phản hồi

Tính năng này có ở tất cả các vùng và đang ở giai đoạn GA (giai đoạn phát hành rộng rãi) cho Ấn Độ và ở giai đoạn ra mắt thử nghiệm trước khi phát hành rộng rãi cho tất cả các vùng khác. Chúng tôi rất mong nhận được ý kiến phản hồi. Vui lòng gửi email cho chúng tôi theo địa chỉ address-descriptors-feedback@google.com.