Halaman ini diterjemahkan oleh Cloud Translation API.

Pemecahan masalah

Error

Jika terjadi error, isi respons error format standar akan ditampilkan dan kode status HTTP akan disetel ke status error.

Respons berisi objek dengan satu objek error dengan kunci berikut:

code: Ini sama dengan status HTTP respons.
message: Deskripsi singkat error.
status: Kode status yang menunjukkan sifat error.

Misalnya, mengirimkan parameter placeId yang tidak valid akan menampilkan error 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 seluruh kunci, dan telah mengaktifkan API untuk kunci ini.
400	`INVALID_ARGUMENT`	Parameter "\"path\" berisi nilai yang tidak valid: ☃"	Permintaan Anda berisi argumen yang tidak valid. Penyebab error ini kemungkinan besar adalah: Ada masalah dengan parameter `path` Anda. Pastikan Anda memiliki setidaknya 1, dan kurang dari 100 poin. Setiap titik harus berupa pasangan angka yang dipisahkan koma, seperti: `48.409114,-123.369158`. Titik harus dipisahkan dengan pipa: '\|'. Permintaan Anda menyertakan `placeId` yang tidak valid. Permintaan Anda menyertakan `placeId` dan `path`. Hanya salah satu dari parameter ini yang dapat ditetapkan untuk setiap permintaan. Error ini tidak akan dikembalikan jika `placeId` diteruskan untuk jalan yang sudah tidak ada, atau untuk tempat yang bukan jalan.
403	`PERMISSION_DENIED`	Permintaan yang tidak terdaftar diblokir. Lakukan pendaftaran menggunakan Google Developers Console.	Permintaan ditolak karena satu atau beberapa alasan berikut: Kunci API tidak ada atau tidak valid. Penagihan belum diaktifkan di akun Anda. Batas penggunaan yang ditentukan sendiri telah terlampaui. Metode pembayaran yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku). Untuk menggunakan produk Google Maps Platform, penagihan harus diaktifkan di akun Anda, dan semua permintaan harus menyertakan kunci API yang valid. Untuk memperbaikinya, lakukan langkah-langkah berikut: Mendapatkan kunci API Aktifkan penagihan di akun Anda. Sesuaikan batas penggunaan Anda untuk meningkatkan batas harian (jika berlaku).
404	`NOT_FOUND`	HTTPS diperlukan untuk layanan ini.	Pastikan Anda mengirim permintaan ke `https://roads.googleapis.com/`, bukan `http://roads.googleapis.com/`.
429	`RESOURCE_EXHAUSTED`	Permintaan tersebut di-throttle karena batas permintaan project tercapai.	Anda telah melampaui batas permintaan yang dikonfigurasi di Google Cloud Platform Console. Batas ini biasanya ditetapkan sebagai permintaan per hari, permintaan per 100 detik, dan permintaan per 100 detik per pengguna. Batas ini harus dikonfigurasi untuk mencegah satu atau sekelompok kecil pengguna menghabiskan kuota harian Anda, sambil tetap mengizinkan akses yang wajar untuk semua pengguna. Lihat Membatasi Penggunaan API untuk mengonfigurasi batas ini.

Backoff eksponensial

Jika permintaan gagal, pastikan Anda mencoba lagi permintaan dengan backoff eksponensial. Misalnya, jika permintaan gagal satu kali, coba lagi setelah satu detik, jika gagal lagi, coba lagi setelah dua detik, lalu empat detik, dan seterusnya. Hal ini memastikan bahwa permintaan yang rusak atau kegagalan skala luas tidak membanjiri server Google, karena banyak klien mencoba untuk mencoba kembali permintaan dengan sangat cepat.

FAQ Pemecahan Masalah

Masalah penerapan

Seberapa sering saya harus mengambil sampel lokasi kendaraan saya?: Setiap 1-10 detik direkomendasikan untuk hasil snap-to-road berkualitas tinggi.
Apakah ada batas jumlah poin yang dapat saya kirim per kueri?: Ya, kueri dapat memiliki maksimal 100 poin.
Tingkat presisi apa yang harus saya gunakan untuk menyimpan pasangan garis lintang/bujur yang ditangkap?: Untuk memastikan jalur yang diikuti mengikuti jalan di semua tingkat zoom, bahkan pada tingkat zoom maksimum, Anda harus menyimpan pasangan garis lintang/garis bujur yang telah diikat pada 7 titik presisi desimal.
Bisakah saya menggunakan polyline yang dienkode untuk menampilkan jalur yang diikat?: Polyline yang dienkode hanya ditentukan dengan presisi 5 tempat desimal, yang menghasilkan error sekitar 2 meter. Polyline yang dienkodekan dengan demikian tidak cocok jika Anda ingin jalur yang diikat untuk mengikuti jalan pada tingkat zoom tinggi.

Masalah umum

Beberapa titik tidak diambil, atau saya memiliki celah di jalur yang diikat. Bagaimana cara memperbaikinya?

Jika Anda mengambil sampel titik pada interval waktu, pastikan poin Anda diambil sampelnya dengan interval yang lebih pendek (setiap 1-10 detik). Jika interval yang lebih lama digunakan (misalnya 60 detik), algoritme snap-to-road mungkin tidak dapat menentukan jalan yang ditempuh dengan akurasi yang memadai.
Jika Anda mengklik peta untuk membuat titik secara manual, sangat mudah untuk membuat jalur dengan beberapa titik atau titik renggang yang tidak ditangani dengan baik oleh algoritme snap. Algoritme snap paling cocok untuk titik-titik yang berdekatan. Coba demo Snap to Roads atau gunakan Roads inspector untuk menguji jalur Anda.

Mengapa jalur yang diikat tidak rata atau sedikit menjauh dari jalan saat saya memperbesarnya?

Apakah Anda memotong presisi pasangan garis lintang/bujur yang diikat sebelum menampilkannya? Menyimpan pasangan garis lintang/bujur yang ditangkap dengan presisi kurang dari 7 titik desimal akan menyebabkan error presisi saat jalur yang dipaskan ditampilkan di peta.
Apakah Anda menggunakan polyline yang dienkode? Polyline yang dienkode dienkode memotong pasangan garis lintang/bujur menjadi 5 tempat desimal, yang memunculkan error beberapa meter, sehingga menghasilkan garis yang bergerigi atau sedikit menjauh dari jalan pada tingkat zoom tinggi.

Jika tidak satu pun dari hal di atas terjadi, ubin peta mungkin telah diperbarui baru-baru ini, menyebabkannya tidak sinkron dengan indeks jalan yang digunakan untuk snap. Jika hanya beberapa kueri Anda yang terpengaruh, hal ini mungkin menjadi penyebabnya. Karena Google Maps diupdate secara berkala, hal ini dapat terjadi sesekali, dan dapat terjadi lebih sering jika Anda secara rutin melihat jalur lama di peta (misalnya, jalur yang diikat beberapa minggu yang lalu). Untuk visualisasi yang optimal, Anda harus mengambil ulang jalur lama sebelum menampilkannya di peta, untuk meminimalkan inkonsistensi antara ubin peta dan indeks jalan yang digunakan untuk snap.

Apa yang dapat menyebabkan batas kecepatan untuk jalan X ditampilkan dengan tidak benar?

Batas kecepatan berasal dari berbagai sumber dengan akurasi dan cakupan yang berbeda-beda. Jika Anda menemukan pola, misalnya batas kecepatan untuk jenis jalan tertentu atau di area tertentu yang terus-menerus salah, lakukan langkah-langkah berikut untuk memberi tahu kami:

Buka Google Maps di komputer desktop ATAU aplikasi Google Maps untuk Android.
Buka menu di sisi kiri.
Pilih Kirim masukan. Catatan: Anda mungkin diminta untuk masuk.
Pilih Edit peta.
Pilih segmen jalan yang ingin Anda edit.
Pilih Berikutnya.
Di kolom "Lainnya", tunjukkan bahwa batas kecepatan untuk jalan tersebut salah.
Pilih Kirim.

Anda juga dapat melaporkan masalah lain di sini (misalnya jika nama jalan salah, gambar salah, ditutup, atau bersifat pribadi).

Mengapa jalur yang diliput saya terpotong, bukan mengikuti jalan?

Untuk memperbaiki masalah ini, periksa hal berikut:

Pastikan parameter interpolate disetel ke true.
Pastikan sampel titik data asli Anda diambil pada interval yang cukup dekat (setiap 1-10 detik).

Mengapa saya mendapatkan banyak segmen jalan yang dikembalikan di jalur yang diikat untuk jalan tanpa perubahan batas kecepatan?

Jika parameter interpolate disetel ke true, kueri snap-to-road akan menampilkan polyline yang mengikuti jalan di sekitar sudut, kurva, dan bundaran. Jika tikungan jalan, beberapa segmen jalan akan dikembalikan sekalipun batas kecepatan tidak berubah, untuk membuat polyline yang mengikuti geometri jalan tersebut.