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

Trường navigation_points trong phản hồi Địa chỉ được mã hoá địa lý 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 địa điểm này làm điểm xuất phát hoặc điểm kết thúc khi định tuyến trên mạng lưới đường 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 nằm rất gần mạng lưới đường và là điểm dừng hoặc điểm xuất phát lý tưởng để di chuyển đến và đi từ một địa điểm. Điểm này được cố ý dịch chuyển một chút so với đường tâm của đường để đánh dấu rõ ràng bên đườ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à không thể truy cập vào điểm điều hướng:
    • "DRIVE" là chế độ di chuyển tương ứng với đường đi.
    • "WALK" là chế độ di chuyển tương ứng với đường đi bộ.
  • road_name chứa tên của con đường mà điểm điều hướng được bù trừ.

Hệ thống sẽ trả về các điểm điều hướng cho hầu hết các đị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ề bất kỳ điểm điều hướng nào.

Thông báo di chuyển

Kể từ ngày 17 tháng 4, bạn phải cung cấp thông số tính toán bổ sung NAVIGATION_POINTS trong yêu cầu để nhận điểm điều hướng. Ứ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ó bốn 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 bản phát hành trong tương lai, các 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òn được trả về.

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

Bạn có thể lấy đ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 cung cấp tham số này: extra_computations=NAVIGATION_POINTS.

Yêu cầu mẫu

Truy vấn sau đây sử dụng tính năng định dạng địa lý đị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 của bạn tại địa chỉ [email protected].