Titik navigasi

Kolom navigation_points dalam respons Geocoding berisi daftar titik yang berguna untuk menavigasi ke tempat. Secara khusus, titik tersebut harus digunakan sebagai titik awal atau akhir saat merutekan di jaringan jalan dari atau ke tempat tersebut. Setiap titik navigasi berisi nilai berikut:

  • location berisi nilai lintang, bujur dari titik navigasi. Lokasi ini akan selalu sangat dekat dengan jaringan jalan dan merupakan titik perhentian atau awal yang ideal untuk menavigasi ke dan dari suatu tempat. Titik sengaja sedikit dioffset dari garis tengah jalan untuk menandai sisi jalan tempat tempat tersebut berada dengan jelas.
  • restricted_travel_modes adalah daftar mode perjalanan yang tidak dapat diakses dari titik navigasi:
    • "DRIVE" adalah mode perjalanan yang sesuai dengan rute mobil.
    • "WALK" adalah mode perjalanan yang sesuai dengan rute jalan kaki.
  • road_name berisi nama jalan tempat titik navigasi dioffset.

Titik navigasi ditampilkan untuk sebagian besar tempat dengan lokasi yang presisi, seperti alamat jalan, bangunan, dan tempat usaha. Tempat yang mewakili area besar, seperti kota dan wilayah, dengan lokasi akurat yang dapat ambigu, mungkin tidak menampilkan titik navigasi apa pun.

Pemberitahuan migrasi

Mulai 17 April, Anda kini harus memberikan parameter komputasi tambahan NAVIGATION_POINTS dalam permintaan untuk menerima titik navigasi. Klien dapat mengujinya dengan mengonfirmasi bahwa kolom road_name dalam beberapa titik navigasi ditampilkan dan kolom location dalam setiap titik navigasi memiliki empat subkolom berikut (lat, lng, latitude, longitude).

Selain itu, Anda harus bermigrasi ke kolom location.lat dan location.lng, bukan kolom location.latitude dan location.longitude. Dalam rilis mendatang, permintaan yang tidak berisi parameter komputasi tambahan NAVIGATION_POINTS tidak akan menyertakan titik navigasi apa pun dalam respons dan kolom location.latitude dan location.longitude tidak akan ditampilkan lagi.

Detail permintaan

Anda bisa mendapatkan titik navigasi dalam jenis permintaan berikut:

Untuk setiap permintaan ini, Anda harus memberikan parameter ini: extra_computations=NAVIGATION_POINTS.

Contoh permintaan

Kueri berikut menggunakan geocoding tempat untuk mendapatkan titik navigasi untuk restoran di Mountain View, California, Amerika Serikat:

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

Contoh respons

Respons dari kueri di atas menampilkan array titik navigasi:

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

Masukan

Ini adalah fitur eksperimental. Kami akan sangat berterima kasih jika Anda memberikan masukan di geocoding-feedback-channel@google.com.