Route Matrix

Class RouteMatrix

Class google.maps.routes.RouteMatrix

Matriks rute yang dihitung untuk sekumpulan pasangan asal/tujuan oleh RouteMatrix.computeRouteMatrix

Akses dengan memanggil const {RouteMatrix} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
Parameter: 
Nilai Hasil:  Promise<{matrix:RouteMatrix}>
Mengambil daftar tempat asal dan tujuan, lalu menampilkan matriks yang berisi informasi rute untuk setiap kombinasi tempat asal dan tujuan.

Catatan: Metode ini mengharuskan Anda menentukan mask kolom respons dalam permintaan dengan menetapkan properti ComputeRouteMatrixRequest.fields. Nilainya adalah daftar jalur kolom.

Contoh:
  • Mask kolom dari semua kolom yang tersedia: fields: ['*']
  • Mask kolom untuk durasi dan jarak tingkat Rute: fields: ['durationMillis', 'distanceMeters']

Penggunaan mask kolom respons karakter pengganti fields: ['*'] tidak dianjurkan karena:
  • Memilih hanya kolom yang Anda perlukan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasil kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda perlukan dalam tugas produksi akan memastikan performa latensi yang stabil. Kami mungkin akan menambahkan lebih banyak kolom respons pada masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Memilih hanya kolom yang Anda perlukan akan menghasilkan ukuran respons yang lebih kecil, sehingga pemuatan melalui jaringan menjadi lebih cepat.
rows
Baris matriks. Setiap baris berkaitan dengan tempat asal dan berisi array RouteMatrixItem, yang masing-masing mewakili rute ke tujuan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai Hasil:  Object
Mengonversi ke objek.

Class RouteMatrixRow

Class google.maps.routes.RouteMatrixRow

Sesuai dengan origin yang diteruskan ke RouteMatrix.computeRouteMatrix. Berisi daftar RouteMatrixItem, dengan setiap item mewakili rute ke tujuan.

Akses dengan memanggil const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
items
Informasi rute untuk setiap tujuan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai Hasil:  Object
Mengonversi ke objek.

Class RouteMatrixItem

Class google.maps.routes.RouteMatrixItem

Berisi informasi rute yang dihitung untuk pasangan asal/tujuan yang diteruskan ke RouteMatrix.computeRouteMatrix.

Akses dengan memanggil const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
condition
Jenis:  RouteMatrixItemCondition optional
Menunjukkan apakah rute ditemukan atau tidak.
distanceMeters
Jenis:  number optional
Jarak perjalanan rute dalam meter.
durationMillis
Jenis:  number optional
Durasi waktu yang diperlukan untuk menavigasi rute dalam milidetik. Jika Anda menetapkan ComputeRouteMatrixRequest.routingPreference ke TRAFFIC_UNAWARE, nilai ini sama dengan RouteMatrixItem.staticDurationMillis. Jika Anda menetapkan ComputeRouteMatrixRequest.routingPreference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini akan dihitung dengan mempertimbangkan kondisi lalu lintas.

Catatan: Jika durasi melebihi 2^53 milidetik, nilai ini adalah Number.POSITIVE_INFINITY.
error
Jenis:  RouteMatrixItemError optional
Error yang terjadi selama penghitungan rute.
fallbackInfo
Jenis:  FallbackInfo optional
Dalam beberapa kasus, jika server tidak dapat menghitung rute dengan preferensi yang diberikan untuk pasangan asal/tujuan tertentu, server mungkin akan beralih menggunakan mode komputasi yang berbeda. Jika penggantian digunakan, kolom ini berisi informasi mendetail tentang respons penggantian. Jika tidak, kolom ini tidak akan ditetapkan.
localizedValues
Representasi teks properti RouteMatrixItem.
staticDurationMillis
Jenis:  number optional
Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

Catatan: Jika durasi melebihi 2^53 milidetik, nilai ini adalah Number.POSITIVE_INFINITY.
travelAdvisory
Jenis:  RouteTravelAdvisory optional
Informasi tambahan tentang rute.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai Hasil:  Object
Mengonversi ke objek.

Antarmuka ComputeRouteMatrixRequest

Antarmuka google.maps.routes.ComputeRouteMatrixRequest

Permintaan untuk matriks rute.
destinations
Array tujuan, yang menentukan kolom matriks respons. Nilai yang diteruskan sebagai string dapat berupa alamat, plus code, atau nama resource Tempat. Nilai ketinggian tidak dipertimbangkan.
fields
Jenis:  Iterable<string>
Kumpulan kolom yang akan diambil. Tentukan ["*"] untuk semua kolom.
origins
Array tempat asal, yang menentukan baris matriks respons. Nilai yang diteruskan sebagai string dapat berupa alamat, plus code, atau nama resource Tempat. Nilai ketinggian tidak dipertimbangkan.

Beberapa batasan ukuran berlaku untuk kardinalitas tempat asal dan tujuan:
  • Total jumlah tempat asal dan tujuan yang ditentukan sebagai string atau Place tidak boleh lebih dari 50.
  • Hasil dari jumlah tempat asal dan jumlah tujuan tidak boleh lebih dari 625.
  • Hasil dari jumlah tempat asal dan tujuan tidak boleh lebih dari 100 jika ComputeRouteMatrixRequest.routingPreference ditetapkan ke TRAFFIC_AWARE_OPTIMAL.
  • Hasil dari jumlah tempat asal dan tujuan tidak boleh lebih dari 100 jika ComputeRouteMatrixRequest.travelMode ditetapkan ke TRANSIT.
arrivalTime optional
Jenis:  Date optional
Waktu tiba.

Catatan: Hanya dapat ditetapkan jika ComputeRouteMatrixRequest.travelMode ditetapkan ke TRANSIT. Anda dapat menentukan ComputeRouteMatrixRequest.departureTime atau ComputeRouteMatrixRequest.arrivalTime, tetapi tidak keduanya. Perjalanan transportasi umum tersedia hingga 7 hari ke belakang atau 100 hari ke depan.
departureTime optional
Jenis:  Date optional
Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu Anda membuat permintaan.

Catatan: Anda hanya dapat menentukan waktu di masa lalu jika ComputeRouteMatrixRequest.travelMode ditetapkan ke TRANSIT. Perjalanan transportasi umum tersedia hingga 7 hari ke belakang atau 100 hari ke depan.
extraComputations optional
Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan.

Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons. Kolom tambahan ini juga harus ditentukan di ComputeRouteMatrixRequest.fields agar ditampilkan dalam respons.
language optional
Jenis:  string optional
Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk mengetahui informasi selengkapnya, lihat ID Lokalitas Unicode. Lihat Dukungan Bahasa untuk mengetahui daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa akan disimpulkan dari setelan pelokalan Google Maps JavaScript API Anda. Jika tidak, bahasa akan disimpulkan dari lokasi asal pertama.
region optional
Jenis:  string optional
Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Untuk mengetahui informasi selengkapnya, lihat Domain level teratas kode negara. Jika Anda tidak memberikan nilai ini, wilayah akan disimpulkan dari setelan pelokalan Google Maps JavaScript API Anda. Jika tidak, region akan disimpulkan dari lokasi origin pertama.
routingPreference optional
Jenis:  RoutingPreference optional
Menentukan cara menghitung matriks rute. Server akan mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung matriks rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang sangat lama, error akan ditampilkan. Anda hanya dapat menentukan opsi ini jika ComputeRouteMatrixRequest.travelMode adalah DRIVING atau TWO_WHEELER, jika tidak, permintaan akan gagal.
trafficModel optional
Jenis:  TrafficModel optional
Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di RouteMatrixItem.durationMillis yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. ComputeRouteMatrixRequest.trafficModel hanya tersedia untuk permintaan yang telah menetapkan ComputeRouteMatrixRequest.routingPreference ke TRAFFIC_AWARE_OPTIMAL dan ComputeRouteMatrixRequest.travelMode ke DRIVING. Nilai defaultnya adalah BEST_GUESS.
transitPreference optional
Jenis:  TransitPreference optional
Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute TRANSIT.

Catatan: Hanya dapat ditentukan jika ComputeRouteMatrixRequest.travelMode ditetapkan ke TRANSIT.
travelMode optional
Jenis:  TravelMode optional
Menentukan moda transportasi.
units optional
Jenis:  UnitSystem optional
Menentukan satuan ukuran untuk kolom tampilan. Jika Anda tidak memberikan nilai ini, unit tampilan akan disimpulkan dari lokasi origin pertama.

Konstanta ComputeRouteMatrixExtraComputation

Konstanta google.maps.routes.ComputeRouteMatrixExtraComputation

Komputasi tambahan yang akan dilakukan untuk permintaan RouteMatrix.computeRouteMatrix.

Akses dengan memanggil const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
TOLLS Informasi tarif tol untuk item matriks.

Konstanta RouteMatrixItemCondition

Konstanta google.maps.routes.RouteMatrixItemCondition

Kondisi rute untuk pasangan asal/tujuan tertentu.

Akses dengan memanggil const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
ROUTE_EXISTS Rute ditemukan.
ROUTE_NOT_FOUND Rute tidak dapat ditemukan.

Class RouteMatrixItemError

Class google.maps.routes.RouteMatrixItemError

Error yang terjadi selama RouteMatrix.computeRouteMatrix untuk pasangan asal/tujuan tertentu.

Class ini memperluas Error.

Akses dengan memanggil const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai Hasil:  Object
Mengonversi ke objek.

Class RouteMatrixItemLocalizedValues

Class google.maps.routes.RouteMatrixItemLocalizedValues

Representasi teks RouteMatrixItem.

Akses dengan memanggil const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Lihat Library di Maps JavaScript API.
distance
Jenis:  string optional
Jarak perjalanan item matriks rute dalam bentuk teks.
distanceLanguage
Jenis:  string optional
Kode bahasa BCP-47 teks jarak, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Jenis:  string optional
Durasi, yang direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas.

Catatan: Jika Anda tidak meminta informasi lalu lintas, nilai ini sama dengan nilai RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Jenis:  string optional
Kode bahasa BCP-47 teks durasi, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Jenis:  string optional
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.
staticDurationLanguage
Jenis:  string optional
Kode bahasa BCP-47 teks durasi statis, seperti "en-US" atau "sr-Latn".
transitFare
Jenis:  string optional
Tarif transportasi umum, yang ditampilkan dalam bentuk teks.
transitFareLanguage
Jenis:  string optional
Kode bahasa BCP-47 teks tarif transportasi umum, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai Hasil:  Object
Mengonversi ke objek.

Antarmuka RouteMatrixOrigin

Antarmuka google.maps.routes.RouteMatrixOrigin

Satu origin untuk ComputeRouteMatrixRequest.
waypoint
Lokasi origin. Nilai yang diteruskan sebagai string dapat berupa alamat atau plus code. Nilai ketinggian tidak dipertimbangkan.
routeModifiers optional
Jenis:  RouteModifiers optional
Pengubah untuk setiap rute yang menggunakan ini sebagai titik awal.