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

Memecahkan Masalah Kesalahan

Dalam hal kesalahan, format standar tubuh respons kesalahan akan dikembalikan dan kode status HTTP akan disetel ke status kesalahan.

Respons berisi sebuah objek dengan objek error tunggal bersama kunci berikut:

  • code: Proses ini sama seperti status HTTP respons.
  • message: Keterangan singkat mengenai kesalahan.
  • status: Kode status yang menunjukkan sifat kesalahan.

Misalnya, mengirim parameter placeId yang tidak valid akan mengembalikan kesalahan berikut:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Kemungkinan kesalahan meliputi:

Kode Status Pesan Pemecahan Masalah
400 INVALID_ARGUMENT Kunci yang Anda berikan tidak valid. Kunci API Anda tidak valid atau tidak disertakan dalam permintaan. Pastikan Anda telah menyertakan kunci selengkapnya, dan telah mengaktifkan API untuk kunci ini.
400 INVALID_ARGUMENT parameter "\"path\" berisi nilai yang tidak valid: ☃" Permintaan Anda berisi argumen yang tidak valid. Yang paling sering menyebabkan kesalahan ini adalah:
  • Ada masalah pada parameter path Anda.
    Pastikan Anda memiliki setidaknya 1, dan kurang dari 100 poin. Setiap titik merupakan sepasang angka yang dipisah dengan koma, seperti: 48.409114,-123.369158. Titik harus dipisah dengan karakter pipa: '|'.
  • Permintaan Anda berisi placeId yang tidak valid.
  • Permintaan Anda berisi placeId dan sebuah path. Hanya salah satu dari parameter ini yang bisa ditetapkan untuk setiap permintaan.

Kesalahan ini tidak akan dikembalikan jika placeId diteruskan untuk jalan yang sudah tidak ada, atau untuk tempat yang bukanlah sebuah jalan.

403 PERMISSION_DENIED Permintaan tidak terdaftar telah diblokir. Mendaftarlah menggunakan Google Developers Console. Kunci API Anda tidak valid atau tidak disertakan dalam permintaan. Pastikan Anda telah menyertakan kunci selengkapnya, dan telah mengaktifkan API untuk kunci ini.
404 NOT_FOUND Diperlukan HTTPS untuk layanan ini. Pastikan Anda mengirim permintaan ke https://roads.googleapis.com/ dan bukan http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED Permintaan tersebut terhambat karena batas proyek QPS sudah tercapai. Anda telah melebihi batas permintaan per detik per pengguna yang telah Anda konfigurasi dalam API Console. Batas ini harus dikonfigurasi untuk mencegah satu atau sekelompok kecil pengguna menghabiskan kuota harian Anda, dan sekaligus tetap memungkinkan akses yang semestinya untuk semua pengguna.
429 RESOURCE_EXHAUSTED Permintaan tersebut terhambat karena batas harian telah tercapai. Anda telah melebihi kuota harian untuk proyek Anda.

Backoff eksponensial

Bila permintaan gagal, pastikan Anda mencoba kembali permintaan dengan backoff eksponensial. Misalnya, jika permintaan gagal satu kali, coba lagi setelah satu detik, jika gagal lagi, coba lagi setelah dua detik, kemudian empat detik, dan seterusnya. Ini memastikan permintaan yang rusak atau kegagalan berskala luas tidak membanjiri server Google, karena banyak klien yang akan mencoba beberapa kali permintaan tersebut dengan sangat cepat.

Kirim masukan tentang...

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