Matriks rute adalah array dua dimensi yang berisi informasi rute, dengan baris yang sesuai dengan asal dan kolom yang sesuai dengan tujuan. Dengan daftar tempat asal dan tujuan, class Route Matrix menghitung jarak dan durasi rute yang dimulai dari setiap tempat asal dan berakhir di setiap tujuan. Gunakan class Route Matrix untuk menghitung jarak dan durasi rute untuk beberapa tempat asal dan tujuan.
Lihat contoh kode sumber yang lengkap
Contoh ini menunjukkan cara menggunakan class Route Matrix untuk menghitung jarak dan durasi perjalanan antara beberapa tempat asal dan tujuan.
TypeScript
// Initialize and add the map. let map: google.maps.Map; const markers: google.maps.marker.AdvancedMarkerElement[] = []; const center = { lat: 51.55, lng: -1.8 }; async function init(): Promise<void> { // Request the needed libraries. const [ { Map }, { Place }, { AdvancedMarkerElement, PinElement }, { RouteMatrix }, { LatLngBounds, UnitSystem }, ] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('places'), google.maps.importLibrary('marker'), google.maps.importLibrary('routes'), google.maps.importLibrary('core'), ]); const bounds = new LatLngBounds(); map = new Map(document.getElementById('map')!, { zoom: 8, center, mapId: 'DEMO_MAP_ID', }); // Build the request using Place instances. const origin1 = new Place({ id: 'ChIJ83WZp86p2EcRbMrkYqGncBQ', // Greenwich, London, UK }); const origin2 = new Place({ id: 'ChIJCSkVvleJc0gR8HHaTGpajKc', // Southampton, UK }); const destinationA = new Place({ id: 'ChIJYdizgWaDcUgRH9eaSy6y5I4', // Bristol, UK }); const destinationB = new Place({ id: 'ChIJ9VPsNNQCbkgRDmeGZdsGNBQ', // Cardiff, UK }); await Promise.all([ origin1.fetchFields({ fields: ['location', 'displayName'] }), origin2.fetchFields({ fields: ['location', 'displayName'] }), destinationA.fetchFields({ fields: ['location', 'displayName'] }), destinationB.fetchFields({ fields: ['location', 'displayName'] }), ]); const destinations = [destinationA, destinationB]; const origins = [origin1, origin2]; const request: google.maps.routes.ComputeRouteMatrixRequest = { origins, destinations, travelMode: 'DRIVING', units: UnitSystem.METRIC, fields: ['distanceMeters', 'durationMillis', 'condition'], }; // Show the request. document.getElementById('request')!.innerText = JSON.stringify( request, null, 2 ); // Get the RouteMatrix response. const response = await RouteMatrix.computeRouteMatrix(request); // Show the response. document.getElementById('response')!.innerText = JSON.stringify( response, null, 2 ); // Add markers for the origins. for (const origin of origins) { if (origin.location) { const pin = new PinElement({ glyphText: 'O', glyphColor: 'white', background: '#137333', borderColor: 'white', }); const marker = new AdvancedMarkerElement({ map, position: origin.location, title: `Origin: ${origin.displayName}`, }); marker.append(pin); markers.push(marker); bounds.extend(origin.location); } } // Add markers for the destinations. for (const destination of destinations) { if (destination.location) { const pin = new PinElement({ glyphText: 'D', glyphColor: 'white', background: '#C5221F', borderColor: 'white', }); const marker = new AdvancedMarkerElement({ map, position: destination.location, content: pin, title: `Destination: ${destination.displayName ?? 'Unknown'}`, }); markers.push(marker); bounds.extend(destination.location); } } // Fit the map to the bounds of all markers. map.fitBounds(bounds); } void init();
JavaScript
// Initialize and add the map. let map; const markers = []; const center = { lat: 51.55, lng: -1.8 }; async function init() { // Request the needed libraries. const [ { Map }, { Place }, { AdvancedMarkerElement, PinElement }, { RouteMatrix }, { LatLngBounds, UnitSystem }, ] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('places'), google.maps.importLibrary('marker'), google.maps.importLibrary('routes'), google.maps.importLibrary('core'), ]); const bounds = new LatLngBounds(); map = new Map(document.getElementById('map'), { zoom: 8, center, mapId: 'DEMO_MAP_ID', }); // Build the request using Place instances. const origin1 = new Place({ id: 'ChIJ83WZp86p2EcRbMrkYqGncBQ', // Greenwich, London, UK }); const origin2 = new Place({ id: 'ChIJCSkVvleJc0gR8HHaTGpajKc', // Southampton, UK }); const destinationA = new Place({ id: 'ChIJYdizgWaDcUgRH9eaSy6y5I4', // Bristol, UK }); const destinationB = new Place({ id: 'ChIJ9VPsNNQCbkgRDmeGZdsGNBQ', // Cardiff, UK }); await Promise.all([ origin1.fetchFields({ fields: ['location', 'displayName'] }), origin2.fetchFields({ fields: ['location', 'displayName'] }), destinationA.fetchFields({ fields: ['location', 'displayName'] }), destinationB.fetchFields({ fields: ['location', 'displayName'] }), ]); const destinations = [destinationA, destinationB]; const origins = [origin1, origin2]; const request = { origins, destinations, travelMode: 'DRIVING', units: UnitSystem.METRIC, fields: ['distanceMeters', 'durationMillis', 'condition'], }; // Show the request. document.getElementById('request').innerText = JSON.stringify( request, null, 2 ); // Get the RouteMatrix response. const response = await RouteMatrix.computeRouteMatrix(request); // Show the response. document.getElementById('response').innerText = JSON.stringify( response, null, 2 ); // Add markers for the origins. for (const origin of origins) { if (origin.location) { const pin = new PinElement({ glyphText: 'O', glyphColor: 'white', background: '#137333', borderColor: 'white', }); const marker = new AdvancedMarkerElement({ map, position: origin.location, title: `Origin: ${origin.displayName}`, }); marker.append(pin); markers.push(marker); bounds.extend(origin.location); } } // Add markers for the destinations. for (const destination of destinations) { if (destination.location) { const pin = new PinElement({ glyphText: 'D', glyphColor: 'white', background: '#C5221F', borderColor: 'white', }); const marker = new AdvancedMarkerElement({ map, position: destination.location, content: pin, title: `Destination: ${destination.displayName ?? 'Unknown'}`, }); markers.push(marker); bounds.extend(destination.location); } } // Fit the map to the bounds of all markers. map.fitBounds(bounds); } void init();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ /* Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } #container { height: 100%; display: flex; } #sidebar { flex-basis: 15rem; flex-grow: 1; padding: 1rem; max-width: 30rem; height: 100%; box-sizing: border-box; overflow: auto; } #map { flex-basis: 0; flex-grow: 4; height: 100%; } #sidebar { flex-direction: column; }
HTML
<html>
<head>
<title>Route matrix</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY"
});
</script>
</head>
<body>
<div id="container">
<div id="map"></div>
<div id="sidebar">
<h3 style="flex-grow: 0">Request</h3>
<pre style="flex-grow: 1" id="request"></pre>
<h3 style="flex-grow: 0">Response</h3>
<pre style="flex-grow: 1" id="response"></pre>
</div>
</div>
</body>
</html>Mencoba Contoh
Batas permintaan
Metode computeRouteMatrix menerapkan batas permintaan berikut untuk titik jalan yang menggunakan instance alamat atau Tempat, dan untuk item. Item adalah rute antara setiap tempat asal dan tujuan dalam matriks rute, sehingga jumlah item adalah jumlah tempat asal dikalikan dengan jumlah tujuan. Misalnya, jika Anda memiliki 10 tempat asal dan 10
tujuan, Anda memiliki 100 item:
- Jumlah item tidak boleh melebihi 625 untuk rute yang bukan rute
TRANSIT. - Jika Anda menentukan rute
TRANSIT, jumlah item tidak boleh melebihi 100. - Jika Anda menentukan
TRAFFIC_AWARE_OPTIMAL, jumlah item tidak boleh melebihi 100. - Jika Anda menentukan tempat asal atau tujuan menggunakan alamat atau instance Place, Anda dapat menentukan total hingga 50 tempat asal atau tujuan dengan cara ini.
Untuk detail tambahan, lihat Mendapatkan rute transportasi umum.
Contoh permintaan matriks rute
Contoh berikut menunjukkan ComputeRouteMatrixRequest. Contoh ini
melakukan hal berikut:
- Menunjukkan penentuan array yang berisi dua titik jalan asal dan dua titik jalan tujuan. Metode ini menghitung rute dari setiap tempat asal ke setiap tujuan sehingga responsnya berisi empat rute.
Dalam array, elemen pertama berada di indeks 0, elemen kedua berada di indeks 1, dan seterusnya. - Menentukan kolom yang akan ditampilkan. Dalam contoh ini, permintaan dikonfigurasi untuk menampilkan
durationMillis,distanceMeters, danconditionuntuk setiap rute.
TypeScript
const destinations = [destinationA, destinationB]; const origins = [origin1, origin2]; const request: google.maps.routes.ComputeRouteMatrixRequest = { origins, destinations, travelMode: 'DRIVING', units: UnitSystem.METRIC, fields: ['distanceMeters', 'durationMillis', 'condition'], };
JavaScript
const destinations = [destinationA, destinationB]; const origins = [origin1, origin2]; const request = { origins, destinations, travelMode: 'DRIVING', units: UnitSystem.METRIC, fields: ['distanceMeters', 'durationMillis', 'condition'], };
Responsnya akan berisi empat kemungkinan rute untuk kombinasi semua titik jalan asal dan tujuan, seperti yang ditunjukkan dalam contoh berikut:
"matrix": { "rows": [ { "items": [ { "condition": "ROUTE_EXISTS", "distanceMeters": 202587, "durationMillis": 10040000 }, { "condition": "ROUTE_EXISTS", "distanceMeters": 252734, "durationMillis": 12240000 } ] }, { "items": [ { "condition": "ROUTE_EXISTS", "distanceMeters": 166135, "durationMillis": 6596000 }, { "condition": "ROUTE_EXISTS", "distanceMeters": 216282, "durationMillis": 8797000 } ] } ] }
Identifikasi setiap rute dalam hasil menggunakan indeks asal dan tujuan untuk menemukan
RouteMatrixItem yang sesuai dalam array 2D. Misalnya,
RouteMatrixItem yang menjelaskan rute yang dihitung dari tempat asal di indeks 1 dan
tujuan 0 dalam permintaan akan berada di elemen ke-2 array RouteMatrix.rows
dan elemen ke-1 array RouteMatrixRow.items.
Cuplikan kode berikut menunjukkan cara mengidentifikasi RouteMatrixItem untuk menemukan
rute untuk tempat asal dan tujuan tertentu:
// Find the route for origin 'x' and destination 'y'. const {matrix} = await RouteMatrix.computeRouteMatrix(request); const myRouteMatrixItem = matrix.rows[x].items[y];
Memilih kolom yang akan ditampilkan
Saat meminta matriks rute, Anda harus menggunakan mask kolom untuk menentukan informasi yang harus ditampilkan oleh respons.
Penggunaan mask kolom juga memastikan Anda tidak meminta data yang tidak diperlukan, yang pada akhirnya membantu latensi respons dan menghindari pengembalian informasi yang tidak diperlukan sistem Anda.
Tentukan daftar kolom yang Anda perlukan dengan menetapkan properti ComputeRoutesMatrixRequest.fields, seperti yang ditunjukkan dalam cuplikan berikut:
fields: ['durationMillis', 'distanceMeters', 'condition'],
Menentukan mask kolom yang akan digunakan
Berikut cara menentukan kolom yang ingin Anda gunakan, dan membuat mask kolom untuk kolom tersebut:
- Minta semua kolom menggunakan mask kolom
['*']. - Lihat hierarki kolom di class
RouteMatrixItemuntuk kolom yang Anda inginkan. Buat field mask Anda menggunakan hierarki kolom yang ditampilkan di langkah sebelumnya, menggunakan format ini:
topLevelField[.secondLevelField][.thirdLevelField][...]
Misalnya, untuk RouteMatrixItem ini:
"travelAdvisory": { "fuelConsumptionMicroliters": 0, "tollInfo": { "estimatedPrices": [ { "currencyCode": "USD", "units": 4, "nanos": 400000000 } ] } },
Jika Anda hanya ingin menampilkan kolom tollInfo untuk RouteMatrixItem,
mask kolom Anda adalah sebagai berikut:
fields: ['travelAdvisory.tollInfo']
Jika Anda ingin meminta perkiraan konsumsi bahan bakar, mask kolom Anda adalah sebagai berikut:
fields: ['travelAdvisory.fuelConsumptionMicroliters']
Jika Anda ingin meminta keduanya, mask kolom Anda adalah sebagai berikut:
fields: ['travelAdvisory.fuelConsumptionMicroliters', 'travelAdvisory.tollInfo']
Dan jika Anda ingin meminta kumpulan lengkap imbauan perjalanan, mask kolom Anda adalah sebagai berikut:
fields: ['travelAdvisory']
Meminta matriks rute transportasi umum
Dapatkan matriks rute transportasi umum yang menggunakan opsi transportasi umum yang tersedia di wilayah tersebut. Opsi transportasi umum dapat mencakup bus, subway, dan kereta api, antara lain. Untuk meminta matriks rute transportasi umum:
- Setel
travelModemenjadiTRANSIT - Minta kolom
travelAdvisory.
Pelajari rute transportasi umum lebih lanjut.