Route Matrix (beta)

Kelas 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 yang Ditampilkan:  Promise<{matrix:RouteMatrix}>
Menerima daftar asal dan tujuan, lalu menampilkan matriks yang berisi informasi rute untuk setiap kombinasi 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 untuk semua kolom yang tersedia: fields: ['*']
  • Mask kolom durasi dan jarak tingkat Rute: fields: ['durationMillis', 'distanceMeters']

Penggunaan mask kolom respons karakter pengganti fields: ['*'] tidak disarankan karena:
  • Memilih hanya kolom yang Anda butuhkan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda butuhkan dalam tugas produksi memastikan performa latensi yang stabil. Kami mungkin akan menambahkan kolom respons lainnya 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 butuhkan akan menghasilkan ukuran respons yang lebih kecil, sehingga pemuatan melalui jaringan lebih cepat.
rows
Baris matriks. Setiap baris sesuai dengan asal dan berisi array RouteMatrixItem, yang masing-masing mewakili rute ke tujuan.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Object
Dikonversi menjadi objek.

Class RouteMatrixRow

Class google.maps.routes.RouteMatrixRow

Sesuai dengan asal 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 yang Ditampilkan:  Object
Dikonversi menjadi objek.

Kelas 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 akan sama dengan RouteMatrixItem.staticDurationMillis. Jika Anda menyetel 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 ini, server dapat kembali menggunakan mode penghitungan yang berbeda. Jika penggantian digunakan, kolom ini berisi informasi mendetail tentang respons penggantian. Jika tidak, kolom ini tidak disetel.
localizedValues
Representasi teks dari 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.

ComputeRouteMatrixRequest interface

google.maps.routes.ComputeRouteMatrixRequest interface

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

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

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

Catatan: Anda hanya dapat menentukan waktu di masa lalu jika ComputeRouteMatrixRequest.travelMode disetel ke TRANSIT. Perjalanan transportasi umum tersedia hingga 7 hari sebelumnya 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 dalam 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 Unicode Locale Identifier. 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 disimpulkan dari lokasi asal pertama.
region optional
Jenis:  string optional
Kode wilayah, yang ditentukan 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 asal pertama.
routingPreference optional
Jenis:  RoutingPreference optional
Menentukan cara menghitung matriks rute. Server mencoba menggunakan preferensi perutean yang dipilih untuk menghitung matriks rute. Jika preferensi perutean menghasilkan error atau latensi yang sangat panjang, 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 disetel 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, satuan tampilan akan disimpulkan dari lokasi asal pertama.

Konstanta ComputeRouteMatrixExtraComputation

google.maps.routes.ComputeRouteMatrixExtraComputation konstanta

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 untuk item matriks.

RouteMatrixItemCondition konstanta

google.maps.routes.RouteMatrixItemCondition konstanta

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.

Kelas 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 yang Ditampilkan:  Object
Dikonversi menjadi 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 untuk teks jarak, seperti "en-US" atau "sr-Latn".

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

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

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

Untuk mengetahui informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Object
Dikonversi menjadi objek.

RouteMatrixOrigin interface

google.maps.routes.RouteMatrixOrigin interface

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