Directions

DirectionsService class

Class google.maps.DirectionsService

Layanan untuk menghitung rute di antara dua tempat atau lebih.

Akses dengan memanggil const {DirectionsService} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
DirectionsService
DirectionsService()
Parameter:  Tidak ada
Membuat instance DirectionsService baru yang mengirim kueri petunjuk arah ke server Google.
route
route(request[, callback])
Parameter: 
Nilai yang Ditampilkan:  Promise<DirectionsResult>
Mengirimkan permintaan penelusuran rute.

DirectionsRequest interface

google.maps.DirectionsRequest interface

Kueri rute yang akan dikirim ke DirectionsService.
destination
Jenis:  string|LatLng|Place|LatLngLiteral
Lokasi tujuan. Ini dapat ditentukan sebagai string yang akan di-geocoding, atau LatLng, atau Place. Wajib.
origin
Jenis:  string|LatLng|Place|LatLngLiteral
Lokasi asal. Ini dapat ditentukan sebagai string yang akan di-geocoding, atau LatLng, atau Place. Wajib.
travelMode
Jenis:  TravelMode
Jenis perutean yang diminta. Wajib.
avoidFerries optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Directions untuk menghindari kapal feri jika memungkinkan. Opsional.
avoidHighways optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Directions untuk menghindari jalan raya jika memungkinkan. Opsional.
avoidTolls optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Directions untuk menghindari jalan tol jika memungkinkan. Opsional.
drivingOptions optional
Jenis:  DrivingOptions optional
Setelan yang hanya berlaku untuk permintaan saat travelMode adalah DRIVING. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya.
language optional
Jenis:  string optional
ID bahasa untuk bahasa yang digunakan untuk menampilkan hasil, jika memungkinkan. Lihat daftar bahasa yang didukung.
optimizeWaypoints optional
Jenis:  boolean optional
Jika disetel ke true, DirectionsService akan mencoba mengurutkan ulang titik jalan perantara yang diberikan untuk meminimalkan biaya keseluruhan rute. Jika titik jalan dioptimalkan, periksa DirectionsRoute.waypoint_order dalam respons untuk menentukan urutan baru.
provideRouteAlternatives optional
Jenis:  boolean optional
Apakah alternatif rute harus disediakan atau tidak. Opsional.
region optional
Jenis:  string optional
Kode wilayah yang digunakan sebagai bias untuk permintaan geocoding. Kode wilayah menerima nilai dua karakter ccTLD ("domain level teratas"). Umumnya kode ccTLD identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk), sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland").
transitOptions optional
Jenis:  TransitOptions optional
Setelan yang hanya berlaku untuk permintaan saat travelMode adalah TRANSIT. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya.
unitSystem optional
Jenis:  UnitSystem optional
Default: Sistem satuan yang digunakan di negara asal.
Sistem satuan pilihan yang akan digunakan saat menampilkan jarak.
waypoints optional
Jenis:  Array<DirectionsWaypoint> optional
Array titik jalan perantara. Petunjuk arah dihitung dari asal ke tujuan melalui setiap titik jalan dalam array ini. Lihat panduan developer untuk mengetahui jumlah maksimum titik jalan yang diizinkan. Titik jalan tidak didukung untuk arah angkutan umum. Opsional.

DirectionsStatus constants

google.maps.DirectionsStatus konstanta

Status yang ditampilkan oleh DirectionsService setelah panggilan ke route() selesai. Tentukan ini berdasarkan nilai, atau menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.DirectionsStatus.OK.

Akses dengan memanggil const {DirectionsStatus} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
INVALID_REQUEST DirectionsRequest yang diberikan tidak valid.
MAX_WAYPOINTS_EXCEEDED Terlalu banyak DirectionsWaypoint yang diberikan dalam DirectionsRequest. Lihat panduan developer untuk mengetahui jumlah maksimum titik jalan yang diizinkan.
NOT_FOUND Setidaknya salah satu dari asal, tujuan, atau titik jalan tidak dapat di-geocode.
OK Respons berisi DirectionsResult yang valid.
OVER_QUERY_LIMIT Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat.
REQUEST_DENIED Halaman web tidak diizinkan untuk menggunakan layanan rute.
UNKNOWN_ERROR Permintaan rute tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi.
ZERO_RESULTS Tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.

DirectionsResult interface

google.maps.DirectionsResult interface

Respons rute yang diambil dari server rute. Anda dapat merendernya menggunakan DirectionsRenderer atau mengurai objek ini dan merendernya sendiri. Anda harus menampilkan peringatan dan hak cipta sebagaimana tercantum dalam Persyaratan Layanan Google Maps Platform. Perhatikan bahwa meskipun hasil ini "mirip JSON", hasil ini bukan JSON murni, karena secara tidak langsung menyertakan objek LatLng.
request
DirectionsRequest yang menghasilkan hasil ini.
routes
Array DirectionsRoute, yang masing-masing berisi informasi tentang segmen dan langkah-langkah yang menyusunnya. Hanya akan ada satu rute kecuali jika DirectionsRequest dibuat dengan provideRouteAlternatives yang ditetapkan ke true.
available_travel_modes optional
Jenis:  Array<TravelMode> optional
Berisi array mode perjalanan yang tersedia. Kolom ini ditampilkan saat permintaan menentukan mode perjalanan dan tidak mendapatkan hasil. Larik berisi mode perjalanan yang tersedia di negara-negara dari serangkaian titik jalan yang diberikan. Kolom ini tidak ditampilkan jika satu atau beberapa titik jalan adalah 'melalui titik jalan'.
geocoded_waypoints optional
Array DirectionsGeocodedWaypoint, yang masing-masing berisi informasi tentang geocoding asal, tujuan, dan titik jalan.

Kelas DirectionsRenderer

Class google.maps.DirectionsRenderer

Merender petunjuk arah yang diperoleh dari DirectionsService.

Class ini memperluas MVCObject.

Akses dengan memanggil const {DirectionsRenderer} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
DirectionsRenderer
DirectionsRenderer([opts])
Parameter: 
Membuat perender dengan opsi yang diberikan. Rute dapat dirender di peta (sebagai overlay visual) atau juga di panel <div> (sebagai petunjuk tekstual).
getDirections
getDirections()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  DirectionsResult
Menampilkan kumpulan petunjuk saat ini dari perender.
getMap
getMap()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Map
Menampilkan peta tempat DirectionsResult dirender.
getPanel
getPanel()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  HTMLElement|null
Menampilkan <div> panel tempat DirectionsResult dirender.
getRouteIndex
getRouteIndex()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  number
Menampilkan indeks rute (berbasis nol) saat ini yang digunakan oleh objek DirectionsRenderer ini.
setDirections
setDirections(directions)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Tetapkan perender untuk menggunakan hasil dari DirectionsService. Menetapkan serangkaian petunjuk arah yang valid dengan cara ini akan menampilkan petunjuk arah di peta dan panel yang ditentukan perender.
setMap
setMap(map)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Metode ini menentukan peta tempat rute akan dirender. Teruskan null untuk menghapus rute dari peta.
setOptions
setOptions(options)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Ubah setelan opsi DirectionsRenderer ini setelah inisialisasi.
setPanel
setPanel(panel)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Metode ini merender petunjuk arah di <div>. Teruskan null untuk menghapus konten dari panel.
setRouteIndex
setRouteIndex(routeIndex)
Parameter: 
  • routeIndex:  number
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan indeks (berbasis nol) rute dalam objek DirectionsResult yang akan dirender. Secara default, rute pertama dalam array akan dirender.
Diwariskan: addListener, bindTo,