Distance Matrix

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

DistanceMatrixService

Class google.maps.DistanceMatrixService

Layanan untuk menghitung jarak antara beberapa tempat asal dan tujuan.

DistanceMatrixService
DistanceMatrixService()
Parameter: Tidak ada
Membuat instance baru DistanceMatrixService yang mengirim kueri matriks jarak ke server Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter:
Memberikan permintaan matriks jarak.

Antarmuka DistanceMatrixRequest

Antarmuka google.maps.DistanceMatrixRequest

Kueri matriks jarak yang dikirim oleh DistanceMatrixService yang berisi array lokasi asal dan tujuan, serta berbagai opsi untuk menghitung metrik.

destinations
Array yang berisi string alamat tujuan, atau objek LatLng, atau Place, yang akan digunakan untuk menghitung jarak dan waktu. Wajib diisi.
origins
Array yang berisi string alamat asal, atau objek LatLng, atau Place, yang digunakan untuk menghitung jarak dan waktu. Wajib diisi.
travelMode
Jenis: TravelMode
Jenis pemilihan rute yang diminta. Wajib diisi.
avoidFerries optional
Jenis: boolean optional
Jika true, instruksikan layanan Distance Matrix untuk menghindari feri jika memungkinkan. Opsional.
avoidHighways optional
Jenis: boolean optional
Jika true, instruksikan layanan Distance Matrix untuk menghindari jalan raya jika memungkinkan. Opsional.
avoidTolls optional
Jenis: boolean optional
Jika true, instruksikan layanan Distance Matrix untuk menghindari jalan tol jika memungkinkan. Opsional.
drivingOptions optional
Jenis: DrivingOptions optional
Setelan yang hanya berlaku untuk permintaan dengan travelMode sebagai DRIVING. Objek ini tidak akan berpengaruh pada mode perjalanan lainnya.
Betalanguage optional
Jenis: string optional
ID bahasa untuk bahasa tempat hasil harus ditampilkan, jika memungkinkan. Lihat daftar bahasa yang didukung.
region optional
Jenis: string optional
Kode wilayah digunakan sebagai bias untuk permintaan geocoding. Kode wilayah menerima nilai dua karakter ccTLD ("top-level domain"). 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 "Inggris Raya dan Irlandia Utara").
transitOptions optional
Jenis: TransitOptions optional
Setelan yang hanya berlaku untuk permintaan yang traffic-nya travelMode. Objek ini tidak akan berpengaruh pada mode perjalanan lainnya.
unitSystem optional
Jenis: UnitSystem optional
Sistem satuan pilihan untuk digunakan saat menampilkan jarak. Opsional; default untuk metrik.

Antarmuka DistanceMatrixResponse

Antarmuka google.maps.DistanceMatrixResponse

Respons terhadap permintaan DistanceMatrixService, yang terdiri dari alamat asal dan tujuan berformat, serta urutan DistanceMatrixResponseRow, satu untuk setiap alamat asal yang sesuai.

destinationAddresses
Jenis: Array<string>
Alamat tujuan yang telah diformat.
originAddresses
Jenis: Array<string>
Alamat asal yang telah diformat.
rows
Baris matriks, yang sesuai dengan alamat asal.

Antarmuka DistanceMatrixResponseRow

Antarmuka google.maps.DistanceMatrixResponseRow

Baris respons untuk permintaan DistanceMatrixService, yang terdiri dari urutan DistanceMatrixResponseElement, satu untuk setiap alamat tujuan yang sesuai.

elements
Elemen baris, sesuai dengan alamat tujuan.

Antarmuka DistanceMatrixResponseElement

Antarmuka google.maps.DistanceMatrixResponseElement

Satu elemen respons terhadap permintaan DistanceMatrixService, yang berisi durasi dan jarak dari satu tempat asal ke satu tujuan.

distance
Jenis: Distance
Jarak untuk pasangan tujuan asal ini. Properti ini mungkin tidak didefinisikan karena jaraknya mungkin tidak diketahui.
duration
Jenis: Duration
Durasi untuk pasangan tujuan asal ini. Properti ini mungkin tidak ditentukan karena durasinya mungkin tidak diketahui.
duration_in_traffic
Jenis: Duration
Durasi untuk pasangan tujuan asal ini, dengan mempertimbangkan kondisi lalu lintas yang ditunjukkan oleh properti trafficModel. Properti ini mungkin undefined karena durasinya mungkin tidak diketahui. Hanya tersedia untuk pelanggan Premium Plan saat drivingOptions ditentukan saat membuat permintaan.
fare
Total tarif untuk pasangan tujuan asal ini. Hanya berlaku untuk permintaan transportasi umum.
status
Status penyambungan awal-tujuan khusus ini.

Konstanta DistanceMatrixStatus

google.maps.DistanceMatrixStatus konstanta

Status tingkat atas tentang permintaan secara umum yang ditampilkan oleh DistanceMatrixService setelah permintaan matriks jarak selesai. Tentukan variabel tersebut berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.DistanceMatrixStatus.OK.

INVALID_REQUEST Permintaan yang diberikan tidak valid.
MAX_DIMENSIONS_EXCEEDED Permintaan berisi lebih dari 25 asal atau lebih dari 25 tujuan.
MAX_ELEMENTS_EXCEEDED Produk asal dan tujuan melebihi batas per kueri.
OK Respons berisi hasil yang valid.
OVER_QUERY_LIMIT Terlalu banyak elemen yang diminta dalam jangka waktu yang diizinkan. Permintaan akan berhasil jika Anda mencoba lagi setelah beberapa saat.
REQUEST_DENIED Layanan menolak penggunaan layanan Distance Matrix oleh halaman web Anda.
UNKNOWN_ERROR Permintaan Distance Matrix tidak dapat diproses karena kesalahan server. Permintaan mungkin berhasil jika Anda mencoba lagi.

Konstanta DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus konstanta

Status tingkat elemen tentang pasangan tujuan asal tertentu yang ditampilkan oleh DistanceMatrixService setelah menyelesaikan permintaan matriks jarak. Nilai ini ditentukan sebagai string, misalnya, 'OK'.

NOT_FOUND Asal dan/atau tujuan pasangan ini tidak dapat di-geocoding.
OK Respons berisi hasil yang valid.
ZERO_RESULTS Tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.