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 dan citra lokasi, lokasi geografis, dan tempat menarik yang menonjol.

Respons dari Penelusuran Teks (Baru), Penelusuran Terdekat (Baru), dan Detail Tempat (Baru) juga dapat berisi tautan ke Google Maps. Pengguna Anda dapat menelusuri tautan 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.

Bersamaan dengan tautan yang ditambahkan ke objek Place, kolom googleMapsUri juga ditambahkan ke objek Reviews dan Photos dalam respons:

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

  • Photos.googleMapsUri: Berisi tautan Google Maps ke foto sehingga Anda dapat melihatnya di peramban.

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

Cobalah!

Tabel berikut menunjukkan tautan Google Maps yang dapat Anda sertakan dalam respons:

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

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"
      }
    }
  ]
}

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

    Layar Penuh untuk meluaskan jendela API Explorer.