Çevre dostu rota bulma

Routes API, varsayılan olarak default (varsayılan) rotayı (rota) döndürür. sağlamayacağını umuyorum. Çevre dostu yönlendirme, yanıtta varsayılan yolu görmeye devam edersiniz. Ayrıca, Yakıt veya enerji açısından en verimli rotayı gösteren çevre dostu bir rotaya geri dönmek aracınızın motor türüne göre değişir.

Routes API'nin döndürdüğü çevre dostu rota, şunun için optimize edilmiştir: Rota boyunca daha düşük yakıt tüketimi API, aracınızın motorunu kullanır trafik ve yol koşulları gibi diğer faktörlerle birlikte bu verileri çevre dostu rotayı seçin. Rotanın yakıt veya enerji verimliliği ne kadar yüksek olursa, arabanızın yakıt/enerji kullanımını ve CO2 emisyonunu azaltır.

Örneğin, dizel bir aracın göreli yakıt ekonomisi avantajı, en iyi araç bu. Hibrit ve elektrikli araçlar genellikle dur-kalk şehir içi sürüşte ve yokuşlu sürüşte gün geçtikçe daha fazla verimlilik üretken yapay zekadan yoğun şekilde yararlanabileceği frenleme.

Ayrıca API'nin şunun için tahmini yakıt tüketimini döndürmesini isteyebilirsiniz: karar verebilir. Yakıt tüketimi tahminlerini, tam aracınıza ait açık yakıt kullanımı tahminleri değil, farklı rotalar.

Google Haritalar'ın yakıt verimliliğini tahmin etme şekli

Routes API, ABD'den alınan analizleri kullanarak yakıt verimliliğini tahmin ediyor Enerji Bakanlığı Ulusal Yenilenebilir Enerji Laboratuvarı ve veriler Avrupa Çevre Ajansı'ndan alınmıştır. Bu hesaplamaya faktörler dahildir yakıt ve enerji kullanımınızı ve CO2 emisyonlarını etkileyen faktörler. Ö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, aşağıdaki durumlarda yakıt veya enerji verimliliği en yüksek rotayı döndürür: varsayılan rotayla hemen hemen aynı varış saatidir. Yakıt veya az enerji tasarrufu sağlar veya sürüş süresini önemli ölçüde artırırsa API, Karşılaştırma yapmanıza yardımcı olmak için rotalar arasındaki göreli 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 veya yakıt tüketimini tahmin etme:

  • Yönlendirme tercihi olarak TRAFFIC_AWARE_OPTIMAL belirtmeniz gerekir. Burada modundaysa sunucu, güzergâhı tıklayarak yol ağında en uygun rotayı bulur. Daha fazla bilgi için bkz. Kalite ve gecikmeyi yapılandırın.

  • travelMode değerini DRIVE olarak ayarlamalısınız. İstekler: diğer ulaşım şekilleri hata döndürür.

  • Başlangıç noktası ara noktası için desteklenen bir bölge olduğundan emin olun. Aksi takdirde, API bir hata döndürür.

  • Rotada ara nokta bulunamaz.

Faturalandırma

Google Haritalar Platformu genellikle Önizleme kullanımı için ücret almaz. özelliğini kullanabilirsiniz. Ancak çevre dostu rota bulma ve yakıt tüketimini tahmin etme yönlendirme tercihi olarak TRAFFIC_AWARE_OPTIMAL belirtilmesini gerektirirse SKU: Rotalar'a göre ücretlendirilirsiniz. Gelişmiş'i tıklayın.

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

Çevre dostu bir rota isteyin

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

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

  • requestedReferenceRoutes değerini FUEL_EFFICIENT olarak ayarlayın.

  • Yanıt özelliklerini döndüreceğini belirten bir yanıt alanı maskesi ayarlayın çevre dostu bir rotayla ilişkili:

    • routes.routeLabels: Her rotayı DEFAULT_ROUTE, FUEL_EFFICIENT veya DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: Şu kullanıcıya iletebileceğiniz bir rota jetonu Gezinme SDK'sı özel rota.

Çevre dostu istek örneği

Aşağıdaki kodda, çevre dostu rota isteği gösterilmektedir. Bu örnekte Bir routes.distanceMeters ve boyunca uzanan çevre dostu rota routes.duration mülk:

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ı, aşağıdakileri içeren bir JSON yanıtı oluşturur: Varsayılan rota ve yakıt verimliliği yüksek rota olmak üzere iki rota. Yanıtta:

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

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

  • Hesaplamak için true isteğinde computeAlternativeRoutes değerini ayarlarsanız alternatif rotalar, 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 DEFAULT_ROUTE ve FUEL_EFFICIENT etiketleri:

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

Rota için yakıt kullanımını tahmin etme

Cihazın tamamı için tahmini yakıt kullanımını döndürme yöntemini isteyebilirsiniz rotasını belirtmelidir. Bir rotanın tahmini yakıt kullanımını yanıt:

  • Aşağıdaki kodu etkinleştirmek için extraComputations dizi alanını FUEL_CONSUMPTION olarak ayarlayın: yakıt kullanımı hesaplaması.

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

    emissionType değeri HYBRID ise API elektriği ve yakıtı dönüştürür yakıt tüketimini ifade eder.

    emissionType değeri ELECTRIC ise API elektriği dönüştürür yakıt tüketimini ifade eder.

  • Yanıt özelliklerini döndüreceğini belirten bir yanıt alanı maskesi ayarlayın yakıt kullanımıyla ilişkili: routes.travelAdvisory.fuelConsumptionMicroliters

Aşağıdaki örnekte, tahmini yakıt kullanımı şu şekilde talep edilmektedir: çevre dostu rota da dahildir:

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, her iki varsayılan rota için tahmini yakıt tüketimini içerir çevre dostu rota için:

{
    "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, uluslararası deneyimi iyileştirmek için sürekli çalışıyor kapsamıyla sınırlı değildir. Aşağıdaki listede en son haberler gösterilmektedir çevre dostu rota planlaması için ülke bazında bilgiler:

  • 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)