Titik navigasi

Developer Wilayah Ekonomi Eropa (EEA)

Kolom navigation_points dalam respons Geocoding berisi daftar titik yang berguna untuk menavigasi ke tempat tersebut. 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 garis lintang dan bujur titik navigasi. Lokasi ini akan selalu sangat dekat dengan jaringan jalan dan merupakan titik awal atau akhir yang ideal untuk bernavigasi ke dan dari suatu tempat. Titik ini sengaja sedikit bergeser dari garis tengah jalan untuk menandai dengan jelas sisi jalan tempat lokasi berada.
  • restricted_travel_modes adalah daftar mode perjalanan yang tidak dapat diakses dari titik navigasi:
    • "DRIVE" adalah moda transportasi yang sesuai dengan rute mengemudi.
    • "WALK" adalah mode perjalanan yang sesuai dengan rute jalan kaki.
  • road_name berisi nama jalan yang menjadi titik navigasi yang tidak berada di jalan tersebut.

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

Pemberitahuan migrasi

Mulai 17 April, Anda kini harus memberikan parameter komputasi ekstra 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 sub-kolom berikut (lat, lng, latitude, longitude).

Selain itu, Anda harus bermigrasi ke kolom location.lat dan location.lng, bukan kolom location.latitude dan location.longitude. Pada 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 dapat memperoleh titik navigasi dalam jenis permintaan berikut:

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

Contoh permintaan

Kueri berikut menggunakan geocoding tempat untuk mendapatkan titik navigasi bagi sebuah 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 menghargai masukan yang dikirimkan ke geocoding-feedback-channel@google.com.