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, dan lokasi menarik terkemuka.

Respons dari Text Search (Baru), Nearby Search (Baru), dan Place Details (Baru) juga dapat berisi link ke Google Maps. Pengguna Anda 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, petunjuk arah ke tempat, ulasan tentang tempat, dan foto tempat.

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 menunjukkan link Google Maps yang dapat Anda sertakan dalam respons:

Sertakan semua link dalam respons Places

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 (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 perlu 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'

Sertakan 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 perjalanannya adalah mengemudi.

Contoh berikutnya menggunakan Nearby Search (Baru) untuk menyertakan link petunjuk arah 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

Sertakan link ulasan dan foto

Rilis ini menambahkan kolom googleMapsUri ke objek Reviews dan Photos 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 contoh permintaan sehingga Anda dapat memahami API dan opsi API.

1. Pilih ikon api API di sisi kanan halaman.

2. Jika perlu, luaskan Tampilkan parameter standar dan tetapkan parameter fields ke masker kolom.

3. Edit Isi permintaan jika perlu.

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.