FAQ

Memulai

Memahami Ketentuan Layanan

Batas penggunaan dan penagihan

Menggunakan Google Maps APIs

Layanan Google Maps APIs

Google Maps SDK for iOS

Memulai

Apa yang dimaksud dengan Google Maps APIs?

Google Maps APIs memberi sejumlah cara kepada developer untuk menyematkan Google Maps ke dalam laman web atau mengambil data dari Google Maps, dan memungkinkan penggunaan sederhana atau penyesuaian yang ekstensif. Ada sejumlah penawaran API:

Web API:

Web Service API:

Mobile API:

Bergantung pada kebutuhan, Anda boleh menggunakan salah satu atau kombinasi dari API ini.

Jika Anda mengoperasikan situs web komersial atau perusahaan, mungkin Anda juga tertarik dengan Google Maps APIs Premium Plan.

API mana yang saya butuhkan?

Untuk bantuan dalam menemukan API yang tepat berdasarkan kebutuhan fungsional Anda, lihat API-picker.

Negara apa saja yang didukung oleh Google Maps APIs?

Tim Google Maps terus mendorong data peta baru dan meningkatkan cakupan internasional kami. Periksa data cakupan Google Maps untuk informasi cakupan terbaru. Anda bisa memfilter data dengan kotak filter di bagian atas laman. Perhatikan, data cakupan bisa berubah jika perjanjian lisensi dengan penyedia data berubah.

Lihat juga:

Bisakah saya memasang Google Maps di situs saya tanpa menggunakan Google Maps APIs?

Ya. Google Maps sekarang menawarkan kemampuan untuk menyematkan peta yang Anda tampilkan pada situs web atau blog Anda, tanpa pemrograman atau penggunaan Google Maps APIs. Informasi selengkapnya tersedia di sini.

Bagaimana cara menggunakan aplikasi Maps pada perangkat seluler?

Untuk memasukkan peta dalam aplikasi Android, gunakan Google Maps Android API.

Untuk memasukkan peta dalam aplikasi asli iOS, gunakan Google Maps SDK for iOS.

Google Maps JavaScript API dikembangkan untuk melayani perangkat seluler, dan cocok untuk aplikasi browser yang ditujukan untuk desktop dan perangkat yang menyertakan browser web dengan implementasi JavaScript lengkap, seperti Apple iPhone.

Untuk aplikasi yang ditarget pada perangkat yang tidak cocok untuk menggunakan JavaScript API, Google Static Maps API akan mengirimkan gambar peta dalam format GIF, JPG dan PNG, termasuk marker dan polyline. Perhatikan, penggunaan Google Static Maps API di luar aplikasi yang berbasis browser mengharuskan gambar peta ditautkan ke Google Maps.

Bisakah saya mencetak peta dari JavaScript API?

Mencetak dari JavaScript API tidak didukung. Hal ini karena dukungan pencetakan tidak konsisten di seluruh browser yang umum digunakan. Kami menyarankan penggunaan Static Maps API untuk keperluan pencetakan.

Bagaimana cara memulai penggunaan Google Maps APIs di situs saya?

Lihat dokumentasi Maps JavaScript API untuk contoh dan detailnya.

Bagaimana agar saya diberi tahu bila ada perubahan dalam Google Maps APIs?

Anda harus berlangganan Google Geo Developers Blog untuk kabar berita mengenai berbagai penawaran developer Google Geo.

Memahami Ketentuan Layanan

Apa saja Ketentuan Layanan untuk Google Maps APIs?

Ketentuan Layanan untuk Google Maps APIs tersedia di:

https://developers.google.com/maps/terms

Jika Anda pelanggan Google Maps APIs Premium Plan, lihat perjanjian Anda untuk ketentuan yang mengatur penggunaan Google Maps APIs.

Apakah situs saya memenuhi Ketentuan Layanan untuk Google Maps APIs?

Maps API tersedia untuk semua situs yang bisa diakses oleh konsumen tanpa biaya. Anda bisa menggunakan Google Maps APIs di situs web komersial maupun nirlaba selama situs Anda memenuhi Ketentuan Layanan.

Akan tetapi, ada beberapa penggunaan Google Maps APIs yang tidak ingin kami lihat: peta yang mengidentifikasi tempat untuk membeli obat-obatan ilegal di sebuah kota, misalnya, atau aktivitas ilegal lainnya. Kami juga menghormati privasi orang, sehingga Google Maps APIs tidak boleh digunakan untuk mengidentifikasi informasi pribadi mengenai seseorang.

Anda harus menggunakan pertimbangan sendiri untuk menentukan apakah aplikasi sesuai dengan Ketentuan Layanan sebelum mengembangkan dan meluncurkannya. Teknisi Google hanya bisa menawarkan bantuan teknis dan tidak memenuhi syarat untuk menawarkan nasihat hukum. Google berhak menangguhkan atau menghentikan penggunaan layanan kapan saja, jadi bacalah Ketentuan Layanan dengan cermat.

Jika Anda mengoperasikan situs web komersial atau perusahaan, mungkin Anda juga tertarik dengan Google Maps APIs Premium Plan yang memiliki ketentuan penggunaan yang telah diubah sehingga mungkin lebih sesuai dengan kebutuhan Anda.

Bisakah saya mengakses gambar Maps dan Satellite secara langsung?

Anda tidak boleh mengakses gambar peta atau satelit melalui mekanisme selain Google Maps APIs (seperti pembuatan API pemetaan sendiri atau penggunaan skrip pengunduhan petak secara massal). Akses aplikasi Anda terhadap petak tersebut akan diblokir jika mengaksesnya di luar Google Maps APIs. Lihat bagian 10.1.a tentang Ketentuan Layanan Google Maps untuk detail selengkapnya.

Bisakah saya menggunakan Google Maps APIs pada situs web komersial?

Selama situs Anda secara umum bisa diakses oleh konsumen tanpa biaya, Anda bisa menggunakan Google Maps APIs. Misalnya, jika situs web Anda didukung oleh iklan, maka kemungkinan besar diatur oleh Ketentuan Layanan Google Maps APIs. Jika Anda menarik biaya dari orang-orang untuk menempatkan informasi pada peta Anda (mis. mencantumkan rumah mereka untuk dijual), tetapi Anda menampilkan informasi ini menggunakan Google Maps APIs di bagian yang gratis dari situs Anda, maka Anda juga memenuhi Ketentuan Layanan Google Maps APIs.

Akan tetapi, tidak semua penggunaan komersial diperbolehkan. Misalnya, jika situs Anda memenuhi salah satu kriteria berikut, Anda harus membeli lisensi Google Maps APIs Premium Plan yang sesuai:

  • Situs Anda hanya tersedia untuk pelanggan yang membayar.
  • Situs Anda hanya bisa diakses di dalam perusahaan atau pada intranet Anda.
  • Aplikasi Anda berhubungan dengan penugasan perusahaan, manajemen armada, pelacakan aset bisnis, atau aplikasi serupa.

Ingat, Google berhak menangguhkan atau menghentikan penggunaan Google Maps APIs kapan saja, jadi pastikan Anda membaca Ketentuan Layanan dengan cermat.

Bisakah saya menggunakan Google Maps APIs untuk aplikasi pelacakan?

Tidak ada pembatasan dalam menampilkan data real-time (pelacakan) dengan Google Maps APIs asalkan aplikasi tersebut tersedia untuk umum tanpa biaya dan sesuai dengan Ketentuan Layanan. Untuk aplikasi khusus internal, Google Maps APIs Premium Plan harus digunakan. Lihat Bagian 10.4 Ketentuan Layanan untuk informasi selengkapnya.

Bisakah saya menggunakan Google Maps API dalam aplikasi non-Web?

Ya, Google Maps APIs sekarang bisa digunakan dalam aplikasi desktop, asalkan mematuhi pembatasan lain dari Ketentuan Layanan. Perhatikan, agar aplikasi desktop dianggap "bisa diakses umum", maka harus ada laman web yang bisa diakses oleh masyarakat umum untuk mengunduh aplikasi. Lihat Bagian 9.1 Ketentuan Layanan untuk informasi selengkapnya.

Google Maps JavaScript API hanya didukung bila dijalankan dalam salah satu browser yang didukung.

Bisakah saya menggunakan Google Maps APIs pada situs yang dilindungi sandi?

Ya, tentu saja, namun Anda harus memperhatikan Ketentuan Layanan sebelum menggunakan Google Maps APIs di situs web yang dilindungi sandi. Jika konsumen bisa dengan mudah mendaftar untuk mendapatkan kata sandi tanpa biaya atau jika tujuan peta dilindungi kata sandi adalah untuk meningkatkan ketersediaan peta untuk umum (mis. administrasi), maka situs Anda kemungkinan memenuhi Ketentuan Layanan. Jika tidak demikian, maka Anda perlu menggunakan Google Maps APIs Premium Plan.

Bisakah saya menggunakan tangkapan layar dari aplikasi Google Maps APIs dalam material cetak atau media offline?

Penggunaan gambar Google Maps dalam materi cetak dan media offline tunduk pada Panduan Izin yang dipublikasikan di:

http://www.google.com/permissions/geoguidelines.html

Untuk informasi selengkapnya tentang pencetakan, lihat Bisakah saya mencetak peta dari JavaScript API?

Bagaimana cara berhenti dari menyertakan materi saya dalam hasil penelusuran Google?

Kami tidak lagi mengumpulkan data ini. Penggunaan parameter indexing sudah tidak digunakan lagi dan tidak berpengaruh. Anda tidak perlu lagi memilih keluar secara eksplisit, namun kami menganjurkan Anda membuang parameter ini demi kenyamanan Anda.

Untuk membuang laman atau situs Anda dari hasil penelusuran, ikuti petunjuk yang diberikan di pusat bantuan webmaster kami.

Jika Anda menggunakan ID klien dengan lisensi Google Maps APIs Premium Plan, Anda bisa menggunakan opsi berikut untuk membuang tautan dari logo Google yang ditampilkan pada peta. Anda harus membatasi penggunaan opsi ini bila tautan logo tersebut menimbulkan pengalaman pengguna yang negatif. (Contoh aplikasi seluler dengan tampilan layar penuh yang bila pengguna mengeklik logo akan membawanya meninggalkan materi asal aplikasi, tanpa ada cara untuk kembali.) Anda harus memastikan bahwa logo dan pemberitahuan hak cipta tidak disembunyikan atau tertutupi.

map.setOptions({passiveLogo: true});

Logo tetap terlihat namun tidak bisa diklik.

Opsi ini tersedia secara default pada semua pelanggan Premium Plan yang menggunakan ID klien. Jika tidak berfungsi, hubungi Dukungan Premium Plan.

Informasi apa yang dikirim ke Google ketika saya menggunakan Maps JavaScript API?

Saat menggunakan Maps JavaScript API, informasi berikut ini dikirimkan ke Google:

  • Ukuran peta dan lokasi untuk mengambil petak peta serta hak cipta
  • Alamat untuk geocoding
  • Permintaan Arah dan Elevasi
  • Lokasi sekitar untuk penelusuran Tempat
  • KML saat menggunakan KmlLayer
Bisakah saya membuat gambar peta dengan menggunakan Google Static Maps API yang saya simpan dan jalankan dari situs web saya?

Anda tidak boleh menyimpan dan memberikan salinan gambar yang dibuat menggunakan Google Static Maps API dari situs web Anda. Semua laman web yang memerlukan gambar statis harus menautkan atribut src dari img HTML atau atribut background-image CSS dari tag div HTML secara langsung ke Google Static Maps API agar semua gambar peta ditampilkan dalam materi HTML laman web dan diberikan langsung kepada pengguna akhir oleh Google.

Batas penggunaan dan penagihan

Google Maps APIs manakah yang memiliki batas penggunaan?

Google Maps APIs tersedia gratis untuk berbagai kasus penggunaan, dengan batas penggunaan gratis dan harga kelebihan yang bisa diprediksi untuk penggunaan API standar, dan kontrak tahunan tersedia untuk implementasi di perusahaan.

API berikut ini tidak memiliki batas penggunaan:

Batas penggunaan berlaku untuk Maps API berikut ini. Klik API untuk menampilkan detail batas penggunaannya:

Maps API harus digunakan sesuai dengan Ketentuan Layanan standar.

Berapa batas penggunaan untuk Google Maps APIs?

Kebanyakan Google Maps APIs memiliki kuota per hari gratis yang bisa disetel dalam Google API Console. Kueri default dan maksimum harian berbeda-beda bergantung API. Anda bisa meningkatkan batas harian gratis dengan mengaktifkan penagihan, atau membeli lisensi Google Maps APIs Premium Plan.

  • Web Service API:

    Google Maps Web Service API menyertakan permintaan per hari gratis 2.500, yang dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server Anda. Untuk mengakses kuota harian yang lebih tinggi (hingga 100.000 per hari), kami menawarkan harga pay-as-you-go.

    untuk menyertakan ke pay-as-you-go.

  • Web API:

    Google Maps JavaScript API, Google Static Maps API, dan Google Street View Image API memiliki batas harian gratis sebesar 25.000 pemuatan peta per hari. Untuk mengakses kuota harian yang lebih tinggi (hingga 100.000 per hari), kami menawarkan harga pay-as-you-go.

    Jika situs web Anda melebihi 25.000 pemuatan peta dalam sehari, API akan berhenti berfungsi untuk sisa waktu hari itu, kecuali jika Anda mengaktifkan penagihan untuk membayar kelebihan penggunaan tersebut.

    Dalam hal tertentu, mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Lihat pertanyaan spesifik untuk definisi yang akurat tentang:

Catatan: Aplikasi yang dianggap untuk kepentingan umum (seperti yang ditentukan oleh Google dalam kebijakannya) tidak dikenakan batas penggunaan ini. Misalnya:

  • Peta penanggulangan bencana biasanya tidak tunduk pada batas penggunaan ini sekalipun dikembangkan dan/atau di-host oleh lembaga komersial. Organisasi tanggap darurat dapat memohon peningkatan batas kuota. Ketahui selengkapnya dan terapkan.
  • Organisasi nirlaba yang memenuhi syarat dan menunjukkan kebutuhan untuk meningkatkan batas geocoding atau penggunaan internal Google Maps APIs dapat memohon lisensi Google Maps APIs Premium Plan melalui program hibah Google Earth Outreach.
  • Organisasi media berita yang memenuhi syarat yang menggunakan Standard Plan dapat memohon peningkatan batas kuota. Ketahui selengkapnya dan terapkan.

Bagaimana penghitungan penggunaan kuota?

Penghitungan penggunaan kuota bervariasi menurut API. Web Service API menggunakan permintaan (perhatikan, Google Maps Distance Matrix API menggunakan elemen). Web API menggunakan Pemuatan Peta untuk menghitung penggunaan kuota.

Untuk Google Maps Distance Matrix API, setiap kueri yang dikirim ke API dibatasi oleh jumlah elemen yang diperbolehkan, dengan jumlah asal dikali jumlah tujuan untuk mendefinisikan jumlah elemen.

Ada dua tipe kuota yang membatasi penggunaan layanan web Google Maps APIs: jangka panjang (kuota per hari) dan jangka pendek (kuota kecepatan permintaan). Batas penggunaan ini berlaku bila permintaan dibuat di sisi-server, lewat Maps Web Services API, atau sisi-klien, lewat layanan JavaScript untuk Directions, Distance Matrix, Elevation, atau Geocoding.

Catatan: Mungkin ada juga batas tambahan yang disetel di API. Misalnya, Elevation API memiliki batas lokasi per permintaan. Dan, selain kuota per hari, Image API menyertakan resolusi gambar maksimum. Tampilkan laman batas penggunaan setiap Google Maps APIs untuk detailnya.

Bagaimana pemuatan peta dibebankan pada batas penggunaan untuk Google Maps APIs for Web?

Satu pemuatan peta tunggal dikenakan biaya bila terjadi salah satu dari berikut ini:

  • Sebuah laman web atau aplikasi menampilkan peta menggunakan Google Maps JavaScript API.
  • Sebuah laman web atau aplikasi menampilkan panorama Google Street View Image API menggunakan Google Maps JavaScript API. Jika panorama Street View menggantikan peta dalam elemen div yang sama, panorama tersebut tidak dikenakan biaya.
  • Sebuah aplikasi meminta gambar peta tunggal dari Google Static Maps API.
  • Sebuah aplikasi meminta gambar panorama tunggal dari Google Street View Image API.

Setelah laman web atau aplikasi memuat peta, gambar peta statis, atau panorama Street View, semua pengguna yang berinteraksi dengannya, misalnya menggeser, memperbesar atau memperkecil, atau beralih layer peta, tidak akan menghasilkan pemuatan peta tambahan atau memengaruhi batas penggunaan.

Aplikasi Google Maps APIs Premium Plan menghabiskan kuota dalam artian Kredit Maps API. Lihat Biaya dan Batas Penggunaan Premium Plan untuk informasi selengkapnya.

Bagaimana memantau penggunaan kuota saya?

Anda bisa memantau penggunaan kuota API secara terpisah dalam Google API Console.

  1. Pilih proyek berisi API yang ingin Anda tinjau.
  2. Dari daftar API di Dasbor, klik nama API tersebut.
  3. Dekat bagian atas laman, klik Quotas atau Usage.

Catatan: Untuk melihat laporan lalu lintas dan informasi penagihan untuk keseluruhan proyek, aktifkan penagihan terlebih dahulu.

Apa yang terjadi jika saya melebihi batas penggunaan?

Jika Anda melebihi batas penggunaan Maps API yang diberikan, API akan mengembalikan pesan kesalahan. Jika Anda berulang kali melebihi batas, akses Anda terhadap API bisa diblokir untuk sementara.

  • Web Service API

    Untuk layanan web Google Maps APIs ada dua tipe kuota yang membatasi penggunaan: jangka panjang (kuota per hari) dan jangka pendek (kuota kecepatan permintaan). Jika Anda melebihi batas penggunaan atau menyalahgunakan layanan, maka layanan web akan mengembalikan pesan kesalahan tertentu. Jika Anda berulang kali melebihi batas, akses Anda terhadap layanan web bisa diblokir.

    Anda bisa melebihi batas penggunaan untuk layanan web Google Maps APIs dengan:

    • Mengirimkan terlalu banyak permintaan per hari.
    • Mengirimkan permintaan terlalu cepat, yaitu terlalu banyak permintaan per detik.
    • Mengirimkan permintaan terlalu cepat dalam waktu yang terlalu lama atau menyalahgunakan layanan web.
    • Melebihi batas penggunaan lain, misalnya lokasi per permintaan dalam Elevation API.

    Catatan: Empat dari Web Service API memiliki layanan sisi-klien setara yang tersedia dalam JavaScript API: Directions, Distance Matrix, Elevation, dan Geocoding.

    Semua batas penggunaan, jangka panjang dan jangka pendek, digunakan bersama oleh layanan, baik permintaan tersebut dibuat pada sisi-klien maupun sisi-server. Misalnya, kuota harian gratis untuk layanan web telah disetel pada 2.500 permintaan per hari, yang digunakan bersama oleh layanan sisi-klien dan permintaan sisi-server. Jika Anda menggunakan layanan JavaScript API Directions untuk membuat 1.500 permintaan per hari, dan Anda juga menggunakan Google Maps Directions API sisi-server untuk membuat 2.000 permintaan per hari, berarti permintaan Directions Anda akan menjadi 3.500 dalam sehari, sehingga melebihi kuota harian gratis sebanyak 1.000 permintaan.

  • Web API

    Web API adalah Google Maps JavaScript API v3, Google Static Maps API, dan Google Street View Image API, masing-masing dengan batas 25.000 pemuatan peta per hari gratis.

    Untuk sebagian pelanggan, mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Melebihi batas penggunaan

Jika melebihi batas penggunaan, Anda akan mendapatkan kode status OVER_QUERY_LIMIT sebagai respons.

Ini berarti layanan web akan berhenti merespons secara normal dan beralih hanya mengembalikan kode status OVER_QUERY_LIMIT hingga penggunaan berlebih diperbolehkan lagi. Ini bisa terjadi:

  • Dalam beberapa detik, jika diterima kesalahan karena aplikasi Anda mengirimkan terlalu banyak permintaan per detik.
  • Dalam waktu 24 jam berikutnya, jika diterima kesalahan karena aplikasi Anda mengirimkan terlalu banyak permintaan per hari. Kuota harian direset tengah malam, Waktu Pasifik.

Jika Anda terus menerus melebihi batas penggunaan per hari, pertimbangkan:

Situs saya mendapatkan banyak lalu lintas. Bisakah saya menggunakan Maps API?

Ya. Akan tetapi kami menyarankan agar Anda membiasakan diri dengan batas penggunaan untuk setiap Google Maps APIs yang digunakan aplikasi Anda.

Haruskah saya membeli Google Maps APIs Premium Plan?

Anda harus membeli Google Maps APIs Premium Plan jika bisnis atau organisasi Anda memerlukan salah satu dari berikut ini:

  • SLA dengan dukungan teknis 24 jam
  • Kemampuan untuk menjual produk atau layanan dengan Google Maps yang telah disematkan
  • Kemampuan untuk menggunakan Google Maps APIs untuk aplikasi atau situs web internal
  • Jumlah kuota tertentu
  • Kemampuan menggunakan Google Maps APIs (tidak termasuk Places API) untuk aplikasi pelacakan aset
  • Fitur Premium Plan tersedia bersama lisensi Maps APIs for Work Anda yang ada

Bagaimana cara membeli Google Maps APIs Premium Plan?

Hubungi petugas penjualan Google untuk detail tentang pembelian Google Maps APIs Premium Plan dan untuk menerima penawaran harga berdasarkan perkiraan penggunaan aplikasi Anda.

  • Web Service API

    Jika Anda menggunakan Web Service API, kami memperbolehkan 2.500 permintaan per hari gratis, yang dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server. Jika Anda melebihi kuota gratis, Anda memiliki akses ke kuota pay-as-you-go (prabayar) hingga 100.000 permintaan per hari, jika Anda mendaftar penagihan otomatis.

  • Web API

    Jika Anda menggunakan Google Maps Web API (Maps JavaScript API, Static Maps API, atau Street View Image API), kami memperbolehkan 25.000 pemuatan peta per hari, gratis. Jika Anda melebihi kuota gratis, Anda memiliki akses ke kuota pay-as-you-go (prabayar) hingga 100.000 pemuatan peta per hari, jika Anda mendaftar penagihan otomatis.

    Dalam hal tertentu, mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Jika Anda melebihi kuota harian gratis dan penagihan tidak diaktifkan, API akan berhenti berfungsi untuk sisa waktu hari itu.

Bagaimana cara penghitungan dan penagihan kelebihan penggunaan?

Kelebihan penggunaan atas kuota gratis untuk setiap layanan Maps API dihitung pada akhir setiap hari.

  • Web Service API

    Web Service API menawarkan 2.500 permintaan per hari gratis, yang dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server Anda. Jika Anda mengaktifkan penagihan untuk mengakses kuota yang lebih tinggi, begitu Anda melebihi 2.500 permintaan per hari, Anda dikenakan $0,50 USD / 1.000 permintaan tambahan, hingga 100.000 per hari.

  • Web API

    Google Maps Web API (Maps JavaScript API, Static Maps API, atau Street View Image API) menawarkan 25.000 pemuatan peta per hari, gratis. Jika Anda mengaktifkan penagihan untuk mengakses kuota yang lebih tinggi, Anda akan ditagih $0,50 USD per 1.000 pemuatan peta dengan batas harian 25.000, hingga maksimum 100.000 pemuatan peta harian.

    Dalam hal tertentu, mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Ketahui selengkapnya tentang apa yang terjadi jika Anda melebihi batas penggunaan.

Jika memilih untuk mengaktifkan penagihan Anda perlu menyediakan detail kartu kredit. Kelebihan penggunaan Anda akan tetap dihitung di setiap akhir hari, dan jumlahnya ditagihkan ke kartu kredit yang diberikan di setiap akhir bulan, dengan harga yang tercantum di bawah ini.

Berapa biaya untuk menggunakan Google Maps APIs?

Aplikasi yang menghasilkan permintaan atau volume pemuatan peta di bawah batas penggunaan bisa menggunakan Google Maps APIs tanpa biaya asalkan aplikasi tersebut memenuhi persyaratan Ketentuan Layanan Google Maps APIs.

Untuk Web Service API, jika layanan Maps API Anda melebihi batas penggunaan harian, dan Anda memilih untuk membeli kuota tambahan secara online menggunakan Google API Console, kelebihan penggunaan Anda akan dikenakan biaya dengan harga yang ditampilkan di bawah ini untuk layanan yang bersangkutan. Penggunaan harian dilacak per proyek dan dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server Anda.

Untuk Google Maps JavaScript API v3, Google Static Maps API, dan Google Street View Image API, jika penggunaan layanan Maps API Anda melebihi batas penggunaan harian dan Anda memilih untuk membeli pemuatan peta tambahan secara online menggunakan Google API Console, kelebihan penggunaan Anda akan dikenakan biaya dengan harga yang ditampilkan di bawah ini untuk layanan yang bersangkutan. Penggunaan harian dilacak per proyek.

Perhatikan, jika situs Anda secara konsisten menghasilkan volume permintaan atau pemuatan peta per hari yang tinggi maka lisensi Google Maps APIs Premium Plan mungkin lebih hemat biaya. Kami sarankan Anda menghubungi tim Penjualan Google Maps APIs Premium Plan untuk informasi selengkapnya.

Web Service API Batas gratis
(per hari)
1000 kelebihan permintaan
(dalam dolar A.S.)
Directions API + layanan sisi-klien Directions 2.500 2 $0,50
Distance Matrix API + layanan sisi-klien Distance Matrix 1 2.500 2 $0,50
Elevation API + layanan sisi-klien Elevation 2.500 2 $0,50
Geocoding API + layanan sisi-klien Geocoding 2.500 2 $0,50
Geolocation API 2.500 $0,50
Roads API 2.500 $0,50
Time Zone API 2.500 $0,50
1 Google Maps Distance Matrix API dan penggunaan layanan sisi-klien Distance Matrix diukur dalam jumlah elemen per hari.
2 Kuota harian gratis dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server.
Web API Batas gratis
(per hari)
1000 kelebihan pemuatan peta
(dalam dolar A.S.)
Google Maps JavaScript API 25.000* $0,50
Google Static Maps API 25.000* $0,50
Google Street View Image API 25.000* $0,50
* Mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Perhatikan, pembelian kuota tambahan secara online tidak memberi hak atau manfaat tambahan selain hak untuk terus menggunakan berdasarkan Ketentuan Layanan Google Maps APIs yang ada.

Apakah penentuan harga tersedia dalam mata uang lain?

Penentuan harga saat ini hanya tersedia dalam dolar A.S.

Saya telah mengaktifkan penagihan. Bagaimana cara menampilkan tagihan saya?

Google akan menagih Anda setiap awal bulan untuk aktivitas bulan sebelumnya, dengan menggunakan metode pembayaran yang ditetapkan.

Bagaimana cara menghindari tagihan besar jika penggunaan saya meningkat secara tak terduga?

Google Maps APIs menyediakan kuota harian gratis dan menyetel batas maksimum tagihan harian. Anda bisa mengatur batas penggunaan maksimum harian untuk melindungi dari peningkatan tak terduga. Anda juga bisa menyetel peringatan penagihan untuk menerima notifikasi email bila biaya pada akun penagihan mencapai ambang yang Anda tetapkan.

Mengatur batas maksimum tagihan harian:

  • Untuk Web Service API:

    Web Service API standar mendukung hingga 100.000 permintaan atau elemen per hari. Proyek akan dibatasi 2.500 per hari gratis hingga Anda mengaktifkan penagihan pada proyek ini. Begitu penagihan diaktifkan, jika Anda melebihi 2.500 permintaan dalam sehari, Anda akan dikenakan $0,50 USD / 1.000 permintaan tambahan, hingga 100.000 per hari. Perhatikan, penggunaan dihitung sebagai jumlah permintaan sisi-klien (yang dibuat melalui layanan Google Maps JavaScript API) dan permintaan sisi-server Anda.

    Untuk menghindari tagihan besar, Anda bisa menetapkan batas maksimum penggunaan per hari untuk melindungi dari peningkatan penggunaan tak terduga. Saat ini, default batas maksimum tagihan hingga 100.000 permintaan per hari. Anda bisa mengubah batas ini di Google API Console. Pada laman Quotas di API, klik ikon edit di sebelah kuota "requests per day".

    Catatan: Jika penggunaan API Anda mencapai batas tagihan pada hari yang ditentukan, aplikasi Anda tidak akan bisa mengakses API untuk sisa hari itu. Dapatkan detail selengkapnya tentang apa yang terjadi jika Anda melebihi batas penggunaan.

  • Untuk Web API:

    Untuk Google Maps JavaScript API v3, Google Static Maps API, dan Google Street View Image API, jika penggunaan Google Maps Web API standar Anda melebihi batas penggunaan gratis, Anda bisa membeli pemuatan peta tambahan secara online dengan mengaktifkan penagihan pada proyek ini. Begitu penagihan diaktifkan, jika Anda melebihi batas penggunaan gratis, Anda akan dikenakan $0,50 USD / 1000 permintaan tambahan, hingga 100.000 setiap hari.

    Untuk menghindari tagihan besar, Anda bisa menetapkan batas maksimum penggunaan per hari untuk melindungi dari peningkatan penggunaan tak terduga setelah penagihan dimulai. Saat ini, default batas maksimum tagihan hingga 100.000 permintaan per hari. Anda bisa mengubah batas ini di Google API Console. Pada laman Quotas di API, klik ikon edit di sebelah kuota "requests per day".

    Catatan: Jika penggunaan API Anda mencapai batas tagihan pada hari yang ditentukan, aplikasi Anda tidak akan bisa mengakses API untuk sisa hari itu. Dapatkan detail selengkapnya tentang apa yang terjadi jika Anda melebihi batas penggunaan.

    Catatan: Untuk sebagian pelanggan, mungkin berlaku pengecualian kuota. Ketahui selengkapnya.

Menyetel dan mengelola peringatan penagihan:

Siapkan peringatan penagihan untuk mengirimkan notifikasi email kepada administrator penagihan bila biaya pada akun penagihan mencapai ambang yang telah Anda setel. Administrator penagihan akan dikirimi notifikasi email bila perkiraan biaya pada akun penagihan melebihi 50%, 90%, dan 100% dari ambang.

Saran: Jika situs Anda secara konsisten menghasilkan volume permintaan atau pemuatan peta per hari yang tinggi maka lisensi Google Maps APIs Premium Plan mungkin lebih hemat biaya. Kami sarankan Anda menghubungi tim Penjualan Google Maps APIs Premium Plan untuk informasi selengkapnya.

Mengaktifkan penagihan

Untuk mengaktifkan penagihan dan membuka kuota yang lebih tinggi untuk Google Maps API, kami akan memandu Anda melalui Google Developers Console untuk menyelesaikan beberapa tugas:

  1. Buat atau pilih sebuah proyek
  2. Persiapkan atau pilih profil penagihan Anda
  3. Aktifkan penagihan pada proyek Anda
Lanjutkan

Menggunakan Google Maps APIs

Kunci atau kredensial apa yang harus saya gunakan untuk produk Maps lain?

Setiap kali Anda menggunakan Google Maps APIs Anda harus menyertakan sebuah kunci, atau kredensial lainnya, untuk memvalidasi permintaan. Google Maps APIs tersedia untuk aplikasi Android, iOS, atau Web, dan lewat layanan web HTTP. Tipe kredensial yang diperlukan bervariasi sesuai API, dan apakah Anda memiliki lisensi standar atau premium.

Informasi di bagian ini berlaku untuk pelanggan standard plan dan pelanggan dengan Google Maps APIs Premium Plan baru, yang tersedia pada Januari 2016. Jika Anda memiliki lisensi sebelumnya dari Maps APIs for Work atau Maps API for Business, kredensial yang diperlukan oleh Anda mungkin berbeda dengan yang tercantum di bawah.

  • Kunci API: Kunci API adalah identifier unik yang Anda buat dengan menggunakan Google API Console. Kunci API biasanya digunakan bersama API standar. Pelanggan Premium Plan1 umumnya bisa memilih akan menggunakan ID klien atau kunci API.

    Anda bisa memilih untuk menggunakan kunci API tanpa menerapkan pembatasan (yang disebut “kunci API generik”) atau kunci yang telah dikenakan pembatasan agar lebih aman. API di suatu platform mungkin menggunakan kunci API generik.

    Secara opsional, Anda bisa menambahkan pembatasan (misalnya, alamat IP) ke kunci API. Setelah dibatasi, kunci hanya akan bekerja pada platform yang mendukung tipe pembatasan itu. Tersedia empat tipe pembatasan kunci API:

    • Pembatasan server (melalui alamat IP) - untuk digunakan bersama Web Service API.
    • Pembatasan browser (melalui referrer HTTP) - untuk digunakan bersama Web API.
    • Pembatasan aplikasi Android (melalui nama paket dan sidik jari) - untuk digunakan bersama Android API.
    • Pembatasan aplikasi iOS (melalui identifier bundel iOS) - untuk digunakan bersama iOS API.

    API dengan platform yang sama bisa menggunakan kunci yang sama dibatasi.

    Pelanggan Google Maps APIs Premium Plan dan Google Maps APIs for Work, catatan: Saat membuat kunci di Google API Console, Anda harus memilih proyek yang telah dibuatkan untuk Anda saat mendaftar. Nama proyek dimulai dengan Google Maps APIs for Business or Google Maps for Work or Google Maps.

    Contoh memuat API bersama kunci: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

  • ID Klien: ID klien diberikan kepada Anda saat mendaftar sebagai pelanggan Google Maps APIs Premium Plan atau Google Maps APIs for Work. Pelanggan Premium Plan umumnya bisa memilih akan menggunakan ID klien atau kunci API.

    Contoh memuat API bersama ID klien: &client=gme-companyname

  • Tanda Tangan Digital: Umumnya, tanda tangan digital digunakan oleh pelanggan Google Maps APIs Premium Plan dan Google Maps APIs for Work saat mengautentikasi dengan ID klien. Tanda tangan digital ini dihasilkan menggunakan kunci kriptografik yang disediakan kepada Anda oleh Google. Sebagai tambahan, tanda tangan digital digunakan bersama Google Static Maps API dan Google Street View Image API. Jika Anda menggunakan Google Static Maps API dan Google Street View Image API standar, dan penagihan diaktifkan, tanda tangan digital diperlukan pada pemuatan peta yang melebihi kuota gratis harian.

Tabel di bawah ini menunjukkan kunci/kredensial mana yang harus digunakan bersama setiap produk Maps API. (Seperti disebutkan di atas, tipe pembatasan kunci API adalah: server, browser, Android, dan iOS.)

API Pengguna API Standar: Pengguna Premium Plan1
Google Maps Android API Kunci API dengan pembatasan Android2 Kunci API dengan pembatasan Android2
Google Places API for Android Kunci API dengan pembatasan Android2 tidak tersedia
Google Maps SDK for iOS Kunci API dengan pembatasan iOS2 Kunci API dengan pembatasan iOS2
Google Places API for iOS Kunci API dengan pembatasan iOS2 tidak tersedia
Google Maps JavaScript API Kunci API dengan pembatasan browser2 Kunci API dengan pembatasan browser2
atau
ID Klien
Google Static Maps API Kunci API dengan pembatasan browser2 + opsional3 Tanda Tangan Digital Kunci API dengan pembatasan browser2 + Tanda Tangan Digital
atau
ID Klien + Tanda Tangan Digital
Google Street View Image API Kunci API dengan pembatasan browser2 + opsional2 Tanda Tangan Digital Kunci API dengan pembatasan browser2 + Tanda Tangan Digital
atau
ID Klien + Tanda Tangan Digital
Google Maps Embed API Kunci API dengan pembatasan browser2 tidak tersedia
Google Maps Directions API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
atau
ID Klien + Tanda Tangan Digital
Google Maps Distance Matrix API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
atau
ID Klien + Tanda Tangan Digital
Google Maps Elevation API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
atau
ID Klien + Tanda Tangan Digital
Google Maps Geocoding API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
atau
ID Klien + Tanda Tangan Digital
Google Maps Geolocation API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
Google Maps Roads API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
Google Maps Time Zone API Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
atau
ID Klien + Tanda Tangan Digital
Google Places API Web Service Kunci API dengan pembatasan server2 Kunci API dengan pembatasan server2
1 Premium Plan merujuk pada Google Maps APIs Premium Plan baru, yang tersedia pada Januari 2016. Jika Anda memiliki lisensi sebelumnya dari Maps APIs for Work atau Maps API for Business, kredensial yang diperlukan oleh Anda mungkin berbeda dengan yang tercantum di atas. Ragu mengenai paket mana yang telah dibeli? Pelajari cara memeriksa tipe lisensi Anda.
2 Selama development dan pembuatan prototipe, Anda dapat menggunakan kunci API generik (kunci yang tidak memiliki pembatasan) dengan Maps atau Places API. Sebelum menggunakan kunci API di lingkungan produksi, disarankan agar Anda mengamankan kunci API dengan pembatasan. Pelajari praktik terbaik untuk penggunaan kunci API secara aman.
3 Untuk Google Static Maps API dan Google Street View Image API, jika Anda menggunakan API standar dan mengaktifkan penagihan, jika Anda melebihi kuota harian gratis sebesar 25.000 pemuatan peta, maka diperlukan tanda tangan digital untuk pemuatan peta yang dapat dikenakan biaya.
Bagaimana cara mengubah tipe pembatasan kunci saya dari pembatasan browser ke pembatasan server?

Penting: Jika Anda menggunakan Web Service API dengan kunci API yang memiliki pembatasan referer, permintaan Anda akan gagal dengan pesan kesalahan: "Kunci API tidak bisa memiliki pembatasan referer bila digunakan bersama API ini." Anda harus beralih menggunakan pembatasan server.

Sebelum Anda mengganti tipe pembatasan kunci API dari Browser ke Server, pastikan semua API yang menggunakan kunci API adalah Web Service API. API dengan platform yang sama bisa menggunakan kunci yang sama dibatasi. Jika Anda perlu melayani lebih dari satu platform, tambahkan kunci terpisah dengan pembatasan platform yang diperlukan. Lihat cara menambahkan kunci API baru.

Untuk mengubah kunci API yang dibatasi browser ke kunci yang dibatasi server, lakukan yang berikut ini:

  1. Masuklah ke laman Credential di Google API Console.
  2. Pilih proyek berisi kunci API yang ingin Anda edit.
  3. Pada laman Credentials, dari daftar kunci API, pilih nama kunci API untuk mengedit detail kunci tersebut.
  4. Di bagian Restrictions pada laman tersebut, pilih “IP addresses (web servers, cron jobs, etc.)” dan sisipkan alamat IP server yang sesuai, kemudian klik Save.
Bagaimana cara mendapatkan kunci API baru?

Untuk membuat kunci API baru, lakukan yang berikut ini:

  1. Masuklah ke Google API Console.
  2. Pilih atau buat sebuah proyek.
  3. Untuk menghasilkan kunci API baru, klik tombol Create credentials.
  4. Pilih kunci API dari daftar tipe kredensial.
  5. Kunci baru akan dihasilkan dan ditampilkan di jendela munculan.
  6. Untuk menyetel pembatasan (opsional) kunci yang diinginkan, pilih Restrict key, kemudian ikuti petunjuk pada laman untuk menyetel pembatasan.
  7. Kunci API dicantumkan pada laman kredensial. Perhatikan, kunci dalam daftar dibedakan menurut tipe pembatasan. Kunci API tanpa pembatasan adalah generik dan dapat digunakan bersama sembarang API.

Tetapkan kunci API dalam permintaan Anda

Untuk menetapkan kunci API dalam permintaan Anda, sertakan sebagai nilai parameter kunci.

Contoh:

Untuk Elevation API:

https://maps.googleapis.com/maps/api/elevation/json?locations=39.739,-104.984&key=YOUR_API_KEY

Untuk Geolocation API:

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

Bagaimana cara mengatasi kesalahan: "IP, situs, atau aplikasi seluler ini tidak diizinkan menggunakan kunci API ini."?

Ada berbagai skenario yang bisa menyebabkan kesalahan ini:

  • Anda telah mengaktifkan pembatasan alamat IP (server) pada kunci API, dan sebuah alamat IP yang tidak sah mencoba mengajukan permintaan.
  • Anda telah mengaktifkan pembatasan referrer (browser) HTTP pada kunci API, dan sebuah referrer yang tidak sah mencoba mengajukan permintaan.
  • Anda telah membatasi penggunaan ke aplikasi Android dengan menyetel nama paket dan sidik jari, dan sebuah aplikasi Android yang tidak sah mencoba mengajukan permintaan.
  • Anda telah membatas permintaan dari aplikasi iOS dengan menetapkan identifier bundel dan sebuah aplikasi iOS yang tidak sah berusaha mengajukan permintaan.
  • Ini digunakan agar memungkinkan mengambil kesalahan ini jika Anda menggunakan salah satu Web Service API bersama kunci API yang dibatasi browser. Permintaan ke Web Service API harus diidentifikasi dengan kunci API yang dibatasi server. Ganti tipe pembatasan kunci Anda dari kunci yang dibatasi browser menjadi kunci yang dibatasi server.

Menampilkan dan Mengedit Kredensial Kunci API Anda

Untuk menampilkan kunci API Anda dan mengelola pembatasan, lakukan yang berikut ini:

  1. Masuklah ke Google API Console.
  2. Pilih proyek berisi kunci API yang ingin Anda tinjau.
  3. Untuk menampilkan detail kredensial, termasuk semua pembatasan yang telah disetel untuk kunci ini, dari daftar kunci API, klik nama kunci tersebut.
  4. Kredensial lengkap atas kunci API yang dipilih akan ditampilkan, termasuk segala pembatasan yang dibuatn untuk kunci tersebut. Dari sini, pembatasan bisa diubah, dihapus atau diperbarui bila perlu.

Bagaimana cara mengatasi kesalahan: "Kunci API tidak bisa memiliki pembatasan referer bila digunakan bersama API ini."?

Anda menggunakan salah satu Web Service API bersama kunci API yang dibatasi browser. Karena alasan keamanan, Web Service API perlu menggunakan kunci API yang dibatasi server. Ubah tipe pembatasan kunci Anda dari pembatasan browser ke pembatasan server.

Bagaimana cara mengetahui perubahan yang diperkenalkan dalam setiap versi Google Maps API?

Kami menyimpan daftar perubahan antar versi Google Maps JavaScript API di:

https://developers.google.com/maps/documentation/javascript/releases

Anda juga bisa memeriksa versi Google Maps APIs mana yang terdapat bug tertentu dan bug yang telah diperbaiki dengan menggunakan Google Maps APIs Issue Tracker di:

http://code.google.com/p/gmaps-api-issues/issues/list

Bagaimana cara memuat API ke dalam laman secara asinkron setelah laman dimuat?

Cukup tetapkan parameter callback saat memuat API. Informasi selengkapnya dan kode contoh bisa ditemukan dalam bab Memulai pada dokumentasi Maps JavaScript API.

Bagaimana cara agar Google Maps APIs menampilkan dalam bahasa selain bahasa Inggris?

Secara default API akan berusaha memuat bahasa yang paling sesuai berdasarkan lokasi pengguna atau setelan browser. Sebagian API memungkinkan Anda secara eksplisit menyetel bahasa saat membuat permintaan. Informasi selengkapnya mengenai cara menyetel bahasa tersedia dalam dokumentasi setiap API:

Bahasa Yang Didukung
Kode Bahasa Bahasa Kode Bahasa Bahasa
ar Arab kn Kanada
bg Bulgaria ko Korea
bn Bengali lt Lithuania
ca Katalan lv Latvia
cs Cheska ml Malayalam
da Denmark mr Marathi
de Jerman nl Belanda
el Yunani tidak Norwegia
en Inggris pl Polandia
en-AU Inggris (Australia) pt Portugis
en-GB Inggris (Britania Raya) pt-BR Portugis (Brasil)
es Spanyol pt-PT Portugis (Portugal)
eu Basque ro Rumania
eu Basque ru Rusia
fa Persia sk Slovakia
fi Finlandia sl Slovenia
fil Filipina sr Serbia
fr Prancis sv Swedia
gl Galicia ta Tamil
gu Gujarati te Telugu
hi Hindi th Thai
hr Kroasia tl Tagalog
hu Hungaria tr Turki
id Indonesia uk Ukraina
it Italia vi Vietnam
iw Ibrani zh-CN Mandarin (Sederhana)
ja Jepang zh-TW Mandarin (Tradisional)

Anda bisa melihat wujud peta dalam bahasa Anda di aplikasi contoh ini.

Bisakah Google Maps APIs diakses melalui SSL (HTTPS)?

Layanan web Google Maps JavaScript API, Google Static Maps API, dan Google Maps APIs bisa diakses melalui koneksi aman (HTTPS) oleh developer baik dengan menggunakan versi gratis API ini maupun Google Maps APIs Premium Plan. Lihat dokumentasi API yang terkait untuk informasi cara mengakses API melalui SSL.

Perhatikan, Google Static Maps API tidak mendukung URL ikon khusus yang menggunakan HTTPS; ikon default akan ditampilkan.

Bagaimana cara melaporkan bug atau meminta fitur baru dalam Google Maps APIs?

Jika menemukan perilaku yang Anda yakini sebagai bug, mulailah mengungkapkannya di forum yang relevan. Ini memungkinkan developer lain memvalidasi bug tersebut, dan menghilangkan setiap potensi masalah dari kode Anda.

Jika Anda ingin meminta sebuah fitur, ungkapkan juga terlebih dahulu dalam forum yang relevan untuk memastikan bahwa solusi yang sesuai dengan permintaan Anda belum tersedia.

Setelah yakin bahwa Anda telah menemukan bug baru, atau bahwa permintaan Anda tidak terpenuhi oleh fungsionalitas Google Maps API yang ada, laporkan bug atau permintaan fitur menggunakan Google Maps APIs Issue Tracker.

Sebelum menambahkan bug atau permintaan fitur ke Issue Tracker pastikan memeriksa bahwa bug atau fitur terkait belum ditambahkan. Jika sudah, Anda bisa memberi tanda bintang pada masalah itu untuk mendaftarkan minat Anda dan diberi tahu jika ada pembaruan.

Apakah arti kesalahan ini?

Jika Anda menemukan kesalahan saat memuat Google Maps JavaScript API, lihat Pesan Kesalahan untuk menemukan penjelasan kode kesalahan tersebut.

Saya memiliki pertanyaan/masalah yang berbeda. Siapa yang harus saya hubungi?

Tim Hubungan Developer Google mempertahankan kehadirannya di Stack Overflow — sebuah situs tanya jawab yang diedit secara kolaboratif untuk programmer. Inilah tempat yang tepat untuk mengajukan pertanyaan teknis mengenai pengembangan dan pemeliharaan aplikasi Google Maps. Informasi selengkapnya tentang mengajukan pertanyaan mengenai Stack Overflow tersedia di laman Support.

Untuk hasil terbaik saat meminta bantuan, ingat hal-hal berikut:

  • Telusuri dalam diskusi saat ini. Ada kemungkinan orang lain pernah mengalami masalah yang sama dan telah menemukan solusinya.
  • Kirimkan tautan ke situs Anda jika memungkinkan. Posting cuplikan kode hanya jika kode tersebut tidak bisa dilihat secara online.
  • Berikan semua informasi yang relevan termasuk versi browser, kesalahan, dan semua fakta lain yang mungkin berguna dalam memecahkan masalah ini.

Pelanggan Google Maps APIs Premium Plan juga dapat menghubungi Dukungan Premium Plan.

Layanan Google Maps APIs

Saya harus mengonversi alamat menjadi pasangan garis lintang/garis bujur. Bisakah saya melakukannya dengan Google Maps APIs?

Ya, proses ini disebut "geocoding". Google Maps JavaScript API menyertakan sebuah kelas untuk menjalankan layanan geocoding. Kelas tersebut adalah: google.maps.Geocoder.

Sebagai alternatif, Google juga menyediakan Google Maps Geocoding API, yang menawarkan antarmuka REST, yang bisa merespons dalam format JSON dan XML.

Hati-hati dengan batas penggunaan yang berlaku untuk permintaan geocoder, dan perhatikan bahwa penggunaan geocoder selain untuk tujuan mendapatkan lokasi yang akan ditampilkan menggunakan Google Maps APIs merupakan pelanggaran Ketentuan Layanan. Anda boleh menggunakan geocoder HTTP untuk melakukan geocode terhadap alamat di luar aplikasi Maps API Anda agar bisa di-cache dan selanjutnya ditampilkan menggunakan salah satu Google Maps APIs, namun lokasi yang diperoleh dengan menggunakan Google Maps Geocoding API atau layanan Geocoding tidak boleh digunakan oleh aplikasi lain, didistribusikan dengan cara lain, atau dijual kembali.

Di negara mana saja geocoding tersedia?

Untuk melihat negara-negara yang saat ini didukung oleh geocoder Google Maps APIs, lihat data cakupan Google Maps.

Akurasi lokasi geocode mungkin berbeda di setiap negara, sehingga Anda harus mempertimbangkan penggunaan bidang location_type yang dikembalikan untuk menentukan apakah kecocokan yang cukup baik telah ditemukan untuk keperluan aplikasi Anda. Perhatikan, ketersediaan data geocoding bergantung pada kontak kami dengan penyedia data, jadi hal ini bisa saja berubah.

Untuk geocoding di negara-negara yang saat ini tidak didukung oleh Google Maps APIs, lihat daftar ini pada layanan geocoding lain.

Mengapa geocoder Google Maps APIs menyediakan lokasi yang berbeda dengan Google Maps?

Geocoder API dan geocoder Google Maps kadang-kadang menggunakan rangkaian data yang berbeda (bergantung pada negaranya). Geocoder API sesekali diperbarui dengan data baru, sehingga Anda bisa berharap melihat hasilnya berubah atau meningkat dari waktu ke waktu.

Bagaimana cara memformat kueri geocoder saya untuk memaksimumkan jumlah permintaan yang berhasil?

Geocoder ini didesain untuk memetakan alamat jalan menjadi koordinat geografis. Karena itu kami menyarankan Anda memformat permintaan geocoder sesuai dengan panduan berikut untuk memaksimumkan kemungkinan kueri yang berhasil:

  • Tetapkan alamat sesuai dengan format yang digunakan oleh layanan pos nasional untuk negara yang bersangkutan.
  • Jangan tetapkan elemen alamat tambahan seperti nama bisnis, nomor unit, nomor lantai, atau nomor suite yang tidak termasuk dalam alamat seperti yang didefinisikan oleh layanan pos pada negara yang bersangkutan.
  • Gunakan nomor rumah suatu tempat dan bukan nama gedung bila memungkinkan.
  • Sebaiknya gunakan nomor rumah untuk menetapkan perempatan jalan bila memungkinkan.
  • Jangan memberikan 'petunjuk' misalnya berupa landmark terdekat.

Bagaimana cara memformat alamat A.S. di jalan raya yang telah diberi nomor untuk geocoding?

Geocoder Google Maps APIs mengharuskan jalan raya A.S. bernomor ditetapkan dalam alamat seperti berikut:

  • County Roads: "Co Road NNN" di mana NNN adalah nomor jalan, misalnya "Co Road 82"
  • State Highways: "State NNN" di mana State adalah nama lengkap negara bagian dan NNN adalah nomor highway, misalnya "California 82"
  • U.S. Highways: "U.S. NNN" di mana NNN adalah nomor highway, misalnya "U.S. 101"
  • U.S. Interstates: "Interstate NNN" di mana NNN adalah nomor interstate, misalnya "Interstate 280"

Kapan saya harus menggunakan kelas geocoder API dan kapan harus menggunakan HTTP Geocoding Service?

Lihat dokumen: Strategi Geocoding, yang memberikan detail pro dan kontra dari beragam strategi geocoding.

Bagaimana cara menyediakan arah mengemudi dengan Google Maps APIs?

Google Maps JavaScript API memungkinkan Anda menyediakan arah mengemudi melalui kelas google.maps.DirectionsService. Kelas ini memberi Anda akses langkah-demi-langkah ke arah mengemudi dasar dan multi-point. Kelas DirectionsRenderer dapat secara otomatis membuat panel lapisan dan arah untuk Anda. Contoh tambahan tersedia dalam dokumentasi.

Anda juga dapat dengan mudah menautkan ke Google Maps untuk arah mengemudi. Kami menyarankan Anda menggunakan format berikut untuk arah mengemudi di Google Maps:

http://maps.google.com/maps?saddr={start_address}&daddr={destination_address}

Di negara mana saja arah mengemudi tersedia?

Untuk mengetahui negara mana saja yang saat ini didukung oleh Driving Directions dalam Maps API, lihat data cakupan Google Maps. Perhatikan, ketersediaan data arah mengemudi bergantung pada kontak kami dengan penyedia data, dan hal ini bisa saja berubah.

Di negara mana saja arah angkutan umum tersedia?

Google Maps Directions Service mendukung semua penyedia angkutan umum yang tercantum dalam Daftar Cakupan Angkutan Umum, kecuali untuk di Jepang.

Apa saja fitur KML & GeoRSS yang didukung dalam Google Maps JavaScript API?

Kelas KmlLayer dalam Javascript API memungkinkan developer melapiskan file KML/KMZ dan GeoRSS di atas peta. Dokumentasi dan contoh bisa ditemukan di sini.

Apa saja batas ukuran dan kerumitan KML yang bisa ditampilkan menggunakan kelas Google Maps JavaScript API KmlLayer?

Batas ukuran dan kerumitan atas tampilan KML dengan menggunakan kelas KmlLayer didokumentasikan di sini.

Berapa jumlah maksimum marker atau jalur verteks yang didukung oleh Google Static Maps API?

Tidak ada pembatasan jumlah marker atau jalur verteks yang didukung oleh Google Static Maps API. Bila menggunakan ikon khusus, bisa ditetapkan hingga lima ikon berbeda per permintaan, namun masing-masing bisa digunakan beberapa kali dalam peta.

Perhatikan, URL Google Static Maps API bisa berisi maksimum sekitar 2.000 karakter yang membatasi jumlah marker dan jalur verteks yang bisa ditetapkan berdasarkan jumlah tempat desimal yang digunakan saat menetapkan setiap pasangan garis lintang/garis bujur. Untuk informasi tentang berapa jumlah tempat desimal digunakan berkaitan dengan akurasi pada Earth, lihat artikel Wikipedia mengenai Derajat Desimal.

Mengapa saya tidak bisa mengakses Google Maps APIs dari Cina?

Google Maps APIs dioperasikan di Cina dari domain maps.google.cn. Domain ini tidak mendukung https. Saat membuat permintaan ke Google Maps APIs dari Cina, ganti https://maps.googleapis.com dengan http://maps.google.cn.

Misalnya:

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

akan menjadi:

http://maps.google.cn/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

Google Maps JavaScript API bisa dimuat dengan bootstrap berikut ini:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY"
type="text/javascript">
</script>

Google Maps SDK for iOS

Saya mengalami mogok saat men-debug dengan perangkat iOS 8.x. Apa yang harus saya lakukan?

Jika Anda mengalami masalah saat men-debug dengan perangkat yang menjalankan iOS 8.x, ikuti langkah-langkah ini untuk menonaktifkan perekaman bingkai GPU di skema XCode yang Anda jalankan:

  1. Di XCode, pilih Product, Scheme, Manage Schemes.
  2. Pilih skema dan pilih Edit....

  3. Setel opsi GPU Frame Capture ke Disabled. Perhatikan, opsi ini mungkin tidak ada di semua perangkat.

Kirim masukan tentang...

Google Maps API
Google Maps API