Distance Matrix

Class DistanceMatrixService

Class google.maps.DistanceMatrixService

Layanan untuk menghitung jarak antara beberapa tempat asal dan tujuan.

Akses dengan memanggil const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Lihat Library di Maps JavaScript API.

DistanceMatrixService
DistanceMatrixService()
Parameter: Tidak ada
Membuat instance baru DistanceMatrixService yang mengirimkan kueri matriks jarak ke server Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter: 
Menerbitkan 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
Jenis:  Array<string|LatLng|LatLngLiteral|Place>
Array yang berisi string alamat tujuan, atau objek LatLng, atau Place, untuk menghitung jarak dan waktu. Wajib.
origins
Jenis:  Array<string|LatLng|LatLngLiteral|Place>
Array yang berisi string alamat asal, atau objek LatLng, atau Place, yang digunakan untuk menghitung jarak dan waktu. Wajib.
travelMode
Jenis:  TravelMode
Jenis pemilihan rute yang diminta. Wajib.
avoidFerries optional
Jenis:  boolean optional
Jika true, menginstruksikan layanan Distance Matrix untuk menghindari kapal 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 pada mode perjalanan lainnya.
language optional
Jenis:  string optional
ID bahasa untuk bahasa tempat hasil akan 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 yang berisi 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 travelMode adalah TRANSIT. Objek ini tidak akan berpengaruh pada mode perjalanan lainnya.
unitSystem optional
Jenis:  UnitSystem optional
Sistem satuan yang lebih disukai untuk digunakan saat menampilkan jarak. Opsional; defaultnya adalah metrik.

Antarmuka DistanceMatrixResponse

Antarmuka google.maps.DistanceMatrixResponse

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

destinationAddresses
Jenis:  Array<string>
Alamat tujuan yang 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

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

distance
Jenis:  Distance
Jarak untuk pasangan asal-tujuan ini. Properti ini mungkin tidak didefinisikan karena jarak mungkin tidak diketahui.
duration
Jenis:  Duration
Durasi untuk pemasangan asal-tujuan ini. Properti ini mungkin tidak didefinisikan karena durasinya mungkin tidak diketahui.
duration_in_traffic
Jenis:  Duration
Durasi untuk penyambungan asal-tujuan ini, dengan memperhitungkan kondisi traffic yang ditunjukkan oleh properti trafficModel. Properti ini mungkin undefined karena durasinya mungkin tidak diketahui. Hanya tersedia untuk pelanggan Paket Premium jika drivingOptions ditentukan saat membuat permintaan.
fare
Jenis:  TransitFare
Total tarif untuk pasangan asal-tujuan ini. Hanya berlaku untuk permintaan transportasi umum.
status
Status pasangan asal-tujuan tertentu ini.

Konstanta DistanceMatrixStatus

google.maps.DistanceMatrixStatus konstanta

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

Akses dengan memanggil const {DistanceMatrixStatus} = await google.maps.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 Hasil dari tempat 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

google.maps.DistanceMatrixElementStatus konstanta

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

Akses dengan memanggil const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). Lihat Library di Maps JavaScript API.

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