Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps Roads API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps Roads API
  3. Buat kunci yang sesuai
Lanjutkan

Batas Kecepatan

Catatan: Layanan batas kecepatan hanya tersedia pada pengguna Google Maps APIs Premium Plan dengan lisensi Asset Tracking.

Google Maps Roads API mengembalikan batas kecepatan yang dipasang untuk ruas jalan tersebut. Dalam kasus ruas jalan dengan batas kecepatan berubah-ubah, maka akan dikembalikan batas kecepatan default untuk segmen tersebut.

Akurasi data batas kecepatan yang dikembalikan oleh Google Maps Roads API tidak bisa dijamin. Data batas kecepatan yang diberikan tidak real-time, dan mungkin merupakan perkiraan, tidak akurat, tidak lengkap, dan/atau sudah usang. Ketidakakuratan dalam data kami bisa dilaporkan melalui layanan Google Map Maker.

Permintaan

Permintaan untuk batas kecepatan harus dikirim melalui HTTPS, dan berbentuk seperti berikut:

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

Penggunaan Parameter

Parameter yang Diperlukan

  • Sebuah path maupun satu atau beberapa placeId.
    • path — Jalur yang akan diikat. Parameter path menerima daftar pasangan garis lintang/garis bujur. Nilai garis lintang dan garis bujur harus dipisah dengan koma. Koordinat harus dipisah dengan karakter pipa: "|". Misalnya: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId — ID tempat untuk ruas jalan. ID tempat dikembalikan sebagai respons terhadap permintaan snapToRoads dan nearestRoads. Anda bisa meneruskan hingga 100 placeId bersama setiap permintaan.
  • key — Kunci API aplikasi Anda. Aplikasi Anda harus mengidentifikasi diri sendiri setiap kali mengirim permintaan ke Google Maps Roads API dengan menyertakan kunci API bersama setiap permintaan. Pelajari cara mendapatkan kunci.

Parameter Opsional

  • units — Apakah akan mengembalikan batas kecepatan dalam kilometer atau mil per jam. Ini bisa disetel ke KPH atau MPH. Default-nya adalah KPH.

Anda bisa meminta data batas kecepatan menggunakan path atau serangkaian placeId; akan tetapi, Anda hanya akan menerima satu respons untuk setiap placeId unik dalam permintaan. Duplikasi placeId mungkin muncul bila ada sejumlah titik di sepanjang jalan yang pendek.

Respons

Elemen berikut mungkin ada dalam respons speedLimits:

  • speedLimits — Larik metadata jalan. Setiap elemen terdiri dari bidang-bidang berikut:
    • placeId — Sebuah identifier unik untuk tempat. Semua placeId yang dikembalikan oleh Google Maps Roads API akan sesuai dengan ruas jalan.
    • speedLimit — Batas kecepatan untuk ruas jalan itu.
    • units — Mengembalikan KPH atau MPH.
  • snappedPoints — larik titik yang diikat. Larik ini hanya ada jika permintaan berisi parameter path. Setiap titik terdiri dari bidang-bidang berikut:
    • location — berisi nilai latitude dan longitude.
    • originalIndex — Integer yang menunjukkan nilai yang sesuai dalam permintaan asalnya. Setiap nilai dalam permintaan harus memetakan ke nilai yang diikat dalam respons. Nilai-nilai ini diindeks dari 0, sehingga titik dengan originalIndex 4 akan menjadi nilai yang diikat dari garis lintang/garis bujur ke-5 yang diteruskan ke parameter path.
    • placeId — Sebuah identifier unik untuk tempat. Semua placeId yang dikembalikan oleh Google Maps Roads API akan sesuai dengan ruas jalan. placeId Bisa diteruskan dalam permintaan batas kecepatan untuk menentukan batas kecepatan di sepanjang ruas jalan tersebut.

Contoh Permintaan

Permintaan berikut akan menentukan batas kecepatan untuk jalan pendek di Canberra, Australia.

Permintaan

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Respons

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Kirim masukan tentang...

Google Maps Roads API
Google Maps Roads API
Butuh bantuan? Kunjungi halaman dukungan kami.