Secara default, Routes API menampilkan rute default, yang berarti rute tanpa mempertimbangkan bahan bakar atau efisiensi energi. Saat mengaktifkan rute ramah lingkungan, Anda tetap mendapatkan rute default dalam respons. Selain itu, Anda juga akan mendapatkan rute ramah lingkungan yang menampilkan rute yang paling hemat bahan bakar atau energi berdasarkan jenis mesin kendaraan Anda.
Rute ramah lingkungan yang ditampilkan oleh Routes API dioptimalkan untuk mengurangi konsumsi bahan bakar di seluruh rute. API ini menggunakan jenis mesin kendaraan Anda beserta faktor lain seperti kondisi lalu lintas dan jalan real-time untuk memilih rute yang ramah lingkungan. Makin hemat bahan bakar atau energi untuk rute tersebut, makin rendah penggunaan bahan bakar/energi mobil dan emisi CO2 Anda.
Misalnya, kendaraan berbahan bakar solar yang relatif hemat biasanya paling efisien saat dikendarai di jalan raya. Kendaraan hibrida dan listrik cenderung lebih hemat saat dikendarai dalam kemacetan dan di lingkungan berbukit karena kendaraan tersebut dapat secara signifikan menggunakan dan mendapatkan manfaat dari pengereman regeneratif.
Anda juga dapat meminta API untuk menampilkan perkiraan konsumsi bahan bakar untuk seluruh rute. Gunakan estimasi konsumsi bahan bakar sebagai cara untuk membandingkan rute yang berbeda, bukan sebagai estimasi penggunaan bahan bakar yang eksplisit untuk kendaraan Anda yang sebenarnya.
Cara Google Maps memperkirakan penghematan bahan bakar
Routes API memperkirakan penghematan bahan bakar menggunakan insight dari National Renewable Energy Laboratory Departemen Energi Amerika Serikat dan data dari European Environment Agency. Penghitungan ini mencakup faktor-faktor yang memengaruhi penggunaan bahan bakar dan energi, serta emisi CO2, seperti:
- Konsumsi bahan bakar atau energi rata-rata untuk kendaraan di wilayah Anda
- Kecuraman bukit di rute Anda
- Pola lalu lintas berhenti dan berangkat
- Jenis jalan (misalnya jalan lokal atau jalan raya)
Routes API menampilkan rute yang paling hemat bahan bakar atau energi jika waktu kedatangannya kurang lebih sama dengan rute default. Jika penghematan bahan bakar atau energi terlalu kecil atau meningkatkan waktu berkendara secara signifikan, API akan menunjukkan penghematan bahan bakar atau energi relatif di antara rute untuk membantu Anda membandingkan.
Baca selengkapnya tentang teknologi pemilihan rute ramah lingkungan (PDF).
Prasyarat
Untuk menggunakan pemilihan rute ramah lingkungan atau memperkirakan konsumsi bahan bakar:
Anda harus menentukan
TRAFFIC_AWARE_OPTIMAL
sebagai preferensi pemilihan rute. Dalam mode ini, server melakukan penelusuran jaringan jalan yang lebih menyeluruh untuk menemukan rute yang optimal. Untuk informasi selengkapnya, lihat Mengonfigurasi kualitas vs latensi.Anda harus menetapkan
travelMode
keDRIVE
. Permintaan untuk mode perjalanan lainnya akan menampilkan error.Anda harus menetapkan lokasi untuk titik jalan asal di wilayah yang didukung. Jika tidak, API akan menampilkan error.
Rute tidak boleh berisi titik jalan perantara.
Penagihan
Biasanya, Google Maps Platform tidak mengenakan biaya untuk penggunaan fitur Pratinjau. Namun, karena pemilihan rute ramah lingkungan dan estimasi konsumsi bahan bakar
memerlukan Anda untuk menentukan TRAFFIC_AWARE_OPTIMAL
sebagai preferensi pemilihan rute, Anda
akan ditagih berdasarkan SKU: Routes Advanced.
Pelajari penagihan lebih lanjut untuk Routes API.
Meminta rute ramah lingkungan
Untuk membuat permintaan guna menghitung rute yang ramah lingkungan, tetapkan properti berikut dalam permintaan:
Tentukan
emissionType
untuk kendaraan menggunakan nilai yang ditentukan dalam VehicleEmissionType:DIESEL
,GASOLINE
,ELECTRIC
, atauHYBRID
. Nilai defaultnya adalahGASOLINE
.Tetapkan
requestedReferenceRoutes
keFUEL_EFFICIENT
.Tetapkan mask kolom respons yang menentukan untuk menampilkan properti respons yang terkait dengan rute ramah lingkungan:
routes.routeLabels:
Mengidentifikasi setiap rute sebagaiDEFAULT_ROUTE
,FUEL_EFFICIENT
, atauDEFAULT_ROUTE_ALTERNATE
.routes.routeToken:
Token rute yang dapat Anda teruskan ke Navigation SDK untuk mengambil rute kustom.
Contoh permintaan ramah lingkungan
Kode berikut menunjukkan permintaan untuk rute yang ramah lingkungan. Dalam contoh ini,
Anda menggunakan mask kolom respons untuk menampilkan properti respons yang terkait dengan
rute ramah lingkungan beserta properti routes.distanceMeters
dan
routes.duration
:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "routeModifiers": { "vehicleInfo": { "emissionType": "GASOLINE" } }, "travelMode":"DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "requestedReferenceRoutes": ["FUEL_EFFICIENT"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Contoh respons ramah lingkungan
Panggilan computeRoutes
di atas menghasilkan respons JSON yang berisi
dua rute: rute default dan rute hemat bahan bakar. Dalam respons:
Untuk rute default, properti array
routeLabels
berisiDEFAULT_ROUTE
.Untuk rute ramah lingkungan, properti array
routeLabels
berisiFUEL_EFFICIENT
.Jika Anda menetapkan
computeAlternativeRoutes
dalam permintaan ketrue
untuk menghitung rute alternatif, properti arrayrouteLabels
akan berisiDEFAULT_ROUTE_ALTERNATE
.
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
Karena kondisi mengemudi saat ini dan faktor lainnya, rute default dan
rute ramah lingkungan dapat sama. Dalam hal ini, routeLabels
berisi
label: DEFAULT_ROUTE
dan FUEL_EFFICIENT
:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
Memperkirakan penggunaan bahan bakar untuk rute
Anda dapat meminta metode untuk menampilkan perkiraan penggunaan bahan bakar untuk seluruh rute, dalam mikroliter. Untuk menambahkan estimasi penggunaan bahan bakar untuk rute ke respons:
Tetapkan kolom array
extraComputations
keFUEL_CONSUMPTION
untuk mengaktifkan penghitungan penggunaan bahan bakar.Tentukan
emissionType
untuk kendaraan menggunakan nilai yang ditentukan dalam VehicleEmissionType:DIESEL
,GASOLINE
,ELECTRIC
, atauHYBRID
. Nilai defaultnya adalahGASOLINE
.Jika
emissionType
adalahHYBRID
, API akan mengonversi konsumsi listrik dan bahan bakar menjadi mikroliter bahan bakar.Jika
emissionType
adalahELECTRIC
, API akan mengonversi konsumsi listrik menjadi mikroliter bahan bakar.Tetapkan mask kolom respons yang menentukan untuk menampilkan properti respons yang terkait dengan penggunaan bahan bakar:
routes.travelAdvisory.fuelConsumptionMicroliters
.
Contoh berikut meminta estimasi penggunaan bahan bakar sebagai bagian dari permintaan yang juga menyertakan rute ramah lingkungan:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "routeModifiers": { "vehicleInfo": { "emissionType": "GASOLINE" } }, "travelMode":"DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "extraComputations": ["FUEL_CONSUMPTION"], "requestedReferenceRoutes": ["FUEL_EFFICIENT"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Respons berisi estimasi konsumsi bahan bakar untuk rute default dan rute ramah lingkungan:
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "travelAdvisory": { "fuelConsumptionMicroliters": "11019554" }, "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "travelAdvisory": { "fuelConsumptionMicroliters": "9572436" }, "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
Region yang didukung
Tim Google Maps Platform terus berupaya meningkatkan cakupan internasional untuk layanan API kami. Daftar berikut menampilkan detail cakupan terbaru, berdasarkan setiap negara, untuk pemilihan rute yang ramah lingkungan:
- Albania (AL)
- Austria (AT)
- Belgia (BE)
- Bosnia dan Herzegovina (BA)
- Bulgaria (BG)
- Kanada (CA)
- Kroasia (HR)
- Siprus (CY)
- Republik Ceko (CZ)
- Denmark (DK)
- Estonia (EE)
- Finlandia (FI)
- Prancis (FR)
- Jerman (DE)
- Yunani (GR)
- Hungaria (HU)
- Islandia (IS)
- Irlandia (IE)
- Italia (TI)
- Kosovo (XK)
- Latvia (LV)
- Liechtenstein (LI)
- Lituania (LT)
- Luksemburg (LU)
- Malta (MT)
- Montenegro (ME)
- Belanda (NL)
- Makedonia Utara (MK)
- Norwegia (NO)
- Polandia (PL)
- Portugal (PT)
- Rumania (RO)
- Serbia (RS)
- Slovakia (SK)
- Slovenia (SI)
- Spanyol (ES)
- Swedia (SE)
- Swiss (CH)
- Turki (TR)
- Inggris Raya (GB)
- Amerika Serikat (AS)