Çevre dostu rota bulma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Routes API, varsayılan olarak varsayılan rotayı döndürür. Bu, yakıt veya enerji verimliliğinin dikkate alınmadığı bir rota anlamına gelir. Çevre dostu rotayı etkinleştirdiğinizde yanıtta varsayılan rotayı almaya devam edersiniz. Ayrıca, aracınızın motor türüne göre en yakıt veya enerji verimli 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 edilmiştir. API, çevre dostu rotayı seçmek için anlık trafik ve yol durumu gibi diğer faktörlerin yanı sıra aracınızın motor türünü 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'nin, rotanın tamamı için tahmini yakıt tüketimini döndürmesini de isteyebilirsiniz. Yakıt tüketimi tahminlerini, aracınızın tam yakıt kullanımı 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, yakıt verimliliğini ABD Enerji Bakanlığı Ulusal Yenilenebilir Enerji Laboratuvarı'ndan ve Avrupa Çevre Ajansı'ndan alınan verileri kullanarak 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, yakıt veya enerji verimliliği en yüksek rotayı, varsayılan rotayla hemen hemen aynı varış saatine sahip olduğunda 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 Kalite ve gecikme süresini yapılandırma başlıklı makaleyi inceleyin.

  • travelMode öğesini DRIVE veya TWO_WHEELER olarak ayarlamanız gerekir. Diğer seyahat modları için yapılan istekler hata döndürür. TWO_WHEELER için çevre dostu rotalama yalnızca birkaç ülkede desteklenir.

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

  • TWO_WHEELER için iki tekerlekli araçların desteklendiği bir bölgede başlangıç ara noktası için bir konum belirlemeniz gerekir. Aksi takdirde API hata döndürür.

  • Rota, ara yol noktası içeremez.

Faturalandırma

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

Routes API'nin faturalandırılması hakkında daha fazla bilgi edinin.

Çevre dostu rota isteğinde bulunma

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

  • VehicleEmissionType içinde tanımlanan değerleri kullanarak araç için emissionType değerini belirtin: DIESEL, GASOLINE, ELECTRIC veya HYBRID. Varsayılan değer: GASOLINE.

  • requestedReferenceRoutes değerini FUEL_EFFICIENT olarak ayarlayın.

  • Çevre dostu bir rotayla ilişkili yanıt özelliklerinin döndürülmesini 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 Navigation SDK'ya iletebileceğiniz bir rota jetonu.

Çevre dostu örnek istek

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ıyorsunuz:

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ı, iki rota içeren bir JSON yanıtı oluşturur: varsayılan rota ve yakıt tasarruflu rota. Yanıtın içinde:

  • Varsayılan rota için routeLabels dizi özelliği DEFAULT_ROUTE içerir.

  • Çevre dostu rota için routeLabels dizi özelliği FUEL_EFFICIENT içerir.

  • İstek içinde computeAlternativeRoutes değerini true olarak ayarlarsanız alternatif rotalar hesaplanır ve 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 hem DEFAULT_ROUTE hem de FUEL_EFFICIENT etiketlerini 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

Tahmini yakıt kullanımını tüm rota için 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ının hesaplanmasını etkinleştirmek için extraComputations dizi alanını FUEL_CONSUMPTION olarak ayarlayın.

  • VehicleEmissionType içinde tanımlanan değerleri kullanarak araç için emissionType değerini belirtin: DIESEL, GASOLINE, ELECTRIC veya HYBRID. Varsayılan değer: GASOLINE.

    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 isteğin parçası olarak tahmini yakıt kullanımı isteniyor:

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 rotanın hem de çevre dostu rotanın tahmini yakıt tüketimi yer alıyor:

{
    "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 rotalarla ilgili en son kapsama alanı ayrıntıları ülke bazında gösterilmektedir:

  • Arnavutluk (AL)
  • Avustralya (AU)
  • 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)
  • Mısır (EG)
  • Estonya (EE)
  • Finlandiya (FI)
  • Fransa (FR)
  • Almanya (DE)
  • Yunanistan (GR)
  • Macaristan (HU)
  • İzlanda (IS)
  • Hindistan (IN)
  • Endonezya (ID)
  • İrlanda (IE)
  • İtalya (IT)
  • Kosova (XK)
  • Letonya (LV)
  • Lihtenştayn (LI)
  • Litvanya (LT)
  • Lüksemburg (LU)
  • Malta (MT)
  • Meksika (MX)
  • Karadağ (ME)
  • Hollanda (NL)
  • Kuzey Makedonya (MK)
  • Norveç (NO)
  • Polonya (PL)
  • Portekiz (PT)
  • Romanya (RO)
  • Suudi Arabistan (SA)
  • Sırbistan (RS)
  • Slovakya (SK)
  • Slovenya (SI)
  • İspanya (ES)
  • İsveç (SE)
  • İsviçre (CH)
  • Türkiye (TR)
  • Birleşik Arap Emirlikleri (AE)
  • İngiltere (GB)
  • Amerika Birleşik Devletleri (US)

İki tekerlekli araçların desteklendiği bölgeler

Aşağıdaki listede, iki tekerlekli araçların çevre dostu rotalandırılmasıyla ilgili ülke bazında en son kapsama alanı ayrıntıları gösterilmektedir:

  • Hindistan (IN)
  • Endonezya (ID)