Route Matrix

Class RouteMatrix

class google.maps.routes.RouteMatrix
library "routes"

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

const {RouteMatrix} = await google.maps.importLibrary("routes");
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
readonly
Baris matriks. Setiap baris berkaitan dengan tempat asal dan berisi array RouteMatrixItem, yang masing-masing mewakili rute ke tujuan.
Diwarisi: toJSON

Class RouteMatrixRow

class google.maps.routes.RouteMatrixRow
library "routes"

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
Informasi rute untuk setiap tujuan.
Diwarisi: toJSON

Class RouteMatrixItem

class google.maps.routes.RouteMatrixItem
library "routes"

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

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
Jenis: RouteMatrixItemCondition optional
Menunjukkan apakah rute ditemukan atau tidak.
distanceMeters
readonly
Jenis: number optional
Jarak perjalanan rute dalam meter.
durationMillis
readonly
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
readonly
Jenis: RouteMatrixItemError optional
Error yang terjadi selama penghitungan rute.
fallbackInfo
readonly
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
readonly
Representasi teks properti RouteMatrixItem.
staticDurationMillis
readonly
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
readonly
Jenis: RouteTravelAdvisory optional
Informasi tambahan tentang rute.

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
opsional
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
opsional
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
opsional
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.
internalUsageAttributionIds
opsional
Jenis: Iterable<string> optional
ID yang digunakan untuk mengatribusikan panggilan ke paket atau library OSS tertentu.
language
opsional
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
opsional
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
opsional
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
opsional
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
opsional
Jenis: TransitPreference optional
Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute TRANSIT.

Catatan: Hanya dapat ditentukan jika ComputeRouteMatrixRequest.travelMode ditetapkan ke TRANSIT.
travelMode
opsional
Jenis: TravelMode optional
Menentukan moda transportasi.
units
opsional
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

google.maps.routes.ComputeRouteMatrixExtraComputation
library "routes"

Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis ComputeRouteMatrixExtraComputationString.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS Informasi tol untuk elemen matriks. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.

Konstanta RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition
library "routes"

Kondisi rute yang ditampilkan. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis RouteMatrixItemConditionString.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS Rute ditemukan, dan informasi yang sesuai telah diisi untuk elemen tersebut. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.
ROUTE_NOT_FOUND Rute tidak dapat ditemukan. Lihat dokumentasi layanan web untuk mengetahui informasi selengkapnya.

Class RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
Diwarisi: toJSON

Class RouteMatrixItemLocalizedValues

class google.maps.routes.RouteMatrixItemLocalizedValues
library "routes"

Representasi teks RouteMatrixItem.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Jenis: string optional
Jarak perjalanan item matriks rute dalam bentuk teks.
distanceLanguage
readonly
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
readonly
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
readonly
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
readonly
Jenis: string optional
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.
staticDurationLanguage
readonly
Jenis: string optional
Kode bahasa BCP-47 teks durasi statis, seperti "en-US" atau "sr-Latn".
transitFare
readonly
Jenis: string optional
Tarif transportasi umum, yang ditampilkan dalam bentuk teks.
transitFareLanguage
readonly
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.
Diwarisi: toJSON

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
opsional
Jenis: RouteModifiers optional
Pengubah untuk setiap rute yang menggunakan ini sebagai titik awal.