Çevre dostu rota bulma

Routes API varsayılan olarak varsayılan rotayı döndürür. Bu rota, yakıt veya enerji verimliliğini hesaba katmaz. Çevre dostu rota özelliğini etkinleştirdiğinizde yanıtta varsayılan rota gösterilmeye devam eder. 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 rota da alırsınız.

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 edilir. API, çevre dostu rotayı seçmek için aracınızın motor türünü, anlık trafik ve yol durumu gibi diğer faktörlerle birlikte kullanır. Rotanın yakıt veya enerji verimliliği ne kadar yüksek olursa arabanızın yakıt veya enerji kullanımı ve CO2 emisyonu da o kadar düşük olur.

Örneğin, dizel araçların yakıt ekonomisi avantajı genellikle otoyol sürüşü için idealdir. Hibrit ve elektrikli araçlar, sıkça durup kalkmayı gerektiren şehir trafiğinde çoğu zaman rejeneratif frenleme kullandıkları için daha fazla verimlilik sağlar.

API'den, rotanın tamamı için tahmini yakıt tüketimini de döndürmesini isteyebilirsiniz. Yakıt tüketimi tahminlerini, aracınız için kesin yakıt tüketimi tahminleri olarak değil, farklı rotaları karşılaştırmak için kullanı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 her rotanın sağladığı 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 değerini belirtmeniz gerekir. Bu modda sunucu, en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama yapar. Daha fazla bilgi için Kaliteyi ve gecikmeyi yapılandırma başlıklı makaleyi inceleyin.

  • travelMode değerini DRIVE olarak ayarlamanız gerekir. Diğer seyahat modlarıyla ilgili istekler hata döndürür.

  • Başlangıç yol noktası için desteklenen bir bölgede bir konum ayarlamanız gerekir. Aksi takdirde API bir hata döndürür.

  • Rota, ara yol noktası içeremez.

Faturalandırma

Google Haritalar Platformu, genellikle önizleme özelliklerinin kullanımı için ücret almaz. Ancak çevre dostu rota bulma ve yakıt tüketimini tahmin etme özelliği için rota tercihi olarak TRAFFIC_AWARE_OPTIMAL'ü belirtmeniz gerektiğinden SKU: Compute Routes Pro'ya göre ücretlendirilirsiniz.

Routes API için faturalandırma hakkında daha fazla bilgi edinin.

Çevre dostu rota isteğinde bulunma

Çevre dostu bir rota hesaplama isteği göndermek için istekte aşağıdaki özellikleri ayarlayın:

  • VehicleEmissionType alanında tanımlanan değerleri kullanarak araç için emissionType değerini belirtin: DIESEL, GASOLINE, ELECTRIC veya HYBRID. Varsayılan değer GASOLINE'tür.

  • requestedReferenceRoutes değerini FUEL_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 rotayı DEFAULT_ROUTE, FUEL_EFFICIENT veya DEFAULT_ROUTE_ALTERNATE olarak tanımlar.

    • routes.routeToken: Özel bir rota almak için Navigasyon SDK'sına iletebileceğiniz rota jetonu.

Çevre dostu istek örneği

Aşağıdaki kodda, çevre dostu bir 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 örnek yanıt

Yukarıdaki computeRoutes çağrısı, varsayılan rota ve yakıt tasarruflu rota olmak üzere iki rota içeren bir JSON yanıtı oluşturur. Yanıtta:

  • Varsayılan rota için routeLabels dizi mülkü DEFAULT_ROUTE içerir.

  • Çevre dostu rota için routeLabels dizi mülkü FUEL_EFFICIENT içerir.

  • Alternatif rotaları hesaplamak için istekteki computeAlternativeRoutes değerini true olarak 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 ile çevre dostu rota aynı olabilir. Bu durumda routeLabels, DEFAULT_ROUTE ve FUEL_EFFICIENT etiketlerini içerir:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

Rotanın yakıt tüketimini tahmin etme

Yöntemin, rotanın tamamı için tahmini yakıt tüketimini mikrolitre cinsinden döndürmesini isteyebilirsiniz. Bir rotanın tahmini yakıt tüketimini yanıta eklemek için:

  • Yakıt tüketimi hesaplamasını etkinleştirmek için extraComputations dizi alanını FUEL_CONSUMPTION olarak ayarlayın.

  • VehicleEmissionType alanında tanımlanan değerleri kullanarak araç için emissionType değerini belirtin: DIESEL, GASOLINE, ELECTRIC veya HYBRID. Varsayılan değer GASOLINE'tür.

    emissionType HYBRID ise API, elektrik ve yakıt tüketimini mikrolitre yakıta dönüştürür.

    emissionType ELECTRIC 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 tüketimi istenir:

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ı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 olarak çalışmaktadır. Aşağıdaki listede, çevre dostu yönlendirme 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)