Dapatkan rute yang ramah lingkungan

Secara default, Routes API menampilkan rute default, yang berarti rute tanpa memperhitungkan efisiensi bahan bakar atau energi. Jika Anda mengaktifkan sistem ramah lingkungan pemilihan rute, Anda tetap mendapatkan rute default dalam respons. Selain itu, Anda juga kembali ke rute ramah lingkungan yang menunjukkan rute yang paling hemat bahan bakar atau energi berdasarkan jenis mesin kendaraan Anda.

Rute ramah lingkungan yang ditampilkan oleh Routes API dioptimalkan untuk konsumsi bahan bakar yang lebih rendah di seluruh rute. API menggunakan mesin kendaraan Anda beserta faktor lain seperti lalu lintas dan kondisi jalan real-time memilih rute yang ramah lingkungan. Semakin hemat bahan bakar atau energi pada rute tersebut, menurunkan penggunaan bahan bakar/energi dan emisi CO2 mobil Anda.

Misalnya, keunggulan ekonomi bahan bakar relatif pada kendaraan diesel umumnya terbaik saat mengemudi di jalan raya. Kendaraan hybrid dan listrik cenderung menyediakan peningkatan efisiensi yang semakin besar untuk kendaraan di kota dan di jalan yang naik turun di mana mereka dapat secara ekstensif menggunakan dan mendapatkan manfaat dari regeneratif pengereman.

Anda juga dapat meminta agar API menampilkan perkiraan konsumsi bahan bakar untuk seluruh rute. Gunakan perkiraan konsumsi bahan bakar sebagai cara untuk membandingkan rute yang berbeda, bukan sebagai perkiraan penggunaan bahan bakar eksplisit untuk kendaraan Anda yang sebenarnya.

Cara Google Maps memperkirakan efisiensi bahan bakar

Routes API memperkirakan efisiensi bahan bakar menggunakan insight dari Amerika Serikat Departemen Energi Laboratorium Energi Terbarukan Nasional dan data dari European Environment Agency. Penghitungan ini mencakup faktor-faktor yang memengaruhi penggunaan bahan bakar dan energi serta emisi CO2, seperti:

  • Konsumsi bahan bakar atau energi rata-rata untuk kendaraan di wilayah Anda
  • Kecuraman bukit di rute Anda
  • Pola lalu lintas berhenti dan berangkat
  • Jenis jalan (misalnya jalan lokal atau jalan raya)

Routes API menampilkan rute yang paling hemat bahan bakar atau energi jika memiliki waktu kedatangan kurang lebih sama dengan rute default. Dalam kasus di mana bahan bakar atau penghematan energi terlalu kecil atau meningkatkan waktu mengemudi secara signifikan, API menampilkan penghematan bahan bakar atau energi relatif di antara rute untuk membantu Anda membandingkan.

Baca selengkapnya tentang teknologi pemilihan rute ramah lingkungan (PDF).

Prasyarat

Untuk menggunakan pemilihan rute ramah lingkungan atau memperkirakan konsumsi bahan bakar:

  • Anda harus menentukan TRAFFIC_AWARE_OPTIMAL sebagai preferensi pemilihan rute. Di sini server akan melakukan pencarian jaringan jalan secara lebih menyeluruh untuk menemukan rute yang optimal. Untuk informasi selengkapnya, lihat Mengonfigurasi kualitas vs latensi.

  • Anda harus menetapkan travelMode ke DRIVE. Permintaan untuk mode perjalanan lainnya akan menampilkan error.

  • Anda harus menetapkan lokasi untuk titik jalan asal dalam wilayah yang didukung. Jika tidak, API akan menampilkan error.

  • Rute tidak boleh berisi titik jalan perantara.

Penagihan

Biasanya, Google Maps Platform tidak mengenakan biaya untuk penggunaan Pratinjau aplikasi baru. Namun, karena pemilihan rute yang ramah lingkungan dan memperkirakan konsumsi bahan bakar mengharuskan Anda menentukan TRAFFIC_AWARE_OPTIMAL sebagai preferensi pemilihan rute, ditagih berdasarkan SKU: Rute Lanjutan.

Pelajari lebih lanjut penagihan untuk Routes API.

Meminta rute ramah lingkungan

Untuk membuat permintaan guna menghitung rute ramah lingkungan, tetapkan properti berikut dalam permintaan:

  • Tentukan emissionType untuk kendaraan menggunakan nilai yang ditentukan dalam VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC, atau HYBRID. Nilai defaultnya adalah GASOLINE.

  • Tetapkan requestedReferenceRoutes ke FUEL_EFFICIENT.

  • Menetapkan mask kolom respons yang menentukan untuk menampilkan properti respons yang dikaitkan dengan rute ramah lingkungan:

    • routes.routeLabels: Mengidentifikasi setiap rute sebagai DEFAULT_ROUTE, FUEL_EFFICIENT, atau DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: Token rute yang dapat Anda teruskan ke Navigation SDK untuk mengambil rute kustom.

Contoh permintaan ramah lingkungan

Kode berikut menunjukkan permintaan rute ramah lingkungan. Dalam contoh ini, Anda menggunakan mask kolom respons untuk mengembalikan properti respons yang terkait dengan rute ramah lingkungan bersama dengan routes.distanceMeters dan Properti routes.duration:

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'

Contoh respons ramah lingkungan

Panggilan computeRoutes di atas menghasilkan respons JSON yang berisi dua rute: rute default dan rute hemat bahan bakar. Dalam respons:

  • Untuk rute default, properti array routeLabels berisi DEFAULT_ROUTE.

  • Untuk rute yang ramah lingkungan, properti array routeLabels berisi FUEL_EFFICIENT.

  • Jika Anda menetapkan computeAlternativeRoutes dalam permintaan ke true untuk menghitung rute alternatif, properti array routeLabels berisi DEFAULT_ROUTE_ALTERNATE.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Karena kondisi mengemudi saat ini dan faktor lainnya, rute default dan rute ramah lingkungan bisa sama. Dalam hal ini, routeLabels berisi kedua label: DEFAULT_ROUTE dan FUEL_EFFICIENT:

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

Memperkirakan penggunaan bahan bakar untuk rute

Anda dapat meminta metode ini untuk menampilkan perkiraan penggunaan bahan bakar untuk seluruh rute, dalam mikroliter. Untuk menambahkan perkiraan penggunaan bahan bakar untuk sebuah rute ke respons:

  • Tetapkan kolom array extraComputations ke FUEL_CONSUMPTION untuk mengaktifkan perhitungan penggunaan bahan bakar.

  • Tentukan emissionType untuk kendaraan menggunakan nilai yang ditentukan dalam VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC, atau HYBRID. Nilai defaultnya adalah GASOLINE.

    Jika emissionType adalah HYBRID, API akan mengonversi listrik dan bahan bakar konsumsi bahan bakar hingga mikroliter.

    Jika emissionType adalah ELECTRIC, API akan mengonversi listrik konsumsi bahan bakar hingga mikroliter.

  • Menetapkan mask kolom respons yang menentukan untuk menampilkan properti respons terkait dengan penggunaan bahan bakar: routes.travelAdvisory.fuelConsumptionMicroliters.

Contoh berikut meminta perkiraan penggunaan bahan bakar sebagai bagian dari permintaan yang juga mencakup rute ramah lingkungan:

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'

Respons berisi perkiraan konsumsi bahan bakar untuk kedua rute default dan untuk rute ramah lingkungan:

{
    "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"
            ]
        }
    ]
}

Region yang didukung

Tim Google Maps Platform terus berupaya meningkatkan layanan internasional untuk layanan API kami. Daftar berikut menampilkan liputan terbaru detail, berdasarkan setiap negara, untuk pemilihan rute yang ramah lingkungan:

  • Albania (AL)
  • Austria (AT)
  • Belgia (BE)
  • Bosnia dan Herzegovina (BA)
  • Bulgaria (BG)
  • Kanada (CA)
  • Kroasia (HR)
  • Siprus (CY)
  • Republik Ceko (CZ)
  • Denmark (DK)
  • Estonia (EE)
  • Finlandia (FI)
  • Prancis (FR)
  • Jerman (DE)
  • Yunani (GR)
  • Hungaria (HU)
  • Islandia (IS)
  • Irlandia (IE)
  • Italia (TI)
  • Kosovo (XK)
  • Latvia (LV)
  • Liechtenstein (LI)
  • Lituania (LT)
  • Luksemburg (LU)
  • Malta (MT)
  • Montenegro (ME)
  • Belanda (NL)
  • Makedonia Utara (MK)
  • Norwegia (NO)
  • Polandia (PL)
  • Portugal (PT)
  • Rumania (RO)
  • Serbia (RS)
  • Slovakia (SK)
  • Slovenia (SI)
  • Spanyol (ES)
  • Swedia (SE)
  • Swiss (CH)
  • Turki (TR)
  • Inggris Raya (GB)
  • Amerika Serikat (AS)