Class DistanceMatrixService
google.maps.DistanceMatrixService
class
library "routes"
const {DistanceMatrixService} = await google.maps.importLibrary("routes");
Konstruktor | |
|---|---|
DistanceMatrixService |
DistanceMatrixService()Parameter: Tidak ada
Membuat instance baru DistanceMatrixService yang mengirimkan kueri matriks jarak ke server Google. |
Metode | |
|---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback])Parameter:
Nilai Hasil:
Promise<DistanceMatrixResponse>Mengeluarkan 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.
Properti | |
|---|---|
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:
TravelModeJenis pemilihan rute yang diminta. Wajib. |
avoidFerries
opsional |
Jenis:
boolean optionalJika true, menginstruksikan layanan Distance Matrix untuk menghindari kapal feri jika memungkinkan. Opsional. |
avoidHighways
opsional |
Jenis:
boolean optionalJika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan raya jika memungkinkan. Opsional. |
avoidTolls
opsional |
Jenis:
boolean optionalJika true, menginstruksikan layanan Distance Matrix untuk menghindari jalan tol jika memungkinkan. Opsional. |
drivingOptions
opsional |
Jenis:
DrivingOptions optionalSetelan yang hanya berlaku untuk permintaan dengan travelMode adalah DRIVING. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya. |
language
opsional |
Jenis:
string optionalID bahasa untuk bahasa yang akan digunakan untuk menampilkan hasil, jika memungkinkan. Lihat daftar bahasa yang didukung. |
region
opsional |
Jenis:
string optionalKode 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
opsional |
Jenis:
TransitOptions optionalSetelan yang hanya berlaku untuk permintaan dengan travelMode adalah TRANSIT. Objek ini tidak akan berpengaruh untuk mode perjalanan lainnya. |
unitSystem
opsional |
Jenis:
UnitSystem optionalSistem satuan yang lebih disukai untuk digunakan saat menampilkan jarak. Opsional; default ke metrik. |
Antarmuka DistanceMatrixResponse
Antarmuka
google.maps.DistanceMatrixResponse
Respons terhadap permintaan DistanceMatrixService, yang terdiri dari alamat asal dan tujuan yang telah diformat, serta urutan DistanceMatrixResponseRow, satu untuk setiap alamat asal yang sesuai.
Properti | |
|---|---|
destinationAddresses |
Jenis:
Array<string>Alamat tujuan yang diformat. |
originAddresses |
Jenis:
Array<string>Alamat asal yang diformat. |
rows |
Jenis:
Array<DistanceMatrixResponseRow>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.
Properti | |
|---|---|
elements |
Jenis:
Array<DistanceMatrixResponseElement>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.
Properti | |
|---|---|
distance |
Jenis:
DistanceJarak untuk pasangan asal-tujuan ini. Properti ini mungkin tidak didefinisikan karena jaraknya mungkin tidak diketahui. |
duration |
Jenis:
DurationDurasi untuk pasangan tempat asal-tujuan ini. Properti ini mungkin tidak didefinisikan karena durasinya mungkin tidak diketahui. |
duration_in_traffic |
Jenis:
DurationDurasi untuk pasangan tempat asal-tujuan ini, dengan mempertimbangkan kondisi lalu lintas 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:
TransitFareTotal tarif untuk pasangan asal-tujuan ini. Hanya berlaku untuk permintaan transportasi umum. |
status |
Jenis:
DistanceMatrixElementStatusStatus pasangan asal-tujuan tertentu ini. |
DistanceMatrixStatus
google.maps.DistanceMatrixStatus
konstanta
library
"routes"
Status tingkat teratas tentang permintaan secara umum yang ditampilkan oleh DistanceMatrixService setelah permintaan matriks jarak selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.DistanceMatrixStatus.OK.
Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis DistanceMatrixStatusString.
const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
Konstanta | |
|---|---|
INVALID_REQUEST |
Permintaan yang diberikan tidak valid. |
MAX_DIMENSIONS_EXCEEDED |
Permintaan berisi lebih dari 25 tempat 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. |
DistanceMatrixElementStatus
google.maps.DistanceMatrixElementStatus
konstanta
library
"routes"
Status tingkat elemen tentang pasangan asal-tujuan tertentu yang ditampilkan oleh DistanceMatrixService setelah permintaan matriks jarak selesai. Nilai ini ditentukan sebagai string, misalnya, 'OK'.
Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis DistanceMatrixElementStatusString.
const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
Konstanta | |
|---|---|
NOT_FOUND |
Tempat asal dan/atau tujuan dari pasangan ini tidak mendukung geocoding. |
OK |
Respons berisi hasil yang valid. |
ZERO_RESULTS |
Tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan. |