Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Place Details (Baru)

Pilih platform: Android iOS JavaScript Layanan Web

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Setelah memiliki ID Tempat, Anda dapat meminta detail selengkapnya tentang tempat atau lokasi menarik tertentu dengan memulai permintaan Place Details (Baru). Permintaan Place Details (Baru) menampilkan informasi yang lebih komprehensif tentang tempat yang ditunjukkan, seperti alamat lengkap, nomor telepon, rating pengguna dan ulasan.

Ada banyak cara untuk mendapatkan ID tempat. Anda dapat menggunakan:

APIs Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami API dan opsi API:

Cobalah!

Permintaan Place Details (Baru)

Permintaan Place Details (Baru) adalah permintaan HTTP GET dalam bentuk:

https://places.googleapis.com/v1/places/PLACE_ID

Teruskan semua parameter sebagai parameter URL atau di header sebagai bagian dari permintaan GET. Contoh:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Atau dalam perintah curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Respons Place Details (Baru)

Place Details (Baru) menampilkan objek JSON sebagai respons. Dalam respons:

Respons direpresentasikan oleh a Place objek. Objek Place berisi informasi mendetail tentang tempat tersebut.
FieldMask yang diteruskan dalam permintaan menentukan daftar kolom yang ditampilkan dalam objek Place.

Objek JSON lengkap dalam bentuk:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Parameter yang diperlukan

FieldMask

Tentukan daftar kolom yang akan ditampilkan dalam respons dengan membuat mask kolom respons. Teruskan mask kolom respons ke metode menggunakan parameter URL $fields atau fields, atau menggunakan header HTTP X-Goog-FieldMask. Tidak ada daftar kolom default yang ditampilkan dalam respons. Jika Anda menghapus mask kolom, metode akan menampilkan error.

Penggunaan mask kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.

Tentukan daftar jenis data tempat yang dipisahkan koma yang akan ditampilkan. Misalnya, untuk mengambil nama tampilan dan alamat tempat.
```
X-Goog-FieldMask: displayName,formattedAddress
```
Catatan: Spasi tidak diizinkan di mana pun dalam daftar kolom.

Gunakan * untuk mengambil semua kolom.
```
X-Goog-FieldMask: *
```
Meskipun karakter pengganti (*) dapat digunakan dalam pengembangan, Google tidak menganjurkan penggunaan mask kolom respons karakter pengganti dalam produksi karena banyaknya data yang dapat ditampilkan.

Panduan lebih lanjut untuk menggunakan iconMaskBaseUri dan iconBackgroundColor dapat ditemukan di bagian Ikon Tempat.

Tentukan satu atau beberapa kolom berikut:
- Kolom berikut memicu SKU Place Details Essentials IDs Only:
  
  attributions
  consumerAlert
  id
  movedPlace
  movedPlaceId
  name^*
  photos
  
  ^* Kolom name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Untuk mendapatkan nama teks tempat, minta kolom displayName di SKU Pro.
  
  Untuk daftar lengkap kolom dan SKU terkait, lihat Kolom Data Tempat (Baru).
- Kolom berikut memicu SKU Place Details Essentials:
  
  addressComponents
  addressDescriptor^*
  adrFormatAddress
  formattedAddress
  location
  plusCode
  postalAddress
  shortFormattedAddress
  types
  viewport
  
  ^* Deskriptor alamat umumnya tersedia untuk pelanggan di India dan bersifat eksperimental di tempat lain.
  
  Untuk daftar lengkap kolom dan SKU terkait, lihat Kolom Data Tempat (Baru).
- Kolom berikut memicu SKU Place Details Pro:
  
  accessibilityOptions
  businessStatus
  containingPlaces
  displayName
  googleMapsLinks
  googleMapsTypeLabel
  googleMapsUri
  iconBackgroundColor
  iconMaskBaseUri
  openingDate
  primaryType
  primaryTypeDisplayName
  pureServiceAreaBusiness
  subDestinations
  timeZone
  utcOffsetMinutes
  
  Untuk daftar lengkap kolom dan SKU terkait, lihat Kolom Data Tempat (Baru).
- Kolom berikut memicu SKU Place Details Enterprise:
  
  currentOpeningHours
  currentSecondaryOpeningHours
  internationalPhoneNumber
  nationalPhoneNumber
  priceLevel
  priceRange
  rating
  regularOpeningHours
  regularSecondaryOpeningHours
  transitStation
  userRatingCount
  websiteUri
  Untuk daftar lengkap kolom dan SKU terkait, lihat Kolom Data Tempat (Baru).
- Kolom berikut memicu SKU Place Details Enterprise + Atmosphere:
  
  allowsDogs
  curbsidePickup
  delivery
  dineIn
  editorialSummary
  evChargeAmenitySummary
  evChargeOptions
  fuelOptions
  generativeSummary
  goodForChildren
  goodForGroups
  goodForWatchingSports
  liveMusic
  menuForChildren
  neighborhoodSummary
  parkingOptions
  paymentOptions
  outdoorSeating
  reservable
  restroom
  reviews
  reviewSummary
  routingSummaries^*
  servesBeer
  servesBreakfast
  servesBrunch
  servesCocktails
  servesCoffee
  servesDessert
  servesDinner
  servesLunch
  servesVegetarianFood
  servesWine
  takeout
  
  ^* Text Search dan Nearby Search saja
  Untuk daftar lengkap kolom dan SKU terkait, lihat Kolom Data Tempat (Baru).
placeId

ID tekstual yang secara unik mengidentifikasi tempat, yang ditampilkan dari Text Search (Baru) atau Nearby Search (Baru). Untuk mengetahui informasi selengkapnya tentang ID tempat, lihat ringkasan ID tempat.

String places/PLACE_ID juga disebut nama resource tempat. Dalam respons dari permintaan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) permintaan, string ini terdapat di kolom name respons. ID tempat mandiri terdapat di kolom id respons.

Catatan: Di Place Details (Legacy), kolom name respons berisi nama tempat yang dapat dibaca manusia. Di API baru, kolom tersebut kini disebut displayName.

Parameter opsional

languageCode

Bahasa yang akan digunakan untuk menampilkan hasil.
- Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
- Jika languageCode tidak diberikan, API akan menggunakan en sebagai default. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
- API akan berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API akan menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika diperlukan, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Semua komponen alamat ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
- Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan hasil tersebut ditampilkan. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain.
regionCode

Kode wilayah yang digunakan untuk memformat respons, yang ditentukan sebagai nilai kode CLDR dua karakter. Tidak ada nilai default.

Jika nama negara di kolom formattedAddress dalam respons cocok dengan regionCode, kode negara akan dihilangkan dari formattedAddress. Parameter ini tidak berpengaruh pada adrFormatAddress, yang selalu menyertakan nama negara atau pada shortFormattedAddress, yang tidak pernah menyertakannya.

Sebagian besar kode CLDR identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk), sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
sessionToken

Token sesi adalah string yang dibuat pengguna yang melacak panggilan Autocomplete (Baru) sebagai "sesi." Autocomplete (Baru) menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan tempat dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan. Token sesi diteruskan ke panggilan Place Details (Baru) yang mengikuti panggilan Autocomplete (Baru). Untuk mengetahui informasi selengkapnya, lihat Token sesi.

Contoh Place Details (Baru)

Contoh berikut meminta detail tempat berdasarkan placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Perhatikan bahwa header X-Goog-FieldMask menentukan bahwa respons berisi kolom data berikut: id,displayName. Responsnya kemudian dalam bentuk:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Tambahkan lebih banyak jenis data ke mask kolom untuk menampilkan informasi tambahan. Misalnya, tambahkan formattedAddress,plusCode untuk menyertakan alamat dan Kode Plus dalam respons:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Responsnya sekarang dalam bentuk:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Mendapatkan deskriptor alamat

Deskriptor alamat memberikan informasi relasional tentang lokasi tempat, termasuk landmark terdekat dan area yang berisi.

Catatan: Deskriptor alamat umumnya tersedia untuk pelanggan di India dan bersifat eksperimental di tempat lain. Permintaan Places API yang hanya menggunakan addressDescriptor di mask kolom akan ditagih di SKU: Places API Place Details Essentials.

Contoh berikut menunjukkan permintaan Place Details (Baru) untuk department store di mal San Jose. Dalam contoh ini, Anda menyertakan addressDescriptors di mask kolom:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

Respons mencakup tempat yang ditentukan dalam permintaan, daftar landmark terdekat dan jaraknya dari tempat tersebut, serta daftar area dan hubungan penampungannya dengan tempat tersebut:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Mendapatkan detail tempat untuk tempat yang dipindahkan

Jika tempat yang dirujuk di aplikasi Anda telah dipindahkan, Anda dapat menggunakan movedPlace dan movedPlaceId kolom untuk mendapatkan detail tempat baru.

Untuk tempat yang ditutup permanen, Place Details (Baru) menampilkan CLOSED_PERMANENTLY di kolom businessStatus dan menghapus kolom movedPlace dan movedPlaceId di isi respons.

Untuk tempat yang dipindahkan ke lokasi baru, Place Details (Baru) menampilkan CLOSED_PERMANENTLY di kolom businessStatus dan menampilkan lokasi baru di kolom movedPlace dan movedPlaceId di isi respons.

Untuk tempat yang tidak dipindahkan, Place Details (Baru) tidak menampilkan movedPlace atau movedPlaceId di isi respons.

Contoh berikut meminta informasi tempat tentang Marche IGA St-Canut di Quebec, Kanada:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

Permintaan ini menampilkan respons berikut:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

Untuk meminta detail tentang tempat baru, gunakan nama resource Tempat di kolom movedPlace di permintaan Place Details (Baru) yang baru.

Untuk tempat yang dipindahkan beberapa kali, mendapatkan detail tentang lokasi saat ini mungkin memerlukan beberapa permintaan Place Details (Baru) yang dirangkai. Kolom movedPlace dan movedPlaceId dari hasil tempat hanya mengarah ke lokasi berikutnya, bukan lokasi terakhir yang diketahui. Tempat berada di lokasi saat ini jika permintaan Place Details (Baru) menghapus kolom movedPlace dan movedPlaceId di isi respons.

Menemukan bisnis yang akan dibuka di masa mendatang

Anda dapat meminta detail tentang bisnis yang diperkirakan akan dibuka di masa mendatang. Nearby Search (Baru) akan mengisi kolom openingDate jika tanggal pembukaan yang diperkirakan mencakup setidaknya bulan dan kurang dari 90 hari lagi.

Contoh berikut menunjukkan permintaan Nearby Search (Baru) untuk bisnis yang akan dibuka di masa mendatang di New Meadows, Idaho:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

Respons mencakup status bisnis tempat dan tanggal pembukaan yang diperkirakan:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

Mendapatkan informasi stasiun transportasi umum

Anda dapat menggunakan Place Details (Baru) untuk mendapatkan informasi tentang stasiun transportasi umum. Isi respons mencakup informasi tentang stasiun, termasuk nama stasiun, perusahaan transportasi umum afiliasi, dan jalur transportasi umum yang melayani stasiun tersebut. Selain itu, respons mencakup ikon dan warna kendaraan yang dapat Anda gunakan untuk menampilkan informasi stasiun transportasi umum.

Contoh berikut menunjukkan permintaan informasi stasiun transportasi umum untuk Grand Central Station:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

Isi respons mencakup informasi tentang setiap stasiun dalam radius, jalur yang dilayani oleh stasiun, peringatan yang dikeluarkan oleh perusahaan transportasi umum di halte tersebut, dan informasi keberangkatan:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

Anda dapat meminta pintu masuk dan titik navigasi untuk tujuan. Pintu masuk menentukan titik masuk dan keluar untuk suatu tempat (misalnya, gerbang yang berbeda di bandara atau mal). Titik navigasi menentukan lokasi di tepi jalan tempat navigasi harus berakhir, yang berguna untuk mengarahkan pengguna ke sisi jalan yang benar atau titik pengantaran tertentu.

Titik navigasi menampilkan navigationPointToken. Anda dapat meneruskan token ini ke Navigation SDK (tersedia untuk Android atau iOS) atau Routes API untuk memandu pengemudi ke lokasi tertentu tersebut. Untuk mengetahui informasi selengkapnya, lihat Token titik navigasi.

Contoh berikut meminta detail untuk San Francisco International Airport (ID tempat ChIJVVVVVYx3j4ARP-3NGldc8qQ), termasuk entrances dan navigationPoints di mask kolom:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

Respons mencakup pintu masuk dan titik navigasi untuk tempat tersebut:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

Cobalah!

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

Pilih ikon API api di sisi kanan halaman.
Secara opsional, edit parameter permintaan.
Pilih tombol Execute. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.
Di panel APIs Explorer, pilih ikon layar penuh fullscreen untuk memperluas jendela APIs Explorer.

Place Details (Baru) Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Pengantar

Permintaan Place Details (Baru)

Respons Place Details (Baru)

Parameter yang diperlukan

FieldMask

placeId

Parameter opsional

languageCode

regionCode

sessionToken

Contoh Place Details (Baru)

Mendapatkan deskriptor alamat

Mendapatkan detail tempat untuk tempat yang dipindahkan

Menemukan bisnis yang akan dibuka di masa mendatang

Mendapatkan informasi stasiun transportasi umum

Mendapatkan pintu masuk dan titik navigasi

Cobalah!

Place Details (Baru)