Place Details (Baru)

Pilih platform: Android iOS JavaScript Layanan Web

Setelah memiliki ID tempat, Anda dapat meminta detail lebih lanjut tentang pengembangan tertentu atau lokasi menarik dengan memulai Place Details (Baru) permintaan. Place Details (Baru) permintaan 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:

API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat membiasakan diri dengan API dan Opsi API:

Cobalah!

Permintaan Place Details (Baru)

Permintaan Place Details adalah permintaan GET HTTP dalam bentuk:

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

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

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

Atau di 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 Place . Objek Place berisi informasi mendetail tentang saat ini.
  • FieldMask yang diteruskan dalam permintaan menentukan daftar kolom yang ditampilkan dalam objek Place.

Objek JSON lengkap tersedia dalam bentuk:

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

Parameter wajib

  • 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 dengan menggunakan header HTTP X-Goog-FieldMask. Tidak ada daftar default untuk kolom yang ditampilkan dalam respons. Jika Anda menghilangkan mask kolom, metode akan menampilkan error.

    Penyamaran kolom adalah praktik desain yang baik untuk memastikan bahwa Anda tidak meminta data yang tidak perlu, yang membantu menghindari waktu pemrosesan yang tidak perlu dan biaya penagihan.

    Tentukan daftar yang dipisahkan koma untuk jenis data tempat yang akan ditampilkan. Misalnya, untuk mengambil nama tampilan dan alamat tempat.

    X-Goog-FieldMask: displayName,formattedAddress

    Gunakan * untuk mengambil semua kolom.

    X-Goog-FieldMask: *

    Tentukan satu atau beberapa kolom berikut:

    • Kolom berikut memicu SKU Place Details (IDs Only):

      attributions, id, name* photos

      * Kolom name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Gunakan displayName untuk mengakses nama tekstual tempat tersebut.

    • Kolom berikut memicu SKU Place Details (Location Only):

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • Kolom berikut memicu SKU Place Details (Basic):

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • Kolom berikut memicu SKU Place Details (Advanced):

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • Kolom berikut memicu SKU Place Details (Preferred):

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

    Sebuah 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 tempat nama resource. Sebagai respons dari Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) permintaan, string ini dimuat di kolom name respons. Mandiri ID tempat dimuat dalam kolom id dari respons.

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 menetapkan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
    • API melakukan yang terbaik untuk menyediakan alamat jalan yang dapat dibaca baik pengguna maupun lokal. Untuk mencapai sasaran tersebut, model menampilkan jalan dalam bahasa lokal, ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Lainnya alamat ditampilkan dalam bahasa pilihan. Komponen alamat adalah semua dikembalikan dalam bahasa yang sama, yang dipilih dari sumber komponen.
    • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan padanan terdekat.
    • Bahasa pilihan memiliki pengaruh kecil pada serangkaian hasil yang API memilih untuk dikembalikan, dan urutan pengembaliannya. Tujuan geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa tetapi tidak dalam bahasa lain.

  • regionCode

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

    Jika nama negara kolom formattedAddress dalam respons cocok dengan regionCode, kode negara dihilangkan dari formattedAddress. Parameter ini tidak berpengaruh pada adrFormatAddress, yang selalu menyertakan negara nama, 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 "Inggris Raya dan Irlandia Utara"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

  • sessionToken

    Token sesi adalah string buatan pengguna yang melacak Autocomplete Panggilan (Baru) sebagai "sesi". Pelengkapan Otomatis (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 Place Details (Baru) panggilan yang mengikuti panggilan Autocomplete (Baru). Untuk informasi selengkapnya, lihat Token sesi.

Contoh Place Details

Contoh berikut meminta detail tempat dengan 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 dan Plus Codes di 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 kini berbentuk:

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

Cobalah!

API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda bisa membiasakan diri dengan API dan opsi API.

Untuk membuat permintaan:

  1. Pilih ikon API, Perluas API Explorer., di sisi kanan halaman.
  2. (Opsional) Tetapkan parameter name ke: 
    places/PLACE_ID
  3. (Opsional) Memperluas Tampilkan parameter standar dan atur parameter fields ke mask kolom.
  4. Pilih tombol Execute. Di jendela pop-up, pilih akun yang ingin Anda gunakan untuk membuat permintaan.

  5. Di panel API Explorer, pilih ikon luaskan, Perluas API Explorer., untuk meluaskan jendela API Explorer.