Çevre dostu rota bulma

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 öğesini DRIVE 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 veya HYBRID. GASOLINE, varsayılan değerdir.

  • requestedReferenceRoutes öğesini 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 bir 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 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 öğesini true olarak ayarlarsanız routeLabels dizisi ö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 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 veya HYBRID. GASOLINE, varsayılan değerdir.

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

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