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 Details

Setelah memiliki place_id atau reference dari Place Search, Anda bisa meminta detail selengkapnya tentang tempat usaha atau tempat menarik tertentu dengan membuat permintaan Place Details. Permintaan Place Details mengembalikan informasi yang lebih komprehensif tentang tempat yang ditunjukkan seperti alamat lengkap, nomor telepon, peringkat pengguna, dan ulasan.

Permintaan Place Details

Permintaan Place Details adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/details/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 (&). Di bawah ini adalah daftar parameter dan kemungkinan nilainya.

  • key (diperlukan) — Kunci 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.
  • Pilih placeid atau reference (Anda harus memberikan salah satunya, namun jangan keduanya):
    • placeid — Sebuah identifier tekstual yang secara unik mengidentifikasi tempat, dikembalikan dari Place Search. Untuk informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.
    • reference — Sebuah identifier tekstual yang secara unik mengidentifikasi tempat, dikembalikan dari Place Search. Catatan: reference sekarang tidak digunakan lagi karena sudah ada placeid. Lihat pemberitahuan penghentian pada laman ini.
Parameter Opsional
  • extensions (opsional) — Menunjukkan apakah respons Place Details harus menyertakan bidang tambahan. Bidang tambahan mungkin menyertakan data premium, yang memerlukan lisensi tambahan, atau nilai yang tidak biasa diminta. Ekstensi saat ini bersifat eksperimen. Nilai yang didukung untuk parameter ekstensi adalah:
    • review_summary menyertakan ulasan lengkap dan ringkas yang disusun oleh staf editorial Google.
  • language (opsional) — Kode bahasa, yang menunjukkan dalam bahasa apa hasilnya akan dikembalikan, jika memungkinkan. Perhatikan, beberapa bidang mungkin tidak tersedia dalam bahasa yang diminta. Lihat daftar bahasa yang didukung dan kodenya. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.

Contoh berikut meminta detail tempat melalui placeid:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4&key=YOUR_API_KEY

Perhatikan, Anda perlu mengganti kunci dalam contoh ini dengan kunci API Anda sendiri agar permintaan bisa berhasil dalam aplikasi Anda.

Contoh berikut menggunakan parameter yang tidak digunakan lagi yaitu reference:

https://maps.googleapis.com/maps/api/place/details/json?reference=CmRYAAAAciqGsTRX1mXRvuXSH2ErwW-jCINE1aLiwP64MCWDN5vkXvXoQGPKldMfmdGyqWSpm7BEYCgDm-iv7Kc2PF7QA7brMAwBbAcqMr5i1f4PwTpaovIZjysCEZTry8Ez30wpEhCNCXpynextCld2EBsDkRKsGhSLayuRyFsex6JA6NPh9dyupoTH3g&key=YOUR_API_KEY

Respons Place Details

Respons Place Details dikembalikan dalam format yang ditandai oleh flag output dalam jalur URL permintaan itu.


JSON
{
   "html_attributions" : [],
   "result" : {
      "address_components" : [
         {
            "long_name" : "48",
            "short_name" : "48",
            "types" : [ "street_number" ]
         },
         {
            "long_name" : "Pirrama Road",
            "short_name" : "Pirrama Road",
            "types" : [ "route" ]
         },
         {
            "long_name" : "Pyrmont",
            "short_name" : "Pyrmont",
            "types" : [ "locality", "political" ]
         },
         {
            "long_name" : "NSW",
            "short_name" : "NSW",
            "types" : [ "administrative_area_level_1", "political" ]
         },
         {
            "long_name" : "AU",
            "short_name" : "AU",
            "types" : [ "country", "political" ]
         },
         {
            "long_name" : "2009",
            "short_name" : "2009",
            "types" : [ "postal_code" ]
         }
      ],
      "formatted_address" : "48 Pirrama Road, Pyrmont NSW, Australia",
      "formatted_phone_number" : "(02) 9374 4000",
      "geometry" : {
         "location" : {
           "lat" : -33.8669710,
           "lng" : 151.1958750
         },
         "viewport" : {
            "northeast" : {
               "lat" : -33.8665053,
               "lng" : 151.1960371
            },
            "southwest" : {
               "lat" : -33.8669293,
               "lng" : 151.1952183
            }
         }
      },
      "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
      "id" : "4f89212bf76dde31f092cfc14d7506555d85b5c7",
      "international_phone_number" : "+61 2 9374 4000",
      "name" : "Google Sydney",
      "place_id" : "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "scope" : "GOOGLE",
      "alt_ids" : [
         {
            "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
            "scope" : "APP"
         }
      ],
      "rating" : 4.70,
      "reference" : "CnRsAAAA98C4wD-VFvzGq-KHVEFhlHuy1TD1W6UYZw7KjuvfVsKMRZkbCVBVDxXFOOCM108n9PuJMJxeAxix3WB6B16c1p2bY1ZQyOrcu1d9247xQhUmPgYjN37JMo5QBsWipTsnoIZA9yAzA-0pnxFM6yAcDhIQbU0z05f3xD3m9NQnhEDjvBoUw-BdcocVpXzKFcnMXUpf-nkyF1w",
      "reviews" : [
         {
            "aspects" : [
               {
                  "rating" : 3,
                  "type" : "quality"
               }
            ],
            "author_name" : "Simon Bengtsson",
            "author_url" : "https://plus.google.com/104675092887960962573",
            "language" : "en",
            "rating" : 5,
            "text" : "Just went inside to have a look at Google. Amazing.",
            "time" : 1338440552869
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Felix Rauch Valenti",
            "author_url" : "https://plus.google.com/103291556674373289857",
            "language" : "en",
            "rating" : 5,
            "text" : "Best place to work :-)",
            "time" : 1338411244325
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Chris",
            "language" : "en",
            "rating" : 5,
            "text" : "Great place to work, always lots of free food!",
            "time" : 1330467089039
         }
      ],
      "types" : [ "establishment" ],
      "url" : "http://maps.google.com/maps/place?cid=10281119596374313554",
      "vicinity" : "48 Pirrama Road, Pyrmont",
      "website" : "http://www.google.com.au/"
   },
   "status" : "OK"
}
      
XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Sydney</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Road, Pyrmont NSW, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Road</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>NSW</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>AU</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
     <lat>-33.8669710</lat>
     <lng>151.1958750</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8669293</lat>
     <lng>151.1952183</lng>
    </southwest>
    <northeast>
     <lat>-33.8665053</lat>
     <lng>151.1960371</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.7</rating>
  <url>http://maps.google.com/maps/place?cid=10281119596374313554</url>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png</icon>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CnRsAAAAoGXc0eAcQOoO1A7sU58repRnghwM5q7UtsZFhVtjYtfKN_LFAPhdhBfUAU8m0EzeSyP0cDBi7kazZwNjlIMUqktqIanMiymuRDS8c539M6KCJNUMkjw22WXxtl3QoR25fIf-7YJnpza6bMIuFZ1CKBIQuBsbXu8xkbUNofECCkdvmxoU5k3Lpbr8XNCbofIKtsZxj8GloGA</reference>
  <id>4f89212bf76dde31f092cfc14d7506555d85b5c7</id>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://www.google.com.au/</website>
  <review>
   <time>1338440552869</time>
   <text>Just went inside to have a look at Google. Amazing.</text>
   <author_name>Simon Bengtsson</author_name>
   <author_url>https://plus.google.com/104675092887960962573</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1338411244325</time>
   <text>Best place to work :-)</text>
   <author_name>Felix Rauch Valenti</author_name>
   <author_url>https://plus.google.com/103291556674373289857</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1330467089039</time>
   <text>Great place to work, always lots of free food!</text>
   <author_name>Chris</author_name>
   <author_url>https://maps.google.com/maps/user?uid=211457841236072500285</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
 </result>
</PlaceDetailsResponse>

Respons JSON berisi tiga elemen akar:

  • "status" berisi metadata yang diminta. Lihat Kode Status di bawah ini.
  • "result" berisi informasi detail tentang tempat yang diminta. Lihat Hasil Place Details untuk informasi tentang hasil ini.
  • "html_attributions" berisi satu set atribusi tentang daftar ini yang harus ditampilkan kepada pengguna.

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

Sebuah respons XML terdiri dari satu elemen <PlaceDetailsResponse> dan tiga elemen tingkat atas:

  • <status> berisi metadata yang diminta. Lihat Kode Status.
  • Satu elemen <result> berisi informasi detail tentang satu tempat usaha. Lihat Hasil Place Details untuk informasi tentang hasil ini.
  • <html_attributions> berisi satu set atribusi yang harus ditampilkan kepada pengguna.

Lihat Mem-parse XML dengan XPath untuk mengetahui beberapa pola desain yang disarankan bagi pemrosesan keluaran.

Kode Status

Bidang "status" dalam objek respons Place 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.
  • UNKNOWN_ERROR menunjukkan kesalahan pada server; mencobanya lagi mungkin akan berhasil.
  • ZERO_RESULTS menunjukkan referensi tersebut valid namun tidak lagi merujuk pada hasil yang valid. Hal ini dapat terjadi jika tempat usaha itu tidak lagi beroperasi.
  • 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 kueri (reference) tidak ada.
  • NOT_FOUND menunjukkan lokasi yang direferensikan tidak ditemukan dalam database Places.

Pesan Kesalahan

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

Hasil Place Details

Bila Places Service mengembalikan hasil dari permintaan detail, hasilnya akan dimasukkan dalam satu result. Setiap hasil dapat berisi bidang berikut:

  • address_components[] adalah larik komponen alamat terpisah yang digunakan untuk menulis alamat yang diberikan. Misalnya, alamat "111 8th Avenue, New York, NY" berisi komponen alamat terpisah untuk "111" (nomor rumah, "8th Avenue" (rute), "New York" (kota) dan "NY" (negara bagian AS). Setiap address_component biasanya berisi:
    • types[] adalah larik yang menunjukkan tipe komponen alamat.
    • long_name adalah keterangan teks lengkap atau nama komponen alamat.
    • short_name adalah nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara bagian Alaska dapat memiliki long_name "Alaska" dan short_name "AK" dengan menggunakan 2 huruf singkatan istilah pos.
  • formatted_address adalah string berisi alamat yang bisa dibaca orang untuk tempat ini. Sering kali alamat ini sama dengan "alamat pos", yang terkadang berbeda antara satu negara dengan negara lainnya. Alamat ini biasanya terdiri dari satu atau beberapa bidang address_component.
  • formatted_phone_number berisi nomor telepon tempat tersebut dalam format lokalnya. Misalnya, formatted_phone_number untuk kantor Google di Sydney, Australia adalah (02) 9374 4000.
  • geometry berisi informasi berikut:
    • location berisi nilai geocode dari garis lintang dan garis bujur untuk tempat ini.
    • viewport berisi tampilan yang terlihat dan diutamakan saat menampilkan tempat ini pada peta sebagai LatLngBounds jika diketahui.
  • icon berisi URL dari ikon yang disarankan untuk ditampilkan kepada pengguna saat menunjukkan hasilnya pada peta.
  • id berisi sebuah identifier unik dan stabil yang menandakan tempat ini. Identifier ini tidak boleh digunakan untuk mengambil informasi tentang tempat ini, namun bisa digunakan untuk mengkonsolidasikan data tentang tempat ini, dan untuk memverifikasi identitas tempat di semua penelusuran terpisah. Karena ID kadang-kadang bisa berubah, disarankan agar ID tempat yang tersimpan dibandingkan dengan ID yang dikembalikan dalam permintaan Details selanjutnya untuk tempat yang sama, dan diperbarui jika diperlukan. Catatan: id sekarang tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
  • international_phone_number berisi nomor telepon tempat tersebut dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Misalnya, international_phone_number untuk kantor Google di Sydney, Australia adalah +61 2 9374 4000.
  • name berisi nama yang bisa dibaca orang untuk hasil yang dikembalikan. Untuk hasil establishment, biasanya berisi nama bisnis resmi.
  • opening_hours berisi informasi berikut:
    • open_now adalah nilai boolean yang menunjukkan apakah tempat itu buka pada waktu saat ini.
    • periods[] adalah larik jangka waktu buka yang mencakup tujuh hari, mulai dari hari Minggu, dalam urutan kronologis. Setiap jangka waktu berisi:
      • open berisi sepasang objek hari dan waktu yang menjelaskan kapan tempat tersebut buka:
        • day angka 0–6, yang menyatakan hari-hari dalam seminggu, mulai hari Minggu. Misalnya, 2 berarti Selasa.
        • time berisi waktu dalam sehari dengan format 24 jam hhmm. Nilainya berkisar 0000-2359. time akan dilaporkan dengan zona waktu tempat tersebut.
      • close berisi pasangan objek hari dan waktu yang menjelaskan kapan tempat tersebut tutup. Catatan: Jika sebuah tempat selalu buka, bagian close akan menghilang dari respons. Klien bisa berpatokan pada kondisi selalu-buka yang direpresentasikan sebagai jangka waktu open yang berisi day dengan nilai 0 dan time dengan nilai 0000, dan tidak close.
    • weekday_text adalah larik berisi tujuh string yang menyatakan jam buka yang telah diformat untuk setiap hari dalam seminggu. Jika parameter language telah ditetapkan dalam permintaan Place Details, Places Service akan memformat dan melokalkan jam buka sesuai dengan bahasa itu. Urutan elemen dalam larik ini bergantung pada parameter language. Beberapa bahasa memulai pekan pada hari Senin sementara yang lain mulai pada hari Minggu.
  • 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.
  • photos[] — adalah larik objek photo, masing-masing berisi referensi ke sebuah gambar. Permintaan Place Details dapat 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.
  • 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 yang bisa digunakan untuk kueri layanan Details di masa mendatang. Token ini mungkin berbeda dari referensi yang digunakan dalam permintaan ke layanan Details. Disarankan agar referensi tempat yang tersimpan diperbarui secara rutin. Meskipun token ini secara unik mengidentifikasi tempat, hal yang sebaliknya tidak berlaku. Sebuah tempat bisa memiliki banyak token referensi yang valid. Catatan: reference sekarang tidak digunakan lagi karena sudah ada place_id. Lihat pemberitahuan penghentian pada laman ini.
  • reviews[] larik JSON yang berisi hingga lima ulasan. Jika parameter language telah ditetapkan dalam permintaan Place Details, Places Service akan mencondongkan hasilnya untuk lebih memilih ulasan yang ditulis dalam bahasa itu. Setiap ulasan terdiri dari beberapa komponen:
    • aspects berisi kumpulan objek AspectRating, masing-masing memberikan peringkat atribut tunggal untuk tempat usaha tersebut. Objek pertama dalam kumpulan dianggap sebagai aspek utama. 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 pengguna untuk aspek tertentu, dari 0 hingga 3.
    • author_name nama pengguna yang menyerahkan ulasan. Ulasan anonim diatribusikan dengan "Pengguna Google".
    • author_url URL ke profil pengguna Google+, jika tersedia.
    • language kode bahasa IETF yang menunjukkan bahasa yang digunakan dalam ulasan pengguna. Bidang ini berisi tag bahasa utama saja, dan bukan tag sekunder yang menunjukkan negara atau region. Misalnya, semua ulasan dalam bahasa Inggris akan diberi tag 'en', dan bukan 'en-AU' atau 'en-UK' dan seterusnya.
    • rating peringkat keseluruhan pengguna untuk tempat ini. Ini adalah bilangan bulat, berkisar dari 1 hingga 5.
    • text ulasan pengguna. Saat mengulas sebuah lokasi dengan Google Places, ulasan teks dianggap opsional. Karena itu, bidang ini mungkin kosong. Perhatikan, bidang ini mungkin menyertakan markup HTML sederhana. Misalnya, referensi entitas &amp; dapat menyatakan karakter ampersand.
    • time waktu pengiriman ulasan, diukur dalam jumlah detik sejak tengah malam, 1 Januari 1970 UTC.
  • 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.
  • url berisi URL laman resmi Google untuk tempat ini. Ini akan menjadi laman milik Google yang berisi informasi terbaik yang tersedia tentang tempat ini. Aplikasi harus menautkan ke atau menyematkan laman ini pada setiap layar yang menampilkan hasil detail tentang tempat itu kepada pengguna.
  • utc_offset berisi offset jumlah menit antara zona waktu tempat ini sekarang dari UTC. Misalnya, untuk tempat di Sydney, Australia saat terjadi penyesuaian waktu di musim panas akan menjadi 660 (+11 jam dari UTC), dan untuk tempat di California di luar penyesuaian waktu di musim panas akan menjadi -480 menit (-8 jam dari UTC).
  • vicinity daftar alamat yang disederhanakan untuk tempat, termasuk nama jalan, nomor rumah, dan lokalitas, namun tidak termasuk provinsi/negara bagian, kode pos, atau negara. Misalnya, kantor Google di Sydney, Australia memiliki nilai vicinity 48 Pirrama Road, Pyrmont.
  • website mencantumkan situs web resmi untuk tempat ini, seperti laman beranda bisnis.

Peringkat multidimensi mungkin tidak tersedia untuk semua lokasi. Jika ulasan terlalu sedikit maka detail respons akan menyertakan peringkat lawas dengan skala 1,0 hingga 5,0 (jika tersedia) atau tidak ada peringkat sama sekali.

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 kumpulan objek AspectRating, masing-masing memberikan peringkat gabungan atribut tunggal untuk tempat usaha tersebut. Objek pertama dalam kumpulan dianggap sebagai aspek utama. Setiap AspectRating dijelaskan sebagai:
    • type nama aspek yang akan diberi peringkat. Misalnya, suasana, layanan, makanan, keseluruhan, dll.
    • 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.
  • review_summary menyertakan ulasan lengkap dan ringkas yang disusun oleh staf editorial Google. Bidang ini tidak akan ada kecuali Anda meneruskan parameter extensions=review_summary dalam permintaan detail. Perhatikan, bidang ini mungkin tidak tersedia dalam bahasa yang diminta.
  • 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.

Contoh berikut menampilkan bagaimana bidang-bidang aspects dan review_summary muncul dalam isi respons:

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."

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