Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Places API Web Service

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 Places API Web Service
  3. Buat kunci yang sesuai
Lanjutkan

Place Add

Dengan menambahkan tempat, Anda bisa menambah data dalam database Google Maps dengan data dari aplikasi Anda. Hal ini memungkinkan Anda untuk:

  • Memperbarui data dengan seketika dalam database Google untuk pengguna Anda.
  • Mengirimkan tempat baru ke antrean moderasi untuk penambahan ke database Google Places.
  • Membedakan aplikasi Anda dari aplikasi lain dengan fungsionalitas serupa.
  • Membuat aplikasi yang ditargetkan untuk basis pengguna atau lokasi geografis tertentu.
  • Memengaruhi hasil dari Places Search yang dikeluarkan dari aplikasi Anda.
  1. Ringkasan
  2. Menambahkan tempat
  3. Menghapus tempat
  4. Kode status
  5. Pesan kesalahan
  6. Parameter sensor

Ringkasan

Bila Anda menambahkan tempat, tempat baru itu segera tersedia di Nearby Search yang dilakukan oleh aplikasi Anda. Tempat baru itu juga akan memasuki antrean moderasi untuk dipertimbangkan bagi Google Maps. Tempat yang baru ditambahkan tidak muncul dalam hasil Text Search atau Radar Search, atau aplikasi lain, sebelum disetujui oleh proses moderasi.

Anda juga bisa menghapus tempat yang telah ditambahkan oleh aplikasi Anda, hingga tempat itu dimoderasi. Setelah dimoderasi dan ditambahkan ke dalam database Google, tempat itu tidak bisa lagi dihapus. Tempat yang tidak disetujui oleh proses moderasi akan tetap terlihat oleh aplikasi yang menyerahkannya.

Menambahkan tempat

Permintaan Place Add adalah permintaan HTTP POST yang serupa dengan contoh di bawah ini:


JSON
POST https://maps.googleapis.com/maps/api/place/add/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "location": {
    "lat": -33.8669710,
    "lng": 151.1958750
  },
  "accuracy": 50,
  "name": "Google Shoes!",
  "phone_number": "(02) 9374 4000",
  "address": "48 Pirrama Road, Pyrmont, NSW 2009, Australia",
  "types": ["shoe_store"],
  "website": "http://www.google.com.au/",
  "language": "en-AU"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/add/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceAddRequest>
  <location>
    <lat>-33.8669710</lat>
    <lng>151.1958750</lng>
  </location>
  <accuracy>50</accuracy>
  <name>Google Shoes!</name>
  <phone_number>(02) 9374 4000</phone_number>
  <address>48 Pirrama Road, Pyrmont, NSW 2009, Australia</address>
  <type>shoe_store</type>
  <website>http://www.google.com.au/</website>
  <language>en-AU</language>
</PlaceAddRequest>
      

Perhatikan, jalur URL menunjukkan format masukan dan keluaran:

  • json (disarankan) menunjukkan masukan dan keluaran dalam JavaScript Object Notation (JSON).
  • xml menunjukkan masukan dan keluaran berupa XML.

URL harus berisi parameter berikut ini:

  • keykunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk keperluan manajemen kuota dan agar tempat yang ditambahkan dari aplikasi Anda langsung tersedia bagi aplikasi Anda. Lihat Dapatkan kunci untuk informasi selengkapnya.

Bagian tubuh permintaan berisi informasi tentang tempat. Strukturnya harus sesuai dengan parameter output yang ditetapkan (JSON atau XML).

  • accuracy — Akurasi sinyal lokasi yang menjadi dasar permintaan ini, dinyatakan dalam meter.
  • address (disarankan, untuk meningkatkan peluang lulus moderasi) — Alamat tempat yang ingin Anda tambahkan. Jika sebuah tempat memiliki alamat yang diformat dengan baik dan bisa dibaca orang, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Maps.
  • language — Bahasa yang digunakan untuk melaporkan nama tempat. Lihat daftar bahasa yang didukung dan kodenya. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.
  • location (diperlukan) — Lokasi geografis tempat yang ingin Anda tambahkan, ditetapkan berupa nilai garis lintang dan garis bujur.
  • name (diperlukan) — Nama teks lengkap dari tempat tersebut. Dibatasi hingga 255 karakter.
  • phone_number (disarankan, untuk meningkatkan peluang lulus moderasi) — Nomor telepon yang dikaitkan dengan tempat tersebut. Jika sebuah tempat memiliki nomor telepon yang diformat dengan baik, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Maps. Nomor ini harus dalam format lokal atau internasional:
    • Format lokal mungkin berbeda untuk setiap negara. Lihat artikel Wikipedia. Misalnya, nomor telepon lokal untuk kantor Google di Sydney, Australia adalah (02) 9374 4000.
    • Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Misalnya, nomor telepon internasional untuk kantor Google di Sydney, Australia adalah +61 2 9374 4000.
  • types (diperlukan) — Kategori tempat tersebut. Walaupun types mengambil sebuah larik, hanya satu tipe yang saat ini bisa ditetapkan untuk sebuah tempat. Permintaan XML memerlukan elemen <type> tunggal. Lihat daftar tipe yang didukung untuk informasi selengkapnya. Jika tipe yang didukung tidak ada yang cocok untuk tempat ini, Anda boleh menetapkan other.
  • website (disarankan, untuk meningkatkan peluang lulus moderasi) — Sebuah URL yang mengarahkan ke situs web resmi tempat ini, seperti laman beranda bisnis. Jika sebuah tempat memiliki alamat situs web yang diformat dengan baik, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Maps.

Respons Place Add

Respons Place Add dikembalikan dalam format yang ditunjukkan oleh parameter output dalam jalur URL permintaan itu.

API mengembalikan kode status, dan jika permintaan itu berhasil maka respons akan menyertakan properti berikut untuk tempat yang baru:

  • place_id: Sebuah identifier tekstual yang secara unik mengidentifikasi tempat. Untuk mengambil informasi tentang tempat, teruskan identifier ini dalam bidang placeid pada permintaan Place Details. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
  • scope: Menunjukkan lingkup place_id. Kemungkinan nilainya untuk bidang ini adalah:
    • APP: ID tempat hanya dikenali oleh aplikasi Anda. Catatan: Respons Place Add akan selalu memiliki lingkup APP, karena tempat tersebut belum melewati proses moderasi.
    • GOOGLE: ID tempat tersedia untuk aplikasi lain dan pada Google Maps. Seperti tersebut di atas, respons Place Add tidak akan memiliki lingkup skala Google.
  • reference: Token unik yang bisa Anda gunakan untuk mengambil informasi tambahan tentang tempat ini. Catatan: reference tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
  • id: Sebuah identifier unik dan stabil yang menandakan tempat ini. Identifier ini tidak bisa digunakan untuk mengambil informasi tentang tempat ini, namun dijamin akan berlaku di semua sesi. Identifier ini bisa digunakan untuk mengkonsolidasikan data tentang tempat ini, dan untuk memverifikasi identitas tempat di semua penelusuran terpisah. Catatan: id tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
{
  "status": "OK",
  "place_id": "CdIJN2t_tDeuEmsRUsoyG83frY4",
  "scope": "APP",
  "reference": "CiQgAAAAeTQS1RtzAyVRVjHcRiIWmWeqcAl3k7bluW7GINLDULESEHozTQhy6OHJw03ziDvY1uEaFAP_vDRhK-UbWw3Gd7Ulqm3eRjIs",
  "id": "6947fc4007436a71dbda51ef9a58627c8e8858f9"
}

Menghapus tempat

Sebuah tempat hanya bisa dihapus jika:

  • Tempat itu ditambahkan oleh aplikasi yang meminta penghapusan.
  • Permintaan Place Add tidak lulus proses moderasi Google Maps, sehingga tempat tersebut hanya terlihat oleh aplikasi yang menambahkannya.

Jika Anda mencoba menghapus tempat yang tidak memenuhi kriteria ini, API akan mengembalikan kode status REQUEST_DENIED.

Permintaan Place Delete adalah permintaan HTTP POST dengan bentuk berikut:


JSON
POST https://maps.googleapis.com/maps/api/place/delete/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "place_id": "place ID"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/delete/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceDeleteRequest>
  <place_id>place ID</place_id>
</PlaceDeleteRequest>
      

Perhatikan, jalur URL menunjukkan format masukan dan keluaran:

  • json (disarankan) menunjukkan masukan dan keluaran dalam JavaScript Object Notation (JSON)
  • xml menunjukkan masukan dan keluaran berupa XML

URL harus berisi parameter berikut ini:

  • keykunci API aplikasi Anda. Kunci ini mengidentifikasi aplikasi Anda untuk keperluan manajemen kuota dan agar tempat yang ditambahkan dari aplikasi Anda langsung tersedia bagi aplikasi Anda. Lihat Dapatkan kunci untuk informasi selengkapnya.

Struktur tubuh permintaan harus sesuai dengan parameter output yang ditetapkan (JSON atau XML). Salah satu dari dua bidang berikut harus disertakan:

  • place_id: Sebuah string yang mengidentifikasi tempat yang harus dihapus, dikembalikan dari Place Search. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
  • Atau, Anda bisa menetapkan reference untuk mengidentifikasi tempat. Perhatikan, reference tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.

Respons Place Delete

Respons Place Delete dikembalikan dalam format yang ditunjukkan oleh parameter output dalam jalur URL permintaan itu.

Permintaan penghapusan yang berhasil akan mengembalikan kode status berikut:

{
  "status": "OK"
}

Kode status

Kode status untuk permintaan Place Add/Place Delete adalah:

  • OK menunjukkan tidak terjadi kesalahan; tempat berhasil ditambahkan atau dihapus.
  • UNKNOWN_ERROR menunjukkan kesalahan pada server; mencobanya lagi mungkin akan berhasil.
  • OVER_QUERY_LIMIT menunjukkan Anda telah melebihi kuota.
  • REQUEST_DENIED menunjukkan permintaan Anda ditolak. Hal ini bisa disebabkan karena berusaha menghapus tempat yang ditambahkan oleh aplikasi lain, atau tempat yang telah lulus proses moderasi Google Maps.
  • INVALID_REQUEST biasanya menunjukkan permintaan berisi parameter yang tidak ada. Hasil ini juga akan dikembalikan saat berupaya menambahkan tempat yang memiliki name lebih besar dari 255 karakter.
  • NOT_FOUND bisa dikembalikan untuk permintaan Place Delete, dan menunjukkan referensi yang diteruskan tidak bisa diterjemahkan menjadi suatu tempat.

Pesan kesalahan

Bila Google Places API Web Service mengembalikan kode status selain OK, mungkin ada bidang error_message tambahan dalam objek respons. Bidang ini berisi informasi lebih detail tentang alasan di balik kode status yang diberikan.

Parameter sensor

Google Places API Web Service sebelumnya mengharuskan Anda menyertakan parameter sensor untuk menunjukkan apakah aplikasi Anda menggunakan sensor untuk menentukan lokasi pengguna. Parameter ini tidak lagi diperlukan.

Kirim masukan tentang...

location_on
Google Places API Web Service