Çevre dostu rota bulma

Routes API, varsayılan olarak varsayılan rotayı döndürür. Bu, yakıt veya enerji verimliliğini hesaba katmayan bir rotadır. Ç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 yakıt veya enerji verimliliği en yüksek rotayı gösteren çevre dostu bir rota da elde edersiniz.

Routes API tarafından döndürülen çevre dostu rota, tüm rota boyunca 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 anlık 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 veya enerji kullanımı ve CO2 emisyonu 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.

Ayrıca 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 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 hesaplar. 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 Kalite ve gecikme süresini yapılandırma başlıklı makaleyi inceleyin.

• travelMode değerini 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 rota özelliği yalnızca birkaç ülkede desteklenir.

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

• TWO_WHEELER için başlangıç noktasının konumunu iki tekerlekli araçların desteklendiği bir bölgede ayarlamanız gerekir. Aksi takdirde API 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 özellikleri, rota tercihi olarak TRAFFIC_AWARE_OPTIMAL değerini belirtmenizi gerektirdiğ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 rota hesaplama isteğinde bulunmak için istekte aşağıdaki özellikleri ayarlayın:

• VehicleEmissionType'ta 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üleceğ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 Navigasyon SDK'sına iletebileceğiniz bir rota jetonu.

Örnek çevre dostu istek

Aşağıdaki kodda çevre dostu rota isteği gösterilmektedir. Bu örnekte, çevre dostu bir rotayla ilişkili yanıt özelliklerini routes.distanceMeters ve routes.duration özellikleriyle birlikte 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'

Örnek çevre dostu yanıt

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 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 her iki etiketi de 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

Yöntemin, tüm rota için tahmini yakıt kullanımını mikrolitre cinsinden döndürmesini 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'ta 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 cinsinden 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 özelliklerinin döndürüleceğini 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ı 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: 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ı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ı genişletmek için sürekli çalışmaktadır. Aşağıdaki listede, çevre dostu rotalarla ilgili en son kapsam 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)
• Birleşik Krallık (GB)
• Amerika Birleşik Devletleri (US)

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

Aşağıdaki listede, iki tekerlekli araçlar için çevre dostu rotaların ülkelere göre en güncel kapsam ayrıntıları gösterilmektedir:

• Hindistan (IN)
• Endonezya (ID)