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.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {DistanceMatrixService} = await google.map.importLibrary("routes"). Lihat Library di Maps JavaScript API.

DistanceMatrixService
DistanceMatrixService()
Parameter: Tidak ada
Membuat instance DistanceMatrixService baru yang mengirimkan 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 LatLng, atau objek Place, yang akan digunakan untuk menghitung jarak dan waktu. Wajib diisi.
origins
Array yang berisi string alamat asal, atau objek LatLng, atau Place, yang akan 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, menginstruksikan layanan Distance Matrix untuk menghindari feri jika memungkinkan. Opsional.
avoidHighways optional
Jenis: boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan raya jika memungkinkan. Opsional.
avoidTolls optional
Jenis: boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan tol jika memungkinkan. Opsional.
drivingOptions optional
Jenis: DrivingOptions optional
Setelan yang hanya berlaku untuk permintaan yang travelMode-nya adalah DRIVING. Objek ini tidak akan berpengaruh untuk moda perjalanan lainnya.
language 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 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 "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 untuk moda perjalanan lainnya.
unitSystem optional
Jenis: UnitSystem optional
Sistem satuan yang dipilih untuk digunakan saat menampilkan jarak. Opsional; ditetapkan secara default ke metrik.

Antarmuka DistanceMatrixResponse

Antarmuka google.maps.DistanceMatrixResponse

Respons terhadap permintaan DistanceMatrixService, yang terdiri dari alamat asal dan tujuan yang diformat, dan 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 diformat.
rows
Baris matriks, yang sesuai dengan alamat asal.

Antarmuka DistanceMatrixResponseRow

Antarmuka google.maps.DistanceMatrixResponseRow

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

elements
Elemen baris, yang sesuai dengan alamat tujuan.

Antarmuka DistanceMatrixResponseElement

Antarmuka google.maps.DistanceMatrixResponseElement

Elemen tunggal 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 penyambungan tujuan asal ini. Properti ini mungkin tidak didefinisikan karena durasinya mungkin tidak diketahui.
duration_in_traffic
Jenis: Duration
Durasi untuk penyambungan tujuan asal ini, dengan mempertimbangkan kondisi traffic yang ditunjukkan oleh properti trafficModel. Properti ini mungkin berupa 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 pasangan asal-tujuan tertentu ini.

Konstanta DistanceMatrixStatus

Konstanta google.maps.DistanceMatrixStatus

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

Saat menggunakan v=beta, dapat diakses dengan memanggil const {DistanceMatrixStatus} = await google.map.importLibrary("routes"). Lihat Library di Maps JavaScript API.

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 melampaui batas per kueri.
OK Respons berisi hasil yang valid.
OVER_QUERY_LIMIT Terlalu banyak elemen yang diminta dalam jangka waktu yang diizinkan. Permintaan mungkin 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 server error. Permintaan mungkin berhasil jika Anda mencoba lagi.

Konstanta DistanceMatrixElementStatus

Konstanta google.maps.DistanceMatrixElementStatus

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

Saat menggunakan v=beta, dapat diakses dengan memanggil const {DistanceMatrixElementStatus} = await google.map.importLibrary("routes"). Lihat Library di Maps JavaScript API.

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