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 Photos

Layanan Place Photo, bagian dari Google Places API Web Service, adalah API hanya-baca yang memungkinkan menambahkan materi fotografi berkualitas tinggi ke aplikasi Anda. Layanan Place Photo memberi Anda akses ke jutaan foto yang tersimpan dalam database Places dan Google+ Local. Bila Anda mengambil informasi tempat menggunakan permintaan Place Details, referensi foto akan dikembalikan untuk materi fotografi yang relevan. Permintaan Nearby Search dan Text Search juga akan mengembalikan referensi foto tunggal per tempat, bila relevan. Dengan layanan Photo, Anda kemudian bisa mengakses foto yang direferensikan dan mengubah ukuran gambar ke ukuran yang optimal untuk aplikasi Anda.

Referensi Foto

Semua permintaan ke layanan Place Photo harus menyertakan photoreference, yang dikembalikan sebagai respons terhadap permintaan Nearby Search, Text Search, atau Place Details. Respons terhadap permintaan ini akan berisi bidang photos[] jika tempat tersebut memiliki materi fotografi yang terkait.

Catatan: Jumlah foto yang dikembalikan akan bervariasi menurut permintaan.

  • Nearby Search atau Text Search akan mengembalikan paling banyak satu elemen photo dalam larik.
  • Radar Search tidak mengembalikan informasi foto.
  • Permintaan Details akan mengembalikan hingga sepuluh elemen photo.

Setiap elemen photo akan berisi bidang berikut:

  • 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.

Foto yang dikembalikan oleh layanan Photo berasal dari berbagai sumber, termasuk kontribusi foto dari pemilik bisnis dan pengguna Google+. Umumnya, foto ini bisa digunakan tanpa atribusi, atau mengharuskan dimasukkannya atribusi yang diperlukan sebagai bagian dari gambar. Akan tetapi, jika elemen photo yang dikembalikan menyertakan nilai dalam bidang html_attributions, maka Anda harus menyertakan atribusi tambahan dalam aplikasi di mana saja Anda menampilkan gambar tersebut.

Contoh larik photos[] ditampilkan di bawah ini.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Permintaan Place Photo

Permintaan Place Photo adalah URL HTTP dengan bentuk berikut:

https://maps.googleapis.com/maps/api/place/photo?parameters

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Daftar parameter dan kemungkinan nilainya disebutkan di bawah ini.

Parameter yang diperlukan

  • key — [Kunci API] aplikasi Andausingkeys. Kunci ini mengidentifikasi aplikasi Anda untuk keperluan manajemen kuota. Lihat Mendapatkan kunci untuk informasi selengkapnya.
  • photoreference — Sebuah identifier string yang secara unik mengidentifikasi foto. Referensi foto dikembalikan dari permintaan Place Search maupun Place Details.
  • maxheight atau maxwidth — Menetapkan tinggi maksimum atau lebar yang diinginkan, dalam piksel, atas gambar yang dikembalikan oleh layanan Place Photos. Jika gambar lebih kecil dari nilai yang ditetapkan, maka dikembalikan gambar asal. Jika gambar lebih besar dalam dimensi itu, gambar akan diubah skalanya agar cocok dengan kedua dimensi yang lebih kecil, dengan dibatasi oleh rasio aspek asalnya. Properti maxheight maupun maxwidth menerima integer antara 1 dan 1600.

Contoh permintaan ditampilkan di bawah ini. Permintaan ini akan mengembalikan gambar yang direferensikan, dengan mengubah ukurannya sehingga lebarnya maksimum 400 piksel.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Catatan: Anda perlu mengganti kunci API dalam contoh ini agar permintaan berhasil dalam aplikasi Anda.

Respons Place Photo

Respons permintaan Place Photo yang berhasil akan berupa gambar. Tipe gambar akan bergantung pada tipe foto asal yang dikirimkan.

Jika permintaan Anda melebihi kuota yang tersedia, server akan mengembalikan status HTTP 403 dan menampilkan gambar di bawah ini untuk menunjukkan bahwa kuota telah terlampaui:

gambar Melebihi Kuota

Jika server tidak bisa memahami permintaan Anda, server akan mengembalikan status HTTP 400, yang menunjukkan permintaan tidak valid. Sebab paling umum yang membuat Anda mungkin melihat permintaan tidak valid antara lain:

  • Salah menetapkan referensi foto yang dikirimkan.
  • Permintaan Anda tidak menyertakan parameter maxwidth atau maxheight.

Pesan Kesalahan

Bila layanan Places mengembalikan status HTTP 400, mungkin ada bidang tambahan error_message dalam objek respons. Bidang ini berisi informasi lebih detail tentang alasan di balik kode status.

Parameter sensor

Google Places API Web Service sebelumnya mengharuskan Anda menyertakan parameter sensoruntuk 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