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 bangunan atau lokasi menarik tertentu dengan memulai permintaan Place Details (New). Permintaan Place Details (New) menampilkan informasi yang lebih komprehensif tentang tempat yang ditunjukkan, seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasan pengguna.

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 (New)

Permintaan Place Details (New) 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 (New)

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

Respons direpresentasikan oleh objek Place. Objek Place berisi informasi mendetail tentang tempat.
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 default kolom yang ditampilkan dalam respons. Jika Anda menghapus masker kolom, metode akan menampilkan error.

Penyamaran 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 untuk 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 menyarankan penggunaan karakter pengganti pada mask kolom respons 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 tekstual tempat, minta kolom displayName di SKU Pro.
  
  Untuk mengetahui daftar lengkap kolom dan SKU terkaitnya, lihat Kolom Data Tempat (Baru).
- Kolom berikut memicu SKU Place Details Essentials:
  
  addressComponents
  addressDescriptor^*
  adrFormatAddress
  formattedAddress
  location
  plusCode
  postalAddress
  shortFormattedAddress
  types
  viewport
  
  ^* Deskripsi alamat memiliki ketersediaan umum untuk pelanggan di India dan bersifat eksperimental di tempat lain.
  
  Untuk mengetahui daftar lengkap kolom dan SKU terkaitnya, 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 mengetahui daftar lengkap kolom dan SKU terkaitnya, 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 mengetahui daftar lengkap kolom dan SKU terkaitnya, 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
  
  ^* Hanya Text Search dan Nearby Search
  Untuk mengetahui daftar lengkap kolom dan SKU terkaitnya, lihat Kolom Data Tempat (Baru).
placeId

ID tekstual yang secara unik mengidentifikasi tempat, yang ditampilkan dari Text Search (Baru) atau Nearby Search (Baru). Untuk 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), string ini terdapat dalam kolom name respons. ID tempat mandiri terdapat dalam kolom id respons.

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

Parameter opsional

languageCode

Bahasa yang 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 ditetapkan secara default ke en. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
- API ini melakukan yang terbaik untuk memberikan alamat yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasikan ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya 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 kemunculannya. 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 buatan pengguna yang melacak panggilan Autocomplete (New) sebagai "sesi". Autocomplete (New) 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 (New)

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 akan berbentuk:

{
  "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 Plus Code 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 rating, jumlah ulasan, dan ulasan

Untuk mengambil rating bintang rata-rata, jumlah total rating (total ulasan), atau teks ulasan pelanggan dari suatu bisnis, sertakan kolom yang sesuai di header X-Goog-FieldMask Anda:

rating dan userRatingCount: Menampilkan rating rata-rata tempat (dari 1.0 hingga 5.0) dan jumlah total ulasan. Meminta kolom ini akan memicu SKU Place Details Enterprise.
reviews dan reviewSummary: Menampilkan hingga lima objek Review yang dikirimkan pengguna dan ringkasan ulasan yang dibuat AI. Meminta kolom ini akan memicu SKU Place Details Enterprise + Atmosphere.

Jika aplikasi Anda hanya memerlukan rating bintang dan jumlah total ulasan, minta rating dan userRatingCount tanpa reviews agar permintaan tetap berada di tingkat SKU Place Details Enterprise:

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

Untuk juga mengambil hingga lima objek Review yang dikirimkan pengguna, tambahkan reviews ke mask kolom (ditagih pada tingkat SKU Place Details Enterprise + Atmosphere):

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

Responsnya mencakup rating, jumlah total rating, dan array reviews:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

Mendapatkan deskripsi alamat

Deskripsi alamat memberikan informasi relasional tentang lokasi suatu tempat, termasuk tempat terkenal di sekitar dan area yang memuatnya.

Catatan: Deskripsi alamat tersedia secara umum untuk pelanggan di India dan bersifat eksperimental di tempat lain. Permintaan Places API (Baru) yang hanya menggunakan addressDescriptor dalam mask kolom akan ditagih dengan SKU: Places API Place Details Essentials.

Contoh berikut menunjukkan permintaan Place Details (New) untuk department store di mal San Jose. Dalam contoh ini, Anda menyertakan addressDescriptors dalam 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"

Responsnya mencakup tempat yang ditentukan dalam permintaan, daftar tempat terkenal di sekitar dan jaraknya dari tempat tersebut, serta daftar area dan hubungan cakupannya 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 direlokasi, Anda dapat menggunakan kolom movedPlace dan movedPlaceId untuk mendapatkan detail tempat baru.

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

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

Untuk tempat yang belum dipindahkan, Place Details (New) tidak menampilkan movedPlace atau movedPlaceId dalam 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 Place di kolom movedPlace dalam permintaan Place Details (New) yang baru.

Untuk tempat yang telah berpindah beberapa kali, mendapatkan detail tentang lokasi saat ini mungkin memerlukan beberapa permintaan Place Details (New) berantai. 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) menghilangkan kolom movedPlace dan movedPlaceId dalam isi respons.

Menemukan bisnis yang akan dibuka pada masa mendatang

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

Contoh berikut menunjukkan permintaan Nearby Search (New) 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"

Responsnya mencakup status bisnis tempat dan tanggal buka 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 (New) untuk mendapatkan informasi tentang stasiun transportasi umum. Isi respons mencakup informasi tentang stasiun, termasuk nama stasiun, perusahaan transportasi umum yang berafiliasi, dan jalur transportasi umum yang melayani stasiun tersebut. Selain itu, responsnya mencakup ikon kendaraan dan warna 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, pemberitahuan yang dikeluarkan oleh perusahaan transportasi umum di perhentian 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 suatu 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 penurunan 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 spesifik tersebut. Untuk mengetahui informasi selengkapnya, lihat Token titik navigasi.

Contoh berikut meminta detail untuk Bandara Internasional San Francisco (ID tempat ChIJVVVVVYx3j4ARP-3NGldc8qQ), termasuk entrances dan navigationPoints dalam 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

Responsnya 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 contoh permintaan sehingga Anda dapat memahami API dan opsi API.

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

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

Pengantar

Permintaan Place Details (New)

Respons Place Details (New)

Parameter yang diperlukan

FieldMask

placeId

Parameter opsional

languageCode

regionCode

sessionToken

Contoh Place Details (New)

Mendapatkan rating, jumlah ulasan, dan ulasan

Mendapatkan deskripsi alamat

Mendapatkan detail tempat untuk tempat yang dipindahkan

Menemukan bisnis yang akan dibuka pada masa mendatang

Mendapatkan informasi stasiun transportasi umum

Mendapatkan pintu masuk dan titik navigasi

Cobalah!

Place Details (Baru)