Ringkasan Routes API

Routes API adalah layanan yang menerima permintaan HTTPS dan menampilkan rute ideal antara dua lokasi, atau jarak dan perjalanan waktu untuk matriks rute antara lokasi asal dan tujuan yang berbeda.

Alasan menggunakan Routes API

Dengan Routes API, Anda bisa mendapatkan rute dan informasi perjalanan yang akurat menggunakan detail transportasi, kondisi lalu lintas dan jalan terbaru, dan rute preferensi:

  • Jenis dan kemampuan berbagai moda transportasi

  • Arah yang dituju kendaraan

  • Sisi jalan untuk penjemputan atau pengantaran

  • Kondisi lalu lintas dan penutupan jalan

  • Masalah keselamatan seperti menghindari area berbahaya atau menyediakan pengambilan yang aman area

  • Seimbangkan latensi, kualitas, dan biaya di seluruh kebutuhan pemilihan rute Anda dengan model fitur seperti metadata perjalanan dan tol seperti waktu dan jarak, serta bahan bakar efisiensi

Anda juga dapat menentukan rute yang paling efisien untuk penjadwalan pengiriman, seperti sebagai:

  • Cara terbaik untuk menetapkan satu set pekerja untuk mengambil serangkaian paket

  • Menentukan gudang terbaik untuk mengirim paket ke gudang final tujuan

Apa yang dapat Anda lakukan dengan Routes API?

Dengan Routes API, Anda bisa mendapatkan dua kategori utama perutean informasi:

  • Rute dari sebuah lokasi ke satu atau beberapa tujuan

  • Matriks kemungkinan rute antara banyak lokasi awal dan akhir.

Mendapatkan rute untuk satu atau beberapa tujuan

Dengan metode Compute Routes Routes API, Anda dapat menghitung di antara lokasi:

  • Dapatkan rute untuk berbagai cara bepergian, dan untuk satu atau beberapa cara tujuan:

    • Moda transportasi, termasuk transportasi umum, mengemudi, kendaraan roda dua, berjalan atau bersepeda.

    • Serangkaian titik jalan, yang dapat Anda optimalkan untuk untuk membawanya masuk.

  • Beberapa cara untuk menentukan tempat asal, tujuan, dan titik jalan:

    • String teks. Misalnya: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043", atau "CWF6+FWX Mountain View, California"

    • ID Tempat

    • Koordinat lintang dan bujur, secara opsional dengan arah tujuan kendaraan

  • Menyesuaikan opsi rute berdasarkan kebutuhan dan sasaran Anda:

  • Kontrol latensi dan kualitas dengan hanya meminta data yang diperlukan {i>field mask<i}, untuk membantu Anda menghindari waktu pemrosesan yang tidak perlu dan meminta tarif penagihan. Untuk mengetahui detailnya, lihat Pilih informasi yang akan ditampilkan.

Dapatkan matriks kemungkinan rute

Metode Compute Route Matrix Routes API menyediakan matriks informasi untuk rute yang direkomendasikan antara beberapa awal dan akhir poin, termasuk jarak dan perkiraan waktu kedatangan, untuk membantu Anda memilih tempat asal dan tujuan terbaik berdasarkan kebutuhan bisnis Anda. Anda dapat meminta jenis data jarak berikut:

  • Jarak untuk mode perjalanan yang dipilih

  • Jarak dalam kilometer atau mil

  • Estimasi waktu perjalanan dalam lalu lintas

Dengan data jarak, Anda dapat menentukan cara yang paling efisien untuk mengarahkan rute penumpang, pengiriman, atau pekerja di antara beberapa kemungkinan asal dan tujuan.

Anda dapat melakukan streaming elemen respons sebelum seluruh matriks dihitung, sehingga menurunkan latensi respons.

Anda dapat menentukan beberapa tempat asal dan tujuan per permintaan sisi server dengan jumlah asal dikali jumlah tujuan hingga 625.

Cara kerja Routes API

Routes API memiliki dua metode: ComputeRoutes dan ComputeRouteMatrix.

ComputeRoutes

Metode ComputeRoutes Routes API menerima permintaan POST HTTP dengan isi permintaan JSON yang berisi detail permintaan. Yang diperlukan adalah origin, tujuan, travelMode, dan mask kolom untuk menentukan kolom yang akan ditampilkan.

Contoh

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

Layanan kemudian menghitung rute yang diminta, dan menampilkan kolom yang telah Anda diminta.

ComputeRouteMatrix

Routes API ComputeRouteMatrix menerima permintaan POST HTTP dengan isi permintaan JSON yang berisi detail permintaan. Wajib minimal satu origin, dua atau beberapa tujuan, travelMode, dan field mask untuk menentukan yang akan ditampilkan.

Contoh

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Respons berisi kemungkinan rute untuk kombinasi semua origin dan titik jalan tujuan.

Resource

Tabel berikut meringkas sumber daya yang tersedia melalui Routes API beserta data yang ditampilkan.

Resource data Data yang dikembalikan Format pengembalian
ComputeRoutes Menampilkan rute, segmen, dan langkah untuk rute, dengan rute alternatif, jika diminta. JSON
ComputeRouteMatrix Menampilkan array rute dari satu titik jalan asal ke satu tujuan titik jalan.

Cara menggunakan Routes API

1 Melakukan penyiapan Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti.
2 Menghitung rute dan meninjau respons Untuk informasi selengkapnya, lihat Mendapatkan rute dan Meninjau respons rute.
3 Hitung matriks rute dan tinjau responsnya Untuk informasi selengkapnya, lihat Mendapatkan matriks rute dan Meninjau respons matriks rute.

Library klien yang tersedia

Untuk daftar library klien yang tersedia untuk Routes API, lihat Library klien.

Langkah berikutnya