Link ke Google Maps

Places API menerima permintaan untuk data tempat melalui berbagai metode. Respons Places API berisi data tentang suatu tempat, termasuk data dan gambar lokasi, lokasi geografis, dan lokasi menarik yang terkemuka.

Dengan rilis ini, respons dari Text Search, Nearby Search, dan Place Details juga dapat berisi link ke Google Maps. Pengguna dapat membuka link Google Maps ini untuk melihat informasi tambahan tentang suatu tempat dalam respons.

Misalnya, Anda menelusuri bandara di San Francisco, California. Respons tersebut kemudian menyertakan Bandara Internasional San Francisco (SFO) dalam daftar tempat. Dengan rilis ini, objek Place untuk SFO dalam respons akan menambahkan kolom googleMapsUri yang berisi link Google Maps untuk membuka Google Maps ke tempat, rute ke tempat, ulasan tempat, dan foto tempat.

Bersama dengan link yang ditambahkan ke objek Place, rilis ini juga menambahkan kolom googleMapsUri ke objek Reviews dan Photos dalam respons:

  • Reviews.googleMapsUri: Berisi link Google Maps ke ulasan sehingga Anda dapat melihatnya di browser.

  • Photos.googleMapsUri: Berisi link Google Maps ke foto sehingga Anda dapat melihatnya di browser.

API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami opsi baru ini:

Cobalah!

Tabel berikut menampilkan link Google Maps yang dapat Anda sertakan dalam respons:

Link Google Maps Deskripsi Nama kolom
Tempat Link untuk membuka Google Maps ke tempat tersebut. googleMapsLinks.placeUri
Rute Link untuk membuka rute ke tempat di Google Maps. googleMapsLinks.directionsUri
Tulis ulasan Link untuk menulis ulasan tempat di Google Maps. googleMapsLinks.writeAReviewUri
Baca ulasan Link untuk menampilkan ulasan Google Maps tentang tempat tersebut. googleMapsLinks.reviewsUri
Foto Link untuk menampilkan foto tempat di Google Maps. googleMapsLinks.photosUri

Harga

Fitur ini berada dalam tahap Pratinjau pra-GA dan tidak dikenai biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau. Untuk mengetahui detail tentang harga yang diusulkan, lihat Penggunaan dan Penagihan Places API.

Link dalam respons tempat terdapat di kolom googleMapsLinks. Pastikan untuk menyertakan kolom googleMapsLinks dalam mask kolom permintaan jika Anda ingin kolom tersebut muncul dalam respons.

Misalnya, Penelusuran Teks berikut menyertakan semua link Maps dalam respons:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

Responsnya dalam bentuk:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Anda tidak perlu menampilkan semua link dalam respons. Misalnya, jika Anda hanya ingin link foto dalam respons, ubah mask kolom seperti yang ditunjukkan di bawah untuk hanya menyertakan kolom photosUri:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Menyertakan petunjuk dalam respons

Semua metode Places mendukung pembuatan link rute dalam respons. Lokasi saat ini digunakan sebagai asal, lokasi tempat digunakan sebagai tujuan, dan mode perjalanan adalah berkendara.

Contoh berikutnya menggunakan Penelusuran Langsung untuk menyertakan link rute peta dalam respons di kolom directionsUri:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Rilis ini menambahkan kolom googleMapsUri ke objek Reviews dan Photos dalam respons. Membuka link ini akan menampilkan ulasan atau foto di Google Maps.

Misalnya, Penelusuran Teks berikut menyertakan ulasan dan foto untuk setiap tempat dalam respons:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

Dalam respons, setiap elemen array ulasan dan foto berisi kolom googleMapsUri untuk membuka ulasan atau foto di browser.

Cobalah!

API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.

  1. Pilih ikon API, Luaskan API Explorer., di sisi kanan halaman.

  2. Secara opsional, luaskan Tampilkan parameter standar dan tetapkan parameter fields ke mask kolom.

  3. Jika ingin, edit Isi permintaan.

  4. Pilih tombol Execute. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.

  5. Di panel API Explorer, pilih ikon luaskan, Luaskan API Explorer., untuk meluaskan jendela API Explorer.