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

Jalan Terdekat

Google Maps Roads API mengambil sampai 100 koordinat independen, dan mengembalikan segmen jalan terdekat untuk setiap titik. Titik yang diteruskan tidak harus menjadi bagian dari jalur yang berkelanjutan.

Jika Anda bekerja dengan titik GPS yang berurutan, gunakan Snap to Roads.

Permintaan

Permintaan ke jalan terdekat harus dikirimkan melalui HTTPS dan berbentuk seperti berikut:

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

Penggunaan Parameter

Parameter yang Diperlukan

  • points — Daftar pasangan garis lintang/bujur. Nilai garis lintang dan garis bujur harus dipisah dengan koma. Koordinat harus dipisah dengan karakter pipa: "|". Misalnya: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • 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.

Respons

Untuk setiap permintaan yang valid, Google Maps Roads API akan mengembalikan respons dalam format yang ditunjukkan dalam URL permintaan. Elemen berikut mungkin ada dalam respons Snap to Roads.

  • snappedPoints — larik titik yang diikat. Setiap titik terdiri dari bidang-bidang berikut:
    • location — Berisi nilai latitude dan longitude.
    • originalIndex — Integer yang menunjukkan nilai yang sesuai dalam permintaan asalnya. Setiap titik dalam permintaan dipetakan ke maksimum dua segmen dalam respons:
      • Jika tidak ada jalan yang terdekat, segmen tidak dikembalikan.
      • Jika jalan yang terdekat satu arah, satu segmen dikembalikan.
      • Jika jalan yang terdekat dua arah, dua segmen dikembalikan.
    • placeId — Sebuah identifier unik untuk tempat. Semua ID tempat yang dikembalikan oleh Google Maps Roads API akan sesuai dengan ruas jalan. [ID Tempat] bisa digunakan bersama Google API lainnya, termasuk Google Places API dan Google Maps JavaScript API. Misalnya, jika Anda perlu mendapatkan nama-nama jalan bagi titik terikat yang dikembalikan oleh Google Maps Roads API, Anda bisa meneruskan placeId ke Google Places API atau Google Maps Geocoding API. Dalam Google Maps Roads API, Anda bisa meneruskan placeId dalam permintaan batas kecepatan untuk menentukan batas kecepatan di sepanjang ruas jalan itu.

Contoh Permintaan

Permintaan berikut mengembalikan serangkaian ruas jalan berdasarkan daftar koordinat yang ditetapkan.

Permintaan

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

Respons

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

Kirim masukan tentang...

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