Ringkasan Routes API

Routes API adalah layanan yang menerima permintaan HTTPS dan menampilkan rute yang ideal antara dua lokasi, atau jarak dan waktu perjalanan 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, serta preferensi rute:

  • Jenis dan kemampuan berbagai moda transportasi

  • Ke arah mana kendaraan yang dilintasi

  • Sisi jalan untuk pengambilan atau pengantaran

  • Kondisi lalu lintas dan penutupan jalan

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

  • Menyeimbangkan latensi, kualitas, dan biaya untuk seluruh kebutuhan perutean Anda dengan fitur opsional seperti tarif tol dan metadata perjalanan seperti waktu dan jarak, serta efisiensi bahan bakar

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

  • Cara terbaik untuk menugaskan satu set pekerja guna mengambil serangkaian paket

  • Menentukan gudang terbaik untuk mengirim paket ke tujuan akhir mereka

Apa yang dapat Anda lakukan dengan Routes API?

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

  • Rute dari lokasi ke satu atau beberapa tujuan

  • Matriks berisi kemungkinan rute antara banyak lokasi awal dan akhir.

Mendapatkan rute untuk satu atau beberapa tujuan

Dengan metode Compute Routes Routes API, Anda dapat menghitung antarlokasi:

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

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

    • Serangkaian titik jalan yang dapat Anda optimalkan agar urutan perjalanannya paling efisien.

  • Beberapa cara untuk menentukan 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 Anda dengan hanya meminta data yang Anda perlukan menggunakan mask kolom, yang membantu Anda menghindari waktu pemrosesan yang tidak perlu dan tarif penagihan permintaan yang lebih tinggi. Untuk mengetahui detailnya, lihat Memilih informasi yang akan ditampilkan.

Mendapatkan matriks rute yang memungkinkan

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

  • Jarak untuk mode perjalanan yang dipilih

  • Jarak dalam kilometer atau mil

  • Perkiraan waktu tempuh dalam lalu lintas

Dengan data jarak, Anda dapat menentukan cara paling efisien untuk merutekan penumpang, pengiriman, atau pekerja antara beberapa kemungkinan tempat asal dan tujuan.

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

Anda dapat menentukan beberapa tempat asal dan tujuan per permintaan sisi server dengan jumlah tempat 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. Wajib adalah origin, destination, 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 ini kemudian menghitung rute yang diminta, dan menampilkan kolom yang Anda minta.

ComputeRouteMatrix

ComputeRouteMatrix Routes API menerima permintaan POST HTTP dengan isi permintaan JSON yang berisi detail permintaan. Diperlukan setidaknya satu asal, dua atau beberapa tujuan, travelMode, dan mask kolom untuk menentukan kolom mana 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 titik jalan asal dan tujuan.

Referensi

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

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

Cara menggunakan Routes API

1 Memulai Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti.
2 Menghitung rute dan meninjau responsnya Untuk mengetahui informasi selengkapnya, lihat Mendapatkan rute dan Meninjau respons rute.
3 Menghitung matriks rute dan meninjau responsnya Untuk mengetahui 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 selanjutnya