Link ke Google Maps

Places API (Baru) menerima permintaan data tempat melalui berbagai metode. Respons Places API (Baru) berisi data tentang suatu tempat, termasuk data lokasi dan gambar, lokasi geografis, serta tempat menarik yang penting.

Respons dari Text Search (Baru), Nearby Search (Baru), dan Place Details (Baru) 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 kemudian menyertakan Bandara Internasional San Francisco (SFO) dalam daftar tempat. Objek Place untuk SFO dalam respons menambahkan kolom googleMapsUri yang berisi link Google Maps untuk membuka Google Maps ke tempat tersebut, rute ke tempat tersebut, ulasan tentang tempat tersebut, dan foto tempat tersebut.

Selain link yang ditambahkan ke objek Place, kolom googleMapsUri juga ditambahkan 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!

Link Google Maps yang didukung untuk suatu tempat

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

Menyertakan semua link dalam respons Places

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

Misalnya, Text Search (Baru) 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"
      }
    }
  ]
}

Menyertakan link tertentu dalam respons

Anda tidak harus menampilkan semua link dalam respons. Misalnya, jika Anda hanya menginginkan 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 rute 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 Nearby Search (Baru) 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

Menyertakan link ulasan dan foto

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

Misalnya, Text Search (Baru) 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 permintaan contoh sehingga Anda dapat memahami API dan opsi API.

1. Pilih ikon API api di sisi kanan halaman.

2. Jika ingin, luaskan Tampilkan parameter standar dan tetapkan parameter fields ke mask kolom.

3. Jika ingin, edit Isi permintaan.

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

5. Di panel API Explorer, pilih fullscreen

   Layar penuh untuk meluaskan jendela API Explorer.