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 Search

Google Places API Web Service memungkinkan Anda membuat kueri informasi tempat dengan berbagai kategori, seperti: tempat usaha, tempat menarik yang menonjol, lokasi geografis, dan lainnya. Anda bisa menelusuri tempat berdasarkan kedekatannya atau string teks. Place Search mengembalikan daftar tempat beserta rangkuman informasi tentang masing-masing tempat; informasi tambahan tersedia melalui kueri Place Details.

Permintaan Nearby Search

Versi terdahulu dari Places API merujuk pada Nearby Search sebagai Place Search.

Nearby Search memungkinkan Anda menelusuri tempat dalam area yang ditetapkan. Anda bisa mempersempit permintaan penelusuran dengan memberikan kata kunci atau menetapkan tipe tempat yang Anda telusuri.

Permintaan Nearby Search adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters

dalam hal ini, output bisa berupa salah satu nilai berikut:

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

Diperlukan parameter tertentu untuk memulai permintaan Nearby Search. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • 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.
  • location — Garis lintang/bujur sekitar lokasi yang Anda ingin dapatkan informasinya. Ini harus ditetapkan sebagai garis lintang,garis bujur.
  • radius — Mendefinisikan jarak (dalam meter) jangkauan untuk mengembalikan hasil pencarian tempat. Radius maksimum yang diperbolehkan adalah 50.000 meter. Perhatikan, radius tidak boleh disertakan jika telah menetapkan rankby=distance (dijelaskan dalam Parameter opsional di bawah ini).
  • Jika rankby=distance telah ditetapkan (dijelaskan dalam Parameter opsional di bawah ini), maka diperlukan satu atau beberapa keyword, name, atau type.

Parameter opsional

  • keyword — Istilah yang akan dicocokkan dengan semua materi yang telah diindeks oleh Google untuk tempat ini, termasuk namun tidak terbatas pada nama, tipe, dan alamat, serta ulasan pelanggan dan materi pihak ketiga lainnya.
  • language — Kode bahasa, menunjukkan dalam bahasa apa hasilnya akan dikembalikan, jika memungkinkan. Penelusuran juga dicondongkan ke bahasa yang dipilih; mengakibatkan bahasa yang dipilih mungkin diberikan peringkat lebih tinggi. Lihat daftar bahasa yang didukung dan kodenya. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.
  • minprice dan maxprice (opsional) — Membatasi hasil hanya pada tempat yang berada dalam jangkauan yang ditetapkan. Nilai yang valid berkisar antara 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Jumlah pasti yang ditunjukkan oleh nilai tertentu akan bervariasi antara region yang satu dengan region lainnya.
  • name – Sebuah istilah yang akan dicocokkan dengan semua materi yang telah diindeks Google untuk tempat ini. Setara dengan keyword. Bidang name tidak lagi dibatasi untuk nama tempat. Nilai di bidang ini digabungkan dengan nilai di bidang keyword dan diteruskan sebagai bagian dari string penelusuran yang sama. Kami menyarankan agar hanya menggunakan parameter keyword untuk semua istilah penelusuran.
  • opennow — Hanya mengembalikan tempat yang sedang buka pada saat kueri dikirim. Tempat yang tidak menetapkan jam buka dalam database Google Places tidak akan dikembalikan jika Anda menyertakan parameter ini dalam kueri.
  • rankby — Menetapkan urutan pencantuman hasil. Perhatikan bahwa rankby harus tidak disertakan jika radius (dijelaskan di Parameter yang diperlukan di atas) ditetapkan. Kemungkinan nilainya:
    • prominence (default). Opsi ini menyortir hasil menurut seberapa pentingnya. Ranking akan mengutamakan tempat yang menonjol dalam area yang ditetapkan. Tempat yang menonjol bisa dipengaruhi oleh peringkat suatu tempat dalam indeks Google, popularitas global, dan faktor lainnya.
    • distance. Opsi ini akan membedakan hasil penelusuran dalam urutan menaik berdasarkan jaraknya dari location yang ditetapkan. Bila distance telah ditetapkan, diperlukan satu atau beberapa keyword, name, atau type.
  • type — Membatasi hasil penelusuran ke tempat yang cocok dengan tipe yang ditetapkan. Hanya satu tipe yang boleh ditetapkan (jika lebih dari satu tipe disediakan, semua tipe setelah entri pertama akan diabaikan). Lihat daftar tipe yang didukung.
  • types (tidak digunakan lagi) — Membatasi hasil pencarian ke tempat yang mempunyai kecocokan sedikitnya dengan satu dari tipe yang ditetapkan. Pisahkan tipe dengan simbol pipa, seperti ini:
    type1|type2|dsb.
  • pagetoken — Mengembalikan 20 hasil berikutnya dari penelusuran yang dijalankan sebelumnya. Menyetel parameter pagetoken akan mengeksekusi penelusuran dengan parameter yang sama dengan yang digunakan sebelumnya — semua parameter selain pagetoken akan diabaikan.
  • zagatselected (tidak digunakan lagi) — Tambahkan parameter ini (hanya nama parameter, dengan nilai yang tidak dikaitkan) untuk membatasi penelusuran Anda ke lokasi yang merupakan bisnis yang dipilih Zagat. Parameter ini tidak boleh menyertakan nilai true atau false. Parameter zagatselected bersifat eksperimen, dan hanya tersedia untuk pelanggan Google Places API yang memiliki lisensi Premium Plan.

Catatan untuk pelanggan Google Maps APIs Premium Plan: Anda harus menyertakan kunci API di permintaan Anda. Anda harus tidak menyertakan parameter client atau signature dengan permintaan Anda.

Contoh penelusuran sekitar

Contoh berikut adalah permintaan penelusuran tempat bertipe 'restaurant' dalam radius 500 m dari suatu tempat di Sydney, Australia, yang berisi kata 'cruise':

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

Catatan: Dalam contoh ini, Anda perlu mengganti key dengan kunci API Anda sendiri agar permintaan bisa berhasil dalam aplikasi Anda.

Permintaan Text Search

Google Places API Text Search Service adalah layanan web yang mengembalikan informasi tentang serangkaian tempat berdasarkan suatu string - misalnya "pizza in New York" atau "shoe stores near Ottawa" atau "123 Main Street". Layanan ini merespons dengan daftar tempat yang cocok dengan string teks dan kecondongan lokasi yang telah disetel.

Layanan khususnya berguna untuk membuat kueri alamat ambigu dalam sistem otomatis, dan komponen non-alamat pada string yang mungkin cocok dengan bisnis serta alamat. Contoh kueri alamat ambigu adalah alamat yang tidak lengkap, alamat yang tidak diformat dengan baik, atau permintaan yang menyertakan komponen non-alamat, seperti nama bisnis.

Respons penelusuran akan menyertakan daftar tempat. Anda bisa mengirim permintaan Place Details untuk informasi selengkapnya tentang tempat dalam respons.

Layanan penelusuran Google Places menggunakan batas penggunaan yang sama. Akan tetapi, layanan Text Search tunduk pada faktor pengali 10-kali. Yakni, setiap permintaan Text Search yang Anda buat akan dihitung sebagai 10 permintaan terhadap kuota Anda. Jika Anda telah membeli Google Places API sebagai bagian dari perjanjian Google Maps APIs Premium Plan Anda, faktor pengali mungkin berbeda. Lihat dokumentasi Google Maps APIs Premium Plan untuk detailnya.

Permintaan Text Search adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/textsearch/output?parameters

dalam hal ini, output bisa berupa salah satu nilai berikut:

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

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • query — String teks yang digunakan untuk menelusuri, misalnya: "restaurant" atau "123 Main Street". Layanan Google Places akan mengembalikan bakal hasil berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang terlihat. Parameter ini menjadi opsional jika parameter type juga digunakan dalam permintaan penelusuran.
  • 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 Google Places API Web Service untuk melihat cara membuat Proyek API dan mendapatkan kunci Anda.

Parameter opsional

  • location — Garis lintang/bujur sekitar lokasi yang Anda ingin dapatkan informasinya. Ini harus ditetapkan sebagai garis lintang,garis bujur. Jika Anda menetapkan parameter location, Anda juga harus menetapkan parameter radius.
  • radius — Mendefinisikan jarak (dalam meter) jangkauan untuk mencondongkan hasil pencarian tempat. Radius maksimum yang diperbolehkan adalah 50.000 meter. Hasil penelusuran dalam region ini akan memiliki peringkat lebih tinggi daripada hasil penelusuran di luar lingkaran; akan tetapi, hasil yang menonjol di luar radius penelusuran mungkin disertakan.
  • language — Kode bahasa, menunjukkan dalam bahasa apa hasilnya akan dikembalikan, jika memungkinkan. Penelusuran juga dicondongkan ke bahasa yang dipilih; mengakibatkan bahasa yang dipilih mungkin diberikan peringkat lebih tinggi. Lihat daftar bahasa yang didukung dan kodenya. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.
  • minprice dan maxprice (opsional) — Membatasi hasil hanya pada tempat yang berada dalam tingkat harga yang ditetapkan. Nilai yang valid berkisar dari 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Jumlah pasti yang ditunjukkan oleh nilai tertentu akan bervariasi antara region yang satu dengan region lainnya.
  • opennow — Hanya mengembalikan tempat yang sedang buka pada saat kueri dikirim. Tempat yang tidak menetapkan jam buka dalam database Google Places tidak akan dikembalikan jika Anda menyertakan parameter ini dalam kueri.
  • pagetoken — Mengembalikan 20 hasil berikutnya dari penelusuran yang dijalankan sebelumnya. Menyetel parameter pagetoken akan mengeksekusi penelusuran dengan parameter yang sama dengan yang digunakan sebelumnya — semua parameter selain pagetoken akan diabaikan.
  • type — Membatasi hasil penelusuran ke tempat yang cocok dengan tipe yang ditetapkan. Hanya satu tipe yang boleh ditetapkan (jika lebih dari satu tipe disediakan, semua tipe setelah entri pertama akan diabaikan). Lihat daftar tipe yang didukung.
  • types (tidak digunakan lagi) — Membatasi hasil pencarian ke tempat yang mempunyai kecocokan sedikitnya dengan satu dari tipe yang ditetapkan. Pisahkan tipe dengan simbol pipa (type1|type2|dsb).
  • zagatselected (tidak digunakan lagi) — Tambahkan parameter ini (hanya nama parameter, dengan nilai yang tidak dikaitkan) untuk membatasi penelusuran Anda ke lokasi yang merupakan bisnis yang dipilih Zagat. Parameter ini tidak boleh menyertakan nilai true atau false. Parameter zagatselected bersifat eksperimen, dan hanya tersedia untuk pelanggan Google Places API yang memiliki lisensi Premium Plan.

Anda bisa mencondongkan hasil ke lingkaran yang ditetapkan dengan meneruskan parameter location dan radius. Ini akan menginstruksikan layanan Google Places agar lebih memilih menampilkan hasil dalam lingkaran itu. Hasil di luar area yang didefinisikan mungkin tetap ditampilkan.

Catatan untuk pelanggan Google Maps APIs Premium Plan: Anda harus menyertakan kunci API di permintaan Anda. Anda harus tidak menyertakan parameter client atau signature dengan permintaan Anda.

Contoh penelusuran teks

Catatan: Dalam contoh ini, Anda perlu mengganti key dengan kunci API Anda sendiri agar permintaan bisa berhasil dalam aplikasi Anda.

Contoh 1: Contoh berikut menampilkan penelusuran untuk restoran di dekat Sydney.

https://maps.googleapis.com/maps/api/place/textsearch/xml?query=restaurants+in+Sydney&key=YOUR_API_KEY

Contoh 2: Contoh berikut menampilkan penelusuran untuk alamat tidak lengkap, dalam hal ini, alamat yang tidak menyertakan kota atau provinsi atau negara.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&key=YOUR_API_KEY

Contoh 3: Contoh berikut menampilkan penelusuran untuk alamat tidak lengkap yang sama dengan contoh 2, dan menyertakan parameter location dan radius untuk mencondongkan hasil ke region yang diminati. Bandingkan hasil contoh 2 dengan contoh 3.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&location=42.3675294,-71.186966&radius=10000&key=YOUR_API_KEY

Permintaan Radar Search

Layanan Google Places API Radar Search Service memungkinkan Anda menelusuri hingga 200 tempat sekaligus, namun dengan hasil kurang detail daripada yang biasanya dikembalikan oleh permintaan Text Search atau Nearby Search. Dengan Radar Search, Anda bisa membuat aplikasi yang membantu pengguna mengidentifikasi area tertentu yang menarik dalam suatu area geografis.

Respons penelusuran akan menyertakan hingga 200 tempat, dan hanya akan menyertakan informasi berikut tentang setiap tempat:

  • Bidang geometry yang berisi koordinat geografis.
  • place_id, yang bisa Anda gunakan dalam permintaan Place Details untuk mendapatkan informasi selengkapnya tentang tempat tersebut. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
  • Bidang reference yang tidak digunakan lagi. Lihat pemberitahuan penghentian pada laman ini.

Permintaan Radar Search adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/radarsearch/output?parameters

dalam hal ini, output bisa berupa salah satu nilai berikut:

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

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • 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 Google Places API Web Service untuk melihat cara membuat Proyek API dan mendapatkan kunci Anda.
  • location — Garis lintang/bujur sekitar lokasi yang Anda ingin dapatkan informasinya. Ini harus ditetapkan sebagai garis lintang,garis bujur.
  • radius — Mendefinisikan jarak (dalam meter) jangkauan untuk mengembalikan hasil pencarian tempat. Radius maksimum yang diperbolehkan adalah 50.000 meter.
  • Permintaan Radar Search harus menyertakan setidaknya satu keyword, name, atau type.

Parameter opsional

  • keyword — Istilah yang akan dicocokkan dengan semua materi yang telah diindeks oleh Google untuk tempat ini, termasuk namun tidak terbatas pada nama, tipe, dan alamat, serta ulasan pelanggan dan materi pihak ketiga lainnya.
  • language — Kode bahasa, menunjukkan dalam bahasa apa hasilnya akan dikembalikan, jika memungkinkan. Penelusuran juga dicondongkan ke bahasa yang dipilih; mengakibatkan bahasa yang dipilih mungkin diberikan peringkat lebih tinggi. Lihat daftar bahasa yang didukung dan kodenya. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.
  • minprice dan maxprice (opsional) — Membatasi hasil hanya pada tempat yang berada dalam tingkat harga yang ditetapkan. Nilai yang valid berkisar dari 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Jumlah pasti yang ditunjukkan oleh nilai tertentu akan bervariasi antara region yang satu dengan region lainnya.
  • name – Sebuah istilah yang akan dicocokkan dengan semua materi yang telah diindeks Google untuk tempat ini. Setara dengan keyword. Bidang name tidak lagi dibatasi untuk nama tempat. Nilai di bidang ini digabungkan dengan nilai di bidang keyword dan diteruskan sebagai bagian dari string penelusuran yang sama. Kami menyarankan agar hanya menggunakan parameter keyword untuk semua istilah penelusuran.
  • opennow — Hanya mengembalikan tempat yang sedang buka pada saat kueri dikirim. Tempat yang tidak menetapkan jam buka dalam database Google Places tidak akan dikembalikan jika Anda menyertakan parameter ini dalam kueri.
  • type — Membatasi hasil penelusuran ke tempat yang cocok dengan tipe yang ditetapkan. Hanya satu tipe yang boleh ditetapkan (jika lebih dari satu tipe disediakan, semua tipe setelah entri pertama akan diabaikan). Lihat daftar tipe yang didukung.
  • types (tidak digunakan lagi) — Membatasi hasil pencarian ke tempat yang mempunyai kecocokan sedikitnya dengan satu dari tipe yang ditetapkan. Pisahkan tipe dengan simbol pipa (type1|type2|dsb).
  • zagatselected (tidak digunakan lagi) — Tambahkan parameter ini (hanya nama parameter, dengan nilai yang tidak dikaitkan) untuk membatasi penelusuran Anda ke lokasi yang merupakan bisnis yang dipilih Zagat. Parameter ini tidak boleh menyertakan nilai true atau false. Parameter zagatselected bersifat eksperimen, dan hanya tersedia untuk pelanggan Google Places API yang memiliki lisensi Premium Plan.

Catatan untuk pelanggan Google Maps APIs Premium Plan: Anda harus menyertakan kunci API di permintaan Anda. Anda harus tidak menyertakan parameter client atau signature dengan permintaan Anda.

Contoh Radar Search

Catatan: Dalam contoh ini, Anda perlu mengganti key dengan kunci API Anda sendiri agar permintaan bisa berhasil dalam aplikasi Anda.

Contoh 1: Contoh berikut mengembalikan daftar museum di dekat London, England.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=51.503186,-0.126446&radius=5000&type=museum&key=YOUR_API_KEY

Contoh 2: Dengan kombinasi parameter keyword dan type, Anda bisa menjalankan kueri yang lebih akurat. Contoh berikut ini menampilkan restoran dan kafe di Paris yang dijelaskan pengguna sebagai tempat untuk vegetarian.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=48.859294,2.347589&radius=5000&type=cafe&keyword=vegetarian&key=YOUR_API_KEY

Respons Penelusuran

Respons penelusuran dikembalikan dalam format yang ditunjukkan oleh flag output dalam jalur permintaan URL itu.

Contoh berikut ini menampilkan respons Nearby Search. Respons Text Search serupa, hanya saja yang dikembalikan adalah formatted_address sebagai ganti properti vicinity. Radar Search hanya menyertakan bidang terbatas, seperti dijelaskan di atas.

JSON
{
   "html_attributions" : [],
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870775,
               "lng" : 151.199025
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "21a0b251c9b8392186142c798263e289fe45b4aa",
         "name" : "Rhythmboat Cruises",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 270,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAF-LjFR1ZV93eawe1cU_3QNMCNmaGkowY7CnOf-kcNmPhNnPEG9W979jOuJJ1sGr75rhD5hqKzjD8vbMbSsRnq_Ni3ZIGfY6hKWmsOf3qHKJInkm4h55lzvLAXJVc-Rr4kI9O1tmIblblUpg2oqoq8RIQRMQJhFsTr5s9haxQ07EQHxoUO0ICubVFGYfJiMUPor1GnIWb5i8",
               "width" : 519
            }
         ],
         "place_id" : "ChIJyWEHuEmuEmsRm9hTkapTCrk",
         "scope" : "GOOGLE",
         "alt_ids" : [
            {
               "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
               "scope" : "APP"
            }
         ],
         "reference" : "CoQBdQAAAFSiijw5-cAV68xdf2O18pKIZ0seJh03u9h9wk_lEdG-cP1dWvp_QGS4SNCBMk_fB06YRsfMrNkINtPez22p5lRIlj5ty_HmcNwcl6GZXbD2RdXsVfLYlQwnZQcnu7ihkjZp_2gk1-fWXql3GQ8-1BEGwgCxG-eaSnIJIBPuIpihEhAY1WYdxPvOWsPnb2-nGb6QGhTipN0lgaLpQTnkcMeAIEvCsSa0Ww",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "Pyrmont Bay Wharf Darling Dr, Sydney"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866891,
               "lng" : 151.200814
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "45a27fd8d56c56dc62afc9b49e1d850440d5c403",
         "name" : "Private Charter Sydney Habour Cruise",
         "photos" : [
            {
               "height" : 426,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAL3n0Zu3U6fseyPl8URGKD49aGB2Wka7CKDZfamoGX2ZTLMBYgTUshjr-MXc0_O2BbvlUAZWtQTBHUVZ-5Sxb1-P-VX2Fx0sZF87q-9vUt19VDwQQmAX_mjQe7UWmU5lJGCOXSgxp2fu1b5VR_PF31RIQTKZLfqm8TA1eynnN4M1XShoU8adzJCcOWK0er14h8SqOIDZctvU",
               "width" : 640
            }
         ],
         "place_id" : "ChIJqwS6fjiuEmsRJAMiOY9MSms",
         "scope" : "GOOGLE",
         "reference" : "CpQBhgAAAFN27qR_t5oSDKPUzjQIeQa3lrRpFTm5alW3ZYbMFm8k10ETbISfK9S1nwcJVfrP-bjra7NSPuhaRulxoonSPQklDyB-xGvcJncq6qDXIUQ3hlI-bx4AxYckAOX74LkupHq7bcaREgrSBE-U6GbA1C3U7I-HnweO4IPtztSEcgW09y03v1hgHzL8xSDElmkQtRIQzLbyBfj3e0FhJzABXjM2QBoUE2EnL-DzWrzpgmMEulUBLGrtu2Y",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "Australia"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870943,
               "lng" : 151.190311
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "30bee58f819b6c47bd24151802f25ecf11df8943",
         "name" : "Bucks Party Cruise",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAA48AX5MsHIMiuipON_Lgh97hPiYDFkxx_vnaZQMOcvcQwYN92o33t5RwjRpOue5R47AjfMltntoz71hto40zqo7vFyxhDuuqhAChKGRQ5mdO5jv5CKWlzi182PICiOb37PiBtiFt7lSLe1SedoyrD-xIQD8xqSOaejWejYHCN4Ye2XBoUT3q2IXJQpMkmffJiBNftv8QSwF4",
               "width" : 800
            }
         ],
         "place_id" : "ChIJLfySpTOuEmsRsc_JfJtljdc",
         "scope" : "GOOGLE",
         "reference" : "CoQBdQAAANQSThnTekt-UokiTiX3oUFT6YDfdQJIG0ljlQnkLfWefcKmjxax0xmUpWjmpWdOsScl9zSyBNImmrTO9AE9DnWTdQ2hY7n-OOU4UgCfX7U0TE1Vf7jyODRISbK-u86TBJij0b2i7oUWq2bGr0cQSj8CV97U5q8SJR3AFDYi3ogqEhCMXjNLR1k8fiXTkG2BxGJmGhTqwE8C4grdjvJ0w5UsAVoOH7v8HQ",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "37 Bank St, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867591,
               "lng" : 151.201196
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "a97f9fb468bcd26b68a23072a55af82d4b325e0d",
         "name" : "Australian Cruise Group",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 242,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAABjeoPQ7NUU3pDitV4Vs0BgP1FLhf_iCgStUZUr4ZuNqQnc5k43jbvjKC2hTGM8SrmdJYyOyxRO3D2yutoJwVC4Vp_dzckkjG35L6LfMm5sjrOr6uyOtr2PNCp1xQylx6vhdcpW8yZjBZCvVsjNajLBIQ-z4ttAMIc8EjEZV7LsoFgRoU6OrqxvKCnkJGb9F16W57iIV4LuM",
               "width" : 200
            }
         ],
         "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
         "scope" : "GOOGLE",
         "reference" : "CoQBeQAAAFvf12y8veSQMdIMmAXQmus1zqkgKQ-O2KEX0Kr47rIRTy6HNsyosVl0CjvEBulIu_cujrSOgICdcxNioFDHtAxXBhqeR-8xXtm52Bp0lVwnO3LzLFY3jeo8WrsyIwNE1kQlGuWA4xklpOknHJuRXSQJVheRlYijOHSgsBQ35mOcEhC5IpbpqCMe82yR136087wZGhSziPEbooYkHLn9e5njOTuBprcfVw",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "32 The Promenade, King Street Wharf 5, Sydney"
      }
   ],
   "status" : "OK"
}

Respons JSON berisi hingga empat elemen akar:

  • "status" berisi metadata yang diminta. Lihat Kode Status di bawah ini.
  • "results" berisi larik beberapa tempat, beserta informasinya masing-masing. Lihat Hasil Penelusuran untuk informasi tentang hasil ini. Places API mengembalikan hingga 20 establishment per kueri. Sebagai tambahan, mungkin dikembalikan hasil political yang berfungsi untuk mengidentifikasi area permintaan.
  • html_attributions berisi sekumpulan atribusi tentang daftar ini yang harus ditampilkan kepada pengguna.
  • next_page_token berisi token yang bisa digunakan untuk mengembalikan hingga 20 hasil tambahan. next_page_token tidak akan dikembalikan jika tidak ada hasil tambahan untuk ditampilkan. Jumlah hasil maksimum yang bisa dikembalikan adalah 60. Ada jeda sejenak antara saat next_page_token dikeluarkan, dan saat akan menjadi valid.

Lihat Memproses JSON dengan JavaScript untuk membantu mem-parse respons JSON.

XML
<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>Pyrmont Bay Wharf Darling Dr, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8707750</lat>
    <lng>151.1990250</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CoQBdAAAAChhtoQX_467esHavS0Sj9DrY306W3_uDXKmB2us8Eh7_dX7rDuln18i_uqocF_LmzRptuFr6WZs7aeBSLFq8VFmckxFjsXDaqMdd3gvxi_5dIwPTEugQQYG9oJA-YnYfPBvjGtuoMfNnjyU2GuxGRmJjCO77pEAbsTLq44eBG5jEhAvkKHCGqIzqgC9tdOb1dSqGhRA1hhG4pvILD5OEAq6W8L8sXbkug</reference>
  <id>21a0b251c9b8392186142c798263e289fe45b4aa</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAiRA8ls6lx5LTfLuHJtLYvz73LXIMa5EVsHz2OUjh70LBPBnIEULZ57w076gOuyCeJqP041_v-ek3I5C4IkqW7YgA0EBybwywfIcUXsj5W_qiJR2yaXHXI-FmDM6j1zaS0sJQnNJhe4Bl9W42Jx16phIQRmNOWKGIemKLgzNEPcCnmBoUGgr0gWQBwWd8HAseR-5ie3JYuIM</photo_reference>
   <width>519</width>
   <height>270</height>
  </photo>
 </result>
 <result>
  <name>Private Charter Sydney Habour Cruise</name>
  <vicinity>Australia</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8668910</lat>
    <lng>151.2008140</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJqwS6fjiuEmsRJAMiOY9MSms</place_id>
  <scope>GOOGLE</scope>
  <reference>CpQBhQAAAKGKrbbnAW3_eAypKW9bhAzAuSmaqAogs7MTFxsntDqCzt-gKD9nz-zqNsk0uJsl0yCUYpNYjHz_yzmh3J_4TTxpxIqdaq2uDvfoTYtvm8FkxMAkK3cS7k9t3Ze2aHRWnxlN9hczK2xlc5taDE7xAGOHF5Xe5IlVV1wV66sOrWrlHtGh47lqT9Id86eG2OmlVhIQo4djLtRkceg-zaYjULYEjRoUToVEyOUVCFfZMUs_E7ZLSzjFmcg</reference>
  <id>45a27fd8d56c56dc62afc9b49e1d850440d5c403</id>
  <photo>
   <photo_reference>CnRnAAAAUW97jpK2_C2Lh4jLPVKZlhyS84mqZxvVmWFdc6jdl3XxjzKbYdbJpz0PGW5eFRw6kTKYNZM9QvRf-csFegHILZxLCLJ-6ZnbdEXbVM4kBzOb-rhchJx1KC6LHs_vVWP8bK96569lFYRf7Hn8ylQrlhIQb69_dcZVwqQhREsHW6azWhoU0XMWqZMBBzx-hgpduAaeErOFg8E</photo_reference>
   <width>640</width>
   <height>426</height>
  </photo>
 </result>
 <result>
  <name>Bucks Party Cruise</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8709430</lat>
    <lng>151.1903110</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJLfySpTOuEmsRsc_JfJtljdc</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBdAAAAOMUoYamsekTDxBDVyKZ-E54VQ6HjirVzAZBBwz5gcn5KTfmemmwmOAtLcvRScp1NLQmj-fBYzEO2Gq_cO4Dc12PG0_twzDv9zq3KIyNQVuO-r0n1eQVj8Dlng-n4c1F2hMxufCNVp4-QfjMj81qXJm0invQMUc1xNgZRyiOpLe9EhDLn0KiVWEFKOURYsWrHRouGhR7YMJxYmFs-OXjKyzQKGdQXLrzPw</reference>
  <id>30bee58f819b6c47bd24151802f25ecf11df8943</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAjboYP9Ujxe5SmZFN5AJc42AWtpYFX9wYdqjcTXavXJlfoXdHPC2hErdbHcaeYJBNPV6CzoDc2RLw_w9HofGOhCWHtoAl9b3g8TZZjnZobnAHxoljUdgV8PXyd-pCO-QHKOtiKfIdUmF4HRj2QHj6OhIQhLNpoKNKP8MNjk90M4KGrhoUW2NyBgsWjRpUEoWlt0fD48BhEcQ</photo_reference>
   <width>800</width>
   <height>600</height>
  </photo>
 </result>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>32 The Promenade, King Street Wharf 5, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675910</lat>
    <lng>151.2011960</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBeAAAAJZA0WY2pKnZ6nNnxNd_pSDA2NilDLfGDf7pTt7VssxB5tMYE7400w3HZHRav2unpKRhEp7lrh0yKcVdSfKYIz85k1SExoLGmYD8NIf1dPr8KlkRWOYZUTLGp623r5hAzEGk94mPleF4s50pWqLrhAzwvJb1tGj2ak-2PXQORkeTEhAfTj6tMFo_tRWZYOnYCxiVGhQA3n-KV7AW5MvJlGaIDHuLyyEBBA</reference>
  <id>a97f9fb468bcd26b68a23072a55af82d4b325e0d</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAhTkpwozMoZx_NXMkIrKdcEGe46BmPy3GPCfS-gkCK5PlR8rFDY9DtD_7wFYAIdhVoZz3I9QguRNbil5y37jTU-03GJ_LqVw_avSxFkT0g2kU0K5z2VYnAsgNsrbsK_EVglhg5PrDybC1tAVKCXSGsRIQOcdlAVnC1Qc46YLWjlqdyxoUL5JGZgczfo1jxLxhDeGs8OvBQCk</photo_reference>
   <width>200</width>
   <height>242</height>
  </photo>
 </result>
</PlaceSearchResponse>

Respons XML terdiri dari satu <PlaceSearchResponse> dan hingga empat elemen tingkat atas:

  • <status> berisi metadata yang diminta. Lihat Kode Status di bawah ini.
  • Nol atau beberapa elemen <result>, masing-masing berisi informasi tentang satu tempat usaha. Lihat Hasil Nearby Search untuk informasi tentang hasil ini. Places API mengembalikan hingga 20 establishment per kueri. Sebagai tambahan, mungkin dikembalikan hasil political<type>, atau jalan, yang berfungsi untuk mengidentifikasi area permintaan.
  • next_page_token berisi token yang bisa digunakan untuk mengembalikan hingga 20 hasil tambahan. next_page_token tidak akan dikembalikan jika tidak ada hasil tambahan untuk ditampilkan. Jumlah hasil maksimum yang bisa dikembalikan adalah 60. next_page_token akan menjadi aktif 2 detik setelah dikeluarkan pertama kali.
  • html_attributions berisi sekumpulan atribusi tentang daftar ini yang harus ditampilkan kepada pengguna.

Kode Status

Bidang "status" dalam objek respons penelusuran berisi status permintaan, dan mungkin berisi informasi debug untuk membantu Anda melacak penyebab gagalnya permintaan. Bidang "status" bisa berisi nilai berikut:

  • OK menunjukkan tidak terjadi kesalahan; tempat berhasil dideteksi dan setidaknya satu hasil dikembalikan.
  • ZERO_RESULTS menunjukkan penelusuran berhasil namun tidak mengembalikan hasil. Ini bisa terjadi jika pada penelusuran itu diteruskan latlng di lokasi terpencil.
  • OVER_QUERY_LIMIT menunjukkan Anda telah melebihi kuota.
  • REQUEST_DENIED menunjukkan permintaan Anda ditolak, biasanya karena tidak ada parameter key yang tidak valid.
  • INVALID_REQUEST biasanya menunjukkan parameter kueri yang diperlukan (location atau radius) tidak ada.

Pesan Kesalahan

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

Hasil Penelusuran

Bila layanan Google Places mengembalikan hasil JSON dari penelusuran, hasilnya akan dimasukkan dalam larik results. Bahkan jika layanan tidak mengembalikan hasil (seperti jika location adalah tempat terpencil), layanan masih mengembalikan larik results yang kosong. Respons XML terdiri dari nol atau beberapa elemen <result>.

Setiap elemen larik results berisi satu hasil dari area yang ditetapkan (location dan radius), diurutkan berdasar keunggulannya.

Hasilnya juga bisa berisi informasi atribusi yang harus ditampilkan kepada pengguna. Ini adalah contoh atribusi dalam format JSON:

"html_attributions" : [
      "Listings by \u003ca href=\"http://www.example.com/\"\u003eExample Company\u003c/a\u003e"
],
Ini adalah atribusi dalam format XML:
<html_attribution>Listings by <a href="http://www.example.com/">Example Company</a></html_attribution>

Setiap hasil dalam larik results bisa berisi bidang berikut:

  • icon berisi URL dari ikon yang disarankan yang bisa ditampilkan kepada pengguna saat menunjukkan hasil ini.
  • id berisi 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 sekarang tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
  • geometry berisi informasi geometri tentang hasil, biasanya termasuk location (geocode) tempat dan (opsional) viewport yang mengidentifikasi area umum lingkup.
  • name berisi nama yang bisa dibaca orang untuk hasil yang dikembalikan. Untuk hasil establishment, biasanya berisi nama bisnis.
  • opening_hours bisa berisi informasi berikut:
    • open_now adalah nilai boolean yang menunjukkan apakah tempat itu buka pada waktu saat ini.
  • photos[] — adalah larik objek photo, masing-masing berisi referensi ke sebuah gambar. Place Search akan mengembalikan maksimal satu objek photo. Membuat permintaan Place Details atas suatu tempat bisa mengembalikan hingga sepuluh foto. Informasi selengkapnya tentang Place Photos dan cara menggunakan gambar dalam aplikasi Anda bisa ditemukan dalam dokumentasi Place Photos. Objek photo dijelaskan sebagai:
    • photo_reference — string yang digunakan untuk mengidentifikasi foto bila Anda membuat permintaan Photo.
    • height — tinggi maksimum gambar.
    • width — lebar maksimum gambar.
    • html_attributions[] — berisi atribusi yang diperlukan. Bidang ini akan selalu ada, namun mungkin kosong.
  • place_id — sebuah identifier tekstual yang secara unik mengidentifikasi tempat. Untuk mengambil informasi tentang tempat, teruskan identifier ini dalam bidang placeid pada permintaan Places API. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
  • scope — menunjukkan lingkup place_id. Kemungkinan nilainya adalah:
    • APP: ID tempat hanya dikenali oleh aplikasi Anda. Hal ini karena aplikasi Anda yang menambahkan tempat, dan tempat tersebut belum melewati proses moderasi.
    • GOOGLE: ID tempat tersedia untuk aplikasi lain dan pada Google Maps.
    Catatan: Bidang scope hanya disertakan dalam hasil Nearby Search dan hasil Place Details. Anda hanya bisa mengambil tempat lingkup-aplikasi melalui permintaan Nearby Search dan Place Details. Jika bidang scope tidak ada dalam respons, maka aman beranggapan bahwa lingkupnya adalah GOOGLE.
  • alt_ids — Larik nol, satu atau beberapa ID tempat alternatif untuk tempat, dengan cakupan yang berkaitan dengan setiap ID alternatif. Catatan: Larik ini mungkin kosong atau tidak ada. Jika ada, maka berisi bidang-bidang berikut:
    • place_id — Alasan yang paling mungkin bagi sebuah tempat untuk memiliki ID tempat alternatif adalah jika aplikasi Anda menambahkan tempat dan menerima ID tempat lingkup-aplikasi, kemudian menerima ID tempat lingkup-Google setelah melewati proses moderasi.
    • scope — Lingkup ID tempat alternatif akan selalu berupa APP, yang menunjukkan bahwa ID tempat alternatif itu hanya dikenali oleh aplikasi Anda.
    Misalnya, anggaplah aplikasi Anda menambahkan sebuah tempat dan menerima place_id AAA untuk tempat baru tersebut. Kemudian, tempat itu melewati proses moderasi dan menerima place_id lingkup-Google berupa BBB. Selanjutnya, informasi untuk tempat ini akan berisi:
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level — Tingkat harga tempat, dengan skala 0 hingga 4. Jumlah pasti yang ditunjukkan oleh nilai tertentu akan bervariasi antara region yang satu dengan region lainnya. Tingkat harga diinterpretasikan sebagai berikut:
    • 0 — Gratis
    • 1 — Murah
    • 2 — Sedang
    • 3 — Mahal
    • 4 — Sangat Mahal
  • rating berisi peringkat tempat ini, dari 1,0 hingga 5,0, berdasarkan gabungan ulasan pengguna.
  • reference berisi token unik yang bisa Anda gunakan untuk mengambil informasi tambahan tentang tempat ini dalam permintaan Place Details. Meskipun token ini secara unik mengidentifikasi tempat, hal yang sebaliknya tidak berlaku. Sebuah tempat bisa memiliki banyak token referensi yang valid. Tidak dijamin bahwa token yang sama akan dikembalikan untuk suatu tempat pada penelusuran berbeda. Catatan: reference sekarang tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
  • types[] berisi larik tipe fitur yang menjelaskan hasil yang diberikan. Lihat daftar tipe yang didukung untuk informasi selengkapnya. Respons XML menyertakan beberapa elemen <type> jika lebih dari satu tipe ditetapkan ke hasilnya.
  • vicinity berisi nama fitur dari lokasi terdekat. Sering kali fitur ini mengacu pada sebuah jalan atau lingkungan dalam hasil yang diberikan. Properti vicinity hanya dikembalikan untuk Nearby Search.
  • formatted_address adalah string berisi alamat yang bisa dibaca orang untuk tempat ini. Sering kali alamat ini sama dengan "alamat pos". Properti formatted_address hanya dikembalikan untuk Text Search.
  • permanently_closed adalah flag boolean yang menunjukkan apakah tempat tersebut tutup untuk selamanya (nilainya true). Jika tempat tersebut tidak tutup selamanya, flag tidak ada dalam respons.

Data Premium

Sebagai tambahan untuk bidang yang tercantum di atas, pelanggan Google Places API yang memiliki lisensi Premium Plan mungkin mendapatkan bidang-bidang berikut. Bidang ini akan muncul sebagai anak tingkat teratas dari bidang result.

  • aspects berisi satu objek AspectRating, untuk peringkat utama tempat usaha. Setiap AspectRating dijelaskan sebagai:
    • type nama aspek yang akan diberi peringkat. Tipe-tipe berikut ini didukung: appeal, atmosphere, decor, facilities, food, overall, quality dan service.
    • rating peringkat gabungan untuk aspek tertentu, dari 0 hingga 30. Perhatikan, peringkat gabungan berkisar dari 0 hingga 30, sedangkan peringkat yang muncul sebagai bagian dari ulasan berkisar dari 0 hingga 3.
  • zagat_selected menunjukkan bahwa tempat ini telah dipilih sebagai lokasi Zagat yang berkualitas. Label Zagat mengidentifikasi tempat yang terkenal memiliki kualitas tinggi secara konsisten atau tempat yang memiliki karakter khusus atau unik.
Untuk informasi selengkapnya, lihat Data Premium.

Mengakses Hasil Tambahan

Secara default, setiap Nearby Search atau Text Search mengembalikan hingga 20 establishment hasil per kueri; akan tetapi, setiap penelusuran bisa mengembalikan hingga 60 hasil, yang terbagi dalam tiga laman. Jika penelusuran Anda mengembalikan lebih dari 20, maka respons penelusuran akan menyertakan nilai tambahan — next_page_token. Teruskan nilai next_page_token ke parameter pagetoken penelusuran baru untuk melihat kumpulan hasil berikutnya. Jika next_page_token adalah nol, atau tidak dikembalikan, maka tidak ada hasil lebih jauh. Ada jeda sejenak antara saat next_page_token dikeluarkan, dan saat akan menjadi valid. Meminta laman berikutnya sebelum tersedia akan mengembalikan respons INVALID_REQUEST. Mencoba lagi permintaan dengan next_page_token yang sama akan mengembalikan laman hasil berikutnya.

Misalnya, dalam kueri di bawah ini, kami menelusuri restoran dekat Darling Harbour, Sydney, Australia, dan memeringkat hasilnya berdasarkan jarak. Anda bisa melihat bahwa respons berisi properti next_page_token.

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&rankby=distance&types=food&key=YOUR_API_KEY
{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867217,
               "lng" : 151.195939
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/cafe-71.png",
         "id" : "7eaf747a3f6dc078868cd65efc8d3bc62fff77d7",
         "name" : "Biaggio Cafe - Pyrmont",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAmWmj0BqA0Jorm1_vjAvx1n6c7ZNBxyY-U9x99-oNyOxvMjDlo2npJzyIq7c3EK1YyoNXdMFDcRPzwLJtBzXAwCUFDGo_RtLRGBPJTA2CoerPdC5yvT2SjfDwH4bFf5MrznB0_YWa4Y2Qo7ABtAxgeBIQv46sGBwVNJQDI36Wd3PFYBoUTlVXa0wn-zRITjGp0zLEBh8oIBE",
               "width" : 900
            }
         ],
         "place_id" : "ChIJIfBAsjeuEmsRdgu9Pl1Ps48",
         "scope" : "GOOGLE",
         "price_level" : 1,
         "rating" : 3.4,
         "reference" : "CoQBeAAAAGu0wNJjuZ40DMrRe3mpn7fhlfIK1mf_ce5hgkhfM79u-lqy0G2mnmcueTq2JGWu9wsgS1ctZDHTY_pcqFFJyQNV2P-kdhoRIeYRHeDfbWtIwr3RgFf2zzFBXHgNjSq-PSzX_OU6OT2_3dzdhhpV-bPezomtrarW4DsGl9uh773yEhDJT6R3V8Fyvl_xeE761DTCGhT1jJ3floFI5_c-bHgGLVwH1g-cbQ",
         "types" : [ "cafe", "bar", "restaurant", "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866786,
               "lng" : 151.195633
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
         "id" : "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6",
         "name" : "Doltone House",
         "photos" : [
            {
               "height" : 1260,
               "html_attributions" : [ "From a Google User" ],
               "photo_reference" : "CnRwAAAAeM-aLqAm573T44qnNe8bGMkr_BOh1MOVQaA9CCggqtTwuGD1rjsviMyueX_G4-mabgH41Vpr8L27sh-VfZZ8TNCI4FyBiGk0P4fPxjb5Z1LrBZScYzM1glRxR-YjeHd2PWVEqB9cKZB349QqQveJLRIQYKq2PNlOM0toJocR5b_oYRoUYIipdBjMfdUyJN4MZUmhCsTMQwg",
               "width" : 1890
            }
         ],
         "place_id" : "ChIJ5xQ7szeuEmsRs6Kj7YFZE9k",
         "scope" : "GOOGLE",
         "reference" : "CnRvAAAA22k1PAGyDxAgHZk6ErHh_h_mLUK_8XNFLvixPJHXRbCzg-gw1ZxdqUwA_8EseDuEZKolBs82orIQH4m6-afDZV9VcpggokHD9x7HdMi9TnJDmGb9Bdh8f-Od4DK0fASNBL7Me3CsAWkUMWhlNQNYExIQ05W7VbxDTQe2Kh9TiL840hoUZfiO0q2HgDHSUyRdvTQx5Rs2SBU",
         "types" : [ "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "aspects" : [
            {
               "rating" : 23,
               "type" : "overall"
            }
         ],
      ...
   ],
   "status" : "OK"
}

Untuk melihat serangkaian hasil berikutnya, Anda mengirim kueri baru, dengan meneruskan hasil next_page_token ke parameter pagetoken. Misalnya:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

Setelan pagetoken akan menyebabkan parameter lain diabaikan. Kueri akan menjalankan penelusuran yang sama seperti sebelumnya, namun akan mengembalikan sekumpulan hasil baru. Anda bisa meminta laman baru hingga dua kali setelah kueri asal. Setiap laman hasil harus ditampilkan bergantian. Dua atau beberapa laman hasil penelusuran tidak boleh ditampilkan sebagai hasil satu kueri. Perhatikan, setiap penelusuran dihitung sebagai satu permintaan terhadap batas penggunaan Anda.

Parameter sensor

Google Places API 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