Routes API, varsayılan olarak varsayılan rotayı döndürür. Bu, yakıt veya enerji verimliliğini hesaba katmadan kullanılan bir rotadır. Çevre dostu rota bulma'yı 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 sahip olursunuz.
Routes API tarafından döndürülen çevre dostu rota, rotanın tamamında daha düşük yakıt tüketimi için optimize edilmiştir. API, çevre dostu rotayı seçmek için aracınızın motor türünün yanı sıra gerçek zamanlı trafik ve yol koşulları gibi diğer faktörleri kullanır. Rotanın yakıt veya enerji verimliliği ne kadar yüksek olursa arabanızın yakıt/enerji kullanımı ve CO2 emisyonu da o kadar düşük olur.
Örneğin, dizel bir aracın göreli yakıt ekonomisi avantajı genellikle otoyol sürüşü için en yüksektir. Hibrit ve elektrikli araçlar, rejeneratif frenlemenin yaygın olarak kullanılabildiği ve yararlanabildiği yokuşlu sürüş ortamlarında dur-kalk yapılan şehir içi sürüşü gittikçe daha fazla verimlilik sağlar.
API'den, tüm rota için tahmini yakıt tüketimini döndürmesini de isteyebilirsiniz. Yakıt tüketimi tahminlerini farklı rotaları karşılaştırmak için kullanın, aracınızın tam yakıt kullanımı tahminleri olarak kullanmayın.
Google Haritalar'ın yakıt verimliliğini tahmin etme şekli
Routes API, ABD Enerji Bakanlığı Ulusal Yenilenebilir Enerji Laboratuvarı'ndan ve Avrupa Çevre Ajansı'ndan alınan verileri 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 tasarrufunu gösterir.
Çevre dostu rota bulma teknolojisi (PDF) hakkında daha fazla bilgi edinin.
Ön koşullar
Çevre dostu rota bulma veya yakıt tüketimini tahmin etme:
Yönlendirme tercihi olarak
TRAFFIC_AWARE_OPTIMAL
belirtmeniz gerekir. Bu modda sunucu, en iyi rotayı bulmak için yol ağında daha kapsamlı bir arama yapar. Daha fazla bilgi için Kalite ve gecikmeyi yapılandırma bölümüne bakın.travelMode
değeriniDRIVE
olarak ayarlamalısınız. Diğer ulaşım şekli istekleri hata döndürür.Kalkış ara noktası için desteklenen bir bölgede konum belirlemeniz gerekir. Aksi takdirde, API bir hata döndürür.
Rotada ara nokta bulunamaz.
Faturalandırma
Google Haritalar Platformu genellikle Önizleme özelliğinin kullanımı için ücret almaz. Bununla birlikte, çevre dostu rota bulma ve yakıt tüketimini tahmin etme, rota tercihi olarak TRAFFIC_AWARE_OPTIMAL
değerini belirtmenizi gerektirdiğinden SKU: Routes Advanced'e göre ücretlendirilirsiniz.
Routes API için faturalandırma hakkında daha fazla bilgi
Çevre dostu bir rota isteyin
Çevre dostu rotanın hesaplanması için istekte bulunmak için istekte aşağıdaki özellikleri ayarlayın:
VehicleEmissionType (Araç Emisyon Türü) özelliğinde tanımlanan değerleri kullanarak araç için
emissionType
değerini belirtin:DIESEL
,GASOLINE
,ELECTRIC
veyaHYBRID
. Varsayılan değerGASOLINE
değeridir.requestedReferenceRoutes
değeriniFUEL_EFFICIENT
olarak ayarlayın.Çevre dostu bir rotayla ilişkili yanıt özelliklerini döndüreceğini belirten bir yanıt alanı maskesi ayarlayın:
routes.routeLabels:
Her 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 bir rota jetonu.
Çevre dostu istek örneği
Aşağıdaki kodda, çevre dostu rota isteği gösterilmektedir. Bu örnekte, routes.distanceMeters
ve routes.duration
özellikleriyle birlikte çevre dostu bir rotayla ilişkili yanıt özelliklerini döndürmek için yanıt alanı maskesini kullanırsınız:
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'
Ç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ğiDEFAULT_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
değerinitrue
değerine ayarlarsanızrouteLabels
dizi ö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
şu etiketleri içerir: DEFAULT_ROUTE
ve FUEL_EFFICIENT
:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
Rota için yakıt kullanımını tahmin etme
Rotanın tamamı için tahmini yakıt kullanımını mikrolitre cinsinden döndürme yöntemini isteyebilirsiniz. Bir rotanın tahmini yakıt kullanımını yanıta eklemek için:
Yakıt kullanımı hesaplamasını etkinleştirmek için
extraComputations
dizi alanınıFUEL_CONSUMPTION
olarak ayarlayın.VehicleEmissionType (Araç Emisyon Türü) özelliğinde tanımlanan değerleri kullanarak araç için
emissionType
değerini belirtin:DIESEL
,GASOLINE
,ELECTRIC
veyaHYBRID
. Varsayılan değerGASOLINE
değeridir.emissionType
değeriHYBRID
ise API, elektrik ve yakıt tüketimini mikro litre yakıta dönüştürür.emissionType
değeriELECTRIC
ise API, elektrik tüketimini mikro litre yakıta dönüştürür.Yakıt kullanımıyla ilişkili yanıt özelliklerini döndüreceğini belirten bir yanıt alanı maskesi ayarlayın:
routes.travelAdvisory.fuelConsumptionMicroliters
.
Aşağıdaki örnekte çevre dostu rotayı da içeren bir talep kapsamında tahmini yakıt kullanımı istenmiştir:
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'
Yanıtta, hem varsayılan rota hem de çevre dostu rota için tahmini yakıt tüketimi yer alır:
{ "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ışıyor. Aşağıdaki listede çevre dostu rota bulma için ülke bazında 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)