Bu sayfa, Cloud Translation API ile çevrilmiştir.

Çevre dostu rota bulma

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ğerini DRIVE 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 veya HYBRID. Varsayılan değer GASOLINE değeridir.
requestedReferenceRoutes değerini FUEL_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 veya DEFAULT_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ğ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 değerini true değerine ayarlarsanız routeLabels dizi özelliği DEFAULT_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 veya HYBRID. Varsayılan değer GASOLINE değeridir.

emissionType değeri HYBRID ise API, elektrik ve yakıt tüketimini mikro litre yakıta dönüştürür.

emissionType değeri ELECTRIC 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)