Điểm điều hướng

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

Trường navigation_points trong phản hồi Geocoding chứa danh sách các điểm hữu ích để điều hướng đến địa điểm. Cụ thể, bạn nên sử dụng các điểm này làm điểm bắt đầu hoặc điểm kết thúc khi định tuyến trên mạng lưới đường bộ từ hoặc đến địa điểm. Mỗi điểm điều hướng chứa các giá trị sau:

  • location chứa giá trị vĩ độ, kinh độ của điểm điều hướng. Vị trí này sẽ luôn rất gần với mạng lưới đường bộ và là điểm dừng hoặc điểm bắt đầu lý tưởng để di chuyển đến và đi từ một địa điểm. Điểm này được cố ý đặt lệch một chút so với đường tim của đường để đánh dấu rõ ràng phía đường nơi địa điểm đó nằm.
  • restricted_travel_modes là danh sách các phương thức di chuyển mà bạn không thể sử dụng để đến điểm điều hướng:
    • "DRIVE" là chế độ di chuyển tương ứng với chỉ đường lái xe.
    • "WALK" là chế độ di chuyển tương ứng với chỉ đường đi bộ.
  • road_name chứa tên của con đường mà điểm điều hướng được đặt lệch.

Các điểm điều hướng được trả về cho hầu hết những địa điểm có vị trí chính xác, chẳng hạn như địa chỉ đường phố, toà nhà và cơ sở. Những địa điểm đại diện cho các khu vực rộng lớn, chẳng hạn như thành phố và khu vực, nơi vị trí chính xác có thể không rõ ràng, có thể không trả về điểm điều hướng nào.

Thông báo về việc di chuyển

Kể từ ngày 17 tháng 4, giờ đây, bạn phải cung cấp tham số NAVIGATION_POINTSextra computations trong yêu cầu để nhận các điểm điều hướng. Các ứng dụng có thể kiểm thử điều này bằng cách xác nhận rằng trường road_name trong một số điểm điều hướng được trả về và trường location trong mỗi điểm điều hướng có 4 trường con sau (lat, lng, latitude, longitude).

Ngoài ra, bạn phải di chuyển sang các trường location.lat và location.lng thay vì các trường location.latitude và location.longitude. Trong một bản phát hành trong tương lai, những yêu cầu không chứa tham số tính toán bổ sung NAVIGATION_POINTS sẽ không bao gồm bất kỳ điểm điều hướng nào trong phản hồi và các trường location.latitude và location.longitude sẽ không được trả về nữa.

Thông tin chi tiết về yêu cầu

Bạn có thể nhận được điểm điều hướng trong các loại yêu cầu sau:

Đối với bất kỳ yêu cầu nào trong số này, bạn hãy cung cấp tham số sau: extra_computations=NAVIGATION_POINTS.

Ví dụ về yêu cầu

Truy vấn sau đây sử dụng tính năng địa lý mã hoá địa điểm để lấy các điểm điều hướng cho một nhà hàng ở Mountain View, California, Hoa Kỳ:

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

Ví dụ về phản hồi

Phản hồi từ truy vấn ở trên cho thấy một mảng các điểm điều hướng:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

Phản hồi

Đây là tính năng thử nghiệm. Chúng tôi rất mong nhận được ý kiến phản hồi tại địa chỉ geocoding-feedback-channel@google.com.