Varsayılan olarak Routes API, varsayılan rotayı, yani yakıt veya enerji verimliliğini hesaba katmayan bir rotayı döndürür. Çevre dostu rotayı etkinleştirdiğinizde, yanıtta varsayılan rotayı görmeye devam edersiniz. Ayrıca, aracınızın motor türüne göre yakıt veya enerji verimliliği en yüksek rotayı gösteren çevre dostu bir rotaya da dönebilirsiniz.
Routes API'nin döndürdüğü çevre dostu rota, rotanın tamamında daha düşük yakıt tüketimi sağlamak üzere optimize edilmiştir. API, çevre dostu rotayı seçmek için aracınızın motor tipinin yanı sıra gerçek zamanlı trafik ve yol koşulları gibi faktörleri de kullanır. Rotanın yakıt veya enerji verimliliği ne kadar yüksek olursa aracınızın yakıt/enerji kullanımı ve CO2 emisyonu da o kadar düşük olur.
Örneğin, dizel bir aracın göreceli yakıt ekonomisi avantajı genellikle otoyolda sürüş açısından en büyük avantajdır. Hibrit ve elektrikli araçlar, yaygın bir şekilde rejeneratif frenlemeden yararlanabildikleri dur-kalk şehirde ve yokuşlu sürüş ortamlarında giderek daha fazla verimlilik sağlar.
API'nin tüm rota için tahmini yakıt tüketimini döndürmesini de isteyebilirsiniz. Yakıt tüketimi tahminlerini, aracınızın ayrıntılı yakıt kullanımı tahminleri olarak değil, farklı rotaları karşılaştırmanın bir yolu olarak kullanın.
Google Haritalar'ın yakıt verimliliğini tahmin etme şekli
Routes API, ABD Enerji Bakanlığı Ulusal Yenilenebilir Enerji Laboratuvarı'ndan alınan analizleri ve Avrupa Çevre Ajansı'nın verilerini kullanarak yakıt verimliliğini tahmin eder. Bu hesaplama, yakıt ve enerji kullanımınızı ve CO2 emisyonlarını etkileyen faktörleri içerir. Örneğin:
- Bölgenizdeki araçlar için ortalama yakıt veya enerji tüketimi
- Rotanızdaki tepelerin dikliği
- Dur-kalk yapılan trafik kalıpları
- Yol türleri (yerel yollar veya otoyollar gibi)
Routes API, varsayılan rotayla hemen hemen aynı varış saatine sahip olduğunda yakıt veya enerji verimliliği en yüksek rotayı döndürür. Yakıt veya enerji tasarrufunun çok az olduğu ya da sürüş süresini önemli ölçüde artırdığı durumlarda API, karşılaştırma yapmanıza yardımcı olmak için rotalar arasındaki göreceli yakıt veya enerji tasarruflarını gösterir.
Çevre dostu rota bulma teknolojisi (PDF) hakkında daha fazla bilgi edinin.
Ön koşullar
Çevre dostu rota bulma özelliğini kullanmak veya yakıt tüketimini tahmin etmek için:
Yönlendirme tercihi olarak
TRAFFIC_AWARE_OPTIMAL
belirtmelisiniz. Bu modda sunucu, en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama gerçekleştirir. Daha fazla bilgi için Kalite ve gecikmeyi yapılandırma bölümüne bakın.travelMode
öğesiniDRIVE
olarak ayarlamalısınız. Başka ulaşım şekilleriyle ilgili istekler hata döndürür.Kalkış noktası için desteklenen bir bölgede konum belirlemeniz gerekir. Aksi takdirde, API hata döndürür.
Rotada ara nokta bulunamaz.
Faturalandırma
Google Haritalar Platformu, genellikle Önizleme özelliğinin kullanımı için ücret almaz. Ancak çevre dostu rota bulma ve yakıt tüketimini tahmin etmek için rota tercihi olarak TRAFFIC_AWARE_OPTIMAL
değerini belirtmeniz gerektiğinden, SKU: Gelişmiş Rotalar'a göre ücretlendirilirsiniz.
Routes API'nin faturalandırması hakkında daha fazla bilgi edinin.
Çevre dostu rota isteğinde bulunun
Çevre dostu rota hesaplaması isteğinde bulunmak için istekte aşağıdaki özellikleri ayarlayın:
VehicleEmissionType bölümünde tanımlanan değerleri kullanarak araç için
emissionType
değerini belirtin:DIESEL
,GASOLINE
,ELECTRIC
veyaHYBRID
.GASOLINE
, varsayılan değerdir.requestedReferenceRoutes
öğesiniFUEL_EFFICIENT
olarak ayarlayın.Çevre dostu bir rotayla ilişkili yanıt özelliklerini döndürmeyi belirten bir yanıt alanı maskesi ayarlayın:
routes.routeLabels:
Her bir rotayıDEFAULT_ROUTE
,FUEL_EFFICIENT
veyaDEFAULT_ROUTE_ALTERNATE
olarak tanımlar.routes.routeToken:
Özel bir rota almak için Gezinme SDK'sına iletebileceğiniz rota jetonu.
Çevre dostu istek örneği
Aşağıdaki kodda çevre dostu rota isteği gösterilmektedir. Bu örnekte, yanıt alanı maskesi, routes.distanceMeters
ve routes.duration
özellikleriyle birlikte çevre dostu bir rotayla ilişkili yanıt özelliklerini döndürmek için kullanılır:
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: API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Çevre dostu yanıt örneği
Yukarıdaki computeRoutes
çağrısı, iki rota içeren bir JSON yanıtı oluşturur: varsayılan rota ve yakıt verimliliği yüksek rota. Yanıtta:
Varsayılan rota için
routeLabels
dizi özelliği,DEFAULT_ROUTE
değerini içerir.Çevre dostu rota için
routeLabels
dizi özelliği,FUEL_EFFICIENT
değerini içerir.Alternatif rotaları hesaplamak için istekte
computeAlternativeRoutes
öğesinitrue
olarak ayarlarsanızrouteLabels
dizisi özelliğiDEFAULT_ROUTE_ALTERNATE
değerini içerir.
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
Mevcut sürüş koşulları ve diğer faktörler nedeniyle varsayılan rota ve çevre dostu rota aynı olabilir. Bu durumda, routeLabels
hem DEFAULT_ROUTE
hem de FUEL_EFFICIENT
etiketini içerir:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
Rota için yakıt kullanımını tahmin etme
Tüm rota için tahmini yakıt kullanımını mikrolitre cinsinden döndürecek yöntemi isteyebilirsiniz. Yanıta rotanın tahmini yakıt kullanımını eklemek için:
Yakıt kullanımı hesaplamasını etkinleştirmek için
extraComputations
dizi alanınıFUEL_CONSUMPTION
olarak ayarlayın.VehicleEmissionType bölümünde tanımlanan değerleri kullanarak araç için
emissionType
değerini belirtin:DIESEL
,GASOLINE
,ELECTRIC
veyaHYBRID
.GASOLINE
, varsayılan değerdir.emissionType
değeriHYBRID
ise API, elektrik ve yakıt tüketimini mikrolitre yakıta dönüştürür.emissionType
değeriELECTRIC
ise API, elektrik tüketimini mikrolitre yakıta dönüştürür.Yakıt kullanımıyla ilişkili yanıt özelliklerini döndürmeyi belirten bir yanıt alanı maskesi ayarlayın:
routes.travelAdvisory.fuelConsumptionMicroliters
.
Aşağıdaki örnekte, çevre dostu rotayı da içeren bir istek kapsamında tahmini yakıt kullanımı istenmektedir:
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: API_KEY' \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Yanıt, hem varsayılan rota hem de çevre dostu rota için tahmini yakıt tüketimini içerir:
{ "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" ] } ] }
Desteklenen bölgeler
Google Haritalar Platformu ekibi, API hizmetlerimizin uluslararası kapsamını iyileştirmek için sürekli çalışmaktadır. Aşağıdaki listede, ülkeye göre çevre dostu rota bulmayla ilgili en son kapsam ayrıntıları gösterilmektedir:
- Arnavutluk (AL)
- Avusturya (AT)
- Belçika (BE)
- Bosna Hersek (BA)
- Bulgaristan (BG)
- Kanada (CA)
- Hırvatistan (HR)
- Güney Kıbrıs Rum Yönetimi (CY)
- Çekya (CZ)
- Danimarka (DK)
- Estonya (EE)
- Finlandiya (FI)
- Fransa (FR)
- Almanya (DE)
- Yunanistan (GR)
- Macaristan (HU)
- İzlanda (IS)
- İrlanda (IE)
- İtalya (IT)
- Kosova (XK)
- Letonya (LV)
- Lihtenştayn (LI)
- Litvanya (LT)
- Lüksemburg (LU)
- Malta (MT)
- Karadağ (ME)
- Hollanda (NL)
- Kuzey Makedonya (MK)
- Norveç (NO)
- Polonya (PL)
- Portekiz (PT)
- Romanya (RO)
- Sırbistan (RS)
- Slovakya (SK)
- Slovenya (SI)
- İspanya (ES)
- İsveç (SE)
- İsviçre (CH)
- Türkiye (TR)
- İngiltere (GB)
- Amerika Birleşik Devletleri (US)