REST Resource: places

Resource: Tempat

Semua informasi yang merepresentasikan suatu Tempat.

Representasi JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Kolom
name

string

Nama resource Tempat ini, dalam format places/{placeId}. Dapat digunakan untuk mencari Tempat.
id

string

ID unik tempat.
displayName

object (LocalizedText)

Nama tempat yang dilokalkan, cocok sebagai deskripsi singkat yang dapat dibaca manusia. Misalnya, "Google Sydney", "Starbucks", "Pyrmont", dll.
types[]

string

Kumpulan tag jenis untuk hasil ini. Misalnya, "politik" dan "lokalitas". Untuk mengetahui daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

Jenis utama hasil yang diberikan. Jenis ini harus salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Suatu tempat hanya dapat memiliki satu jenis utama. Untuk daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. Jenis utama mungkin tidak ada jika jenis utama tempat bukan jenis yang didukung. Jika ada jenis utama, jenis tersebut selalu merupakan salah satu jenis di kolom types.
primaryTypeDisplayName

object (LocalizedText)

Nama tampilan jenis utama, dilokalkan ke bahasa permintaan jika berlaku. Untuk daftar lengkap kemungkinan nilai, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types. Jenis utama mungkin tidak ada jika jenis utama tempat bukan jenis yang didukung.
nationalPhoneNumber

string

Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format nasional.
internationalPhoneNumber

string

Nomor telepon yang dapat dibaca manusia untuk tempat tersebut, dalam format internasional.
formattedAddress

string

Alamat lengkap yang dapat dibaca manusia untuk tempat ini.
shortFormattedAddress

string

Alamat singkat yang mudah dibaca untuk tempat ini.
postalAddress

object (PostalAddress)

Alamat dalam format alamat pos.
addressComponents[]

object (AddressComponent)

Komponen berulang untuk setiap tingkat lokalitas. Perhatikan fakta berikut tentang array addressComponents[]: - Array komponen alamat dapat berisi lebih banyak komponen daripada formattedAddress. - Array tidak harus selalu menyertakan semua entitas politik yang berisi alamat, selain dari yang disertakan dalam formattedAddress. Untuk mengambil semua entitas politik yang berisi alamat tertentu, Anda harus menggunakan geocoding terbalik, yang meneruskan garis lintang/bujur alamat sebagai parameter ke permintaan tersebut. - Format respons tidak dijamin tetap sama di antara permintaan. Secara khusus, jumlah addressComponent bervariasi berdasarkan alamat yang diminta dan dapat berubah dari waktu ke waktu untuk alamat yang sama. Komponen dapat mengubah posisi dalam array. Jenis komponen dapat berubah. Komponen tertentu mungkin tidak ada dalam respons berikutnya.
plusCode

object (PlusCode)

Plus Codes lintang/bujur lokasi tempat.
location

object (LatLng)

Posisi tempat ini.
viewport

object (Viewport)

Area tampilan yang sesuai untuk menampilkan tempat di peta berukuran rata-rata. Area tampilan ini tidak boleh digunakan sebagai batas fisik atau area layanan bisnis.
rating

number

Rating antara 1,0 dan 5,0, berdasarkan ulasan pengguna tentang tempat ini.
googleMapsUri

string

URL yang memberikan informasi selengkapnya tentang tempat ini.
websiteUri

string

Situs resmi untuk tempat ini, misalnya halaman beranda bisnis. Perhatikan bahwa untuk tempat yang merupakan bagian dari jaringan (misalnya, toko IKEA), biasanya ini adalah situs untuk setiap toko, bukan jaringan secara keseluruhan.
reviews[]

object (Review)

Daftar ulasan tentang tempat ini, diurutkan berdasarkan relevansi. Maksimum 5 ulasan dapat ditampilkan.
regularOpeningHours

object (OpeningHours)

Jam operasional reguler. Perhatikan bahwa jika tempat selalu buka (24 jam), kolom close tidak akan ditetapkan. Klien dapat mengandalkan kondisi selalu buka (24 jam) yang direpresentasikan sebagai periode open yang berisi day dengan nilai 0, hour dengan nilai 0, dan minute dengan nilai 0.
timeZone

object (TimeZone)

Zona waktu IANA Time Zone Database. Misalnya, "America/New_York".
photos[]

object (Photo)

Informasi (termasuk referensi) tentang foto tempat ini. Maksimum 10 foto dapat ditampilkan.
adrFormatAddress

string

Alamat tempat dalam format mikro adr: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

Status bisnis untuk tempat.
priceLevel

enum (PriceLevel)

Tingkat harga tempat.
attributions[]

object (Attribution)

Kumpulan penyedia data yang harus ditampilkan dengan hasil ini.
iconMaskBaseUri

string

URL yang dipangkas ke masker ikon. Pengguna dapat mengakses berbagai jenis ikon dengan menambahkan sufiks jenis di akhir (misalnya, ".svg" atau ".png").
iconBackgroundColor

string

Warna latar belakang untuk icon_mask dalam format hex, misalnya #909CE1.
currentOpeningHours

object (OpeningHours)

Jam operasional selama tujuh hari ke depan (termasuk hari ini). Periode waktu dimulai pada tengah malam pada tanggal permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup sub-kolom specialDays dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.
currentSecondaryOpeningHours[]

object (OpeningHours)

Berisi array entri untuk tujuh hari berikutnya, termasuk informasi tentang jam buka sekunder bisnis. Jam sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam pengiriman sebagai jam buka sekundernya. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang telah ditentukan sebelumnya (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat. Kolom ini mencakup sub-kolom specialDays dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.
regularSecondaryOpeningHours[]

object (OpeningHours)

Berisi array entri untuk informasi tentang jam sekunder reguler bisnis. Jam sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan drive-thru atau jam pengiriman sebagai jam buka sekundernya. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang telah ditentukan sebelumnya (seperti DRIVE_THROUGH, PICKUP, atau TAKEOUT) berdasarkan jenis tempat.
editorialSummary

object (LocalizedText)

Berisi ringkasan tempat. Ringkasan terdiri dari ringkasan tekstual, dan juga menyertakan kode bahasa untuk ringkasan tersebut jika berlaku. Teks ringkasan harus ditampilkan apa adanya dan tidak dapat diubah atau dimodifikasi.
paymentOptions

object (PaymentOptions)

Opsi pembayaran yang diterima tempat ini. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan.
parkingOptions

object (ParkingOptions)

Opsi tempat parkir yang disediakan oleh tempat.
subDestinations[]

object (SubDestination)

Daftar sub-tujuan yang terkait dengan tempat.
fuelOptions

object (FuelOptions)

Informasi terbaru tentang opsi bahan bakar di SPBU. Informasi ini diperbarui secara berkala.
evChargeOptions

object (EVChargeOptions)

Informasi opsi pengisian daya kendaraan listrik.
generativeSummary

object (GenerativeSummary)

Ringkasan tempat yang dibuat AI.
containingPlaces[]

object (ContainingPlace)

Daftar tempat di mana tempat saat ini berada.
addressDescriptor

object (AddressDescriptor)

Deskripsi alamat tempat. Deskripsi alamat mencakup informasi tambahan yang membantu mendeskripsikan lokasi menggunakan tempat terkenal dan area. Lihat cakupan regional deskriptor alamat di https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

Rentang harga yang terkait dengan Tempat.
reviewSummary

object (ReviewSummary)

Ringkasan tempat yang dibuat AI menggunakan ulasan pengguna.
evChargeAmenitySummary

object (EvChargeAmenitySummary)

Ringkasan fasilitas di dekat SPKLU.
neighborhoodSummary

object (NeighborhoodSummary)

Ringkasan tempat menarik di dekat lokasi.
utcOffsetMinutes

integer

Jumlah menit selisih zona waktu tempat ini dari UTC saat ini. Hal ini dinyatakan dalam menit untuk mendukung zona waktu yang memiliki selisih waktu dalam pecahan jam, misalnya X jam dan 15 menit.
userRatingCount

integer

Jumlah total ulasan (dengan atau tanpa teks) untuk tempat ini.
takeout

boolean

Menentukan apakah bisnis mendukung layanan pesan bawa.
delivery

boolean

Menentukan apakah bisnis mendukung pengiriman.
dineIn

boolean

Menentukan apakah bisnis mendukung opsi tempat duduk di dalam atau luar ruangan.
curbsidePickup

boolean

Menentukan apakah bisnis mendukung pengambilan di tepi jalan.
reservable

boolean

Menentukan apakah tempat mendukung reservasi.
servesBreakfast

boolean

Menentukan apakah tempat ini menyajikan sarapan.
servesLunch

boolean

Menentukan apakah tempat ini menyajikan makan siang.
servesDinner

boolean

Menentukan apakah tempat menyajikan makan malam.
servesBeer

boolean

Menentukan apakah tempat ini menyajikan bir.
servesWine

boolean

Menentukan apakah tempat menyajikan wine.
servesBrunch

boolean

Menentukan apakah tempat menyajikan brunch.
servesVegetarianFood

boolean

Menentukan apakah tempat ini menyajikan makanan vegetarian.
outdoorSeating

boolean

Tempat ini menyediakan tempat duduk di luar ruangan.
liveMusic

boolean

Tempat ini menyajikan musik live.
menuForChildren

boolean

Tempat ini memiliki menu anak-anak.
servesCocktails

boolean

Tempat ini menyajikan koktail.
servesDessert

boolean

Tempat menyajikan hidangan penutup.
servesCoffee

boolean

Tempat ini menyajikan kopi.
goodForChildren

boolean

Tempat ini cocok untuk anak-anak.
allowsDogs

boolean

Tempat mengizinkan.
restroom

boolean

Tempat memiliki toilet.
goodForGroups

boolean

Tempat ini dapat menampung grup.
goodForWatchingSports

boolean

Tempat ini cocok untuk menonton acara olahraga.
accessibilityOptions

object (AccessibilityOptions)

Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat.
pureServiceAreaBusiness

boolean

Menunjukkan apakah tempat tersebut adalah bisnis jasa sistem panggilan murni. Bisnis jasa sistem panggilan murni adalah bisnis yang melakukan kunjungan atau pengiriman ke pelanggan secara langsung, tetapi tidak melayani pelanggan di alamat bisnisnya. Misalnya, bisnis seperti layanan kebersihan atau tukang leding. Bisnis tersebut mungkin tidak memiliki alamat atau lokasi fisik di Google Maps.

LocalizedText

Varian teks yang dilokalkan dalam bahasa tertentu.

Representasi JSON 
{
  "text": string,
  "languageCode": string
}
Kolom
text

string

String yang dilokalkan dalam bahasa yang sesuai dengan languageCode di bawah.
languageCode

string

Kode bahasa BCP-47 untuk teks, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

PostalAddress

Merupakan alamat pos, seperti untuk pengiriman pos atau alamat pembayaran. Dengan alamat pos, layanan pos dapat mengirimkan item ke tempat, kotak pos, atau yang serupa. Alamat pos tidak dimaksudkan untuk memodelkan lokasi geografis seperti jalan, kota, atau gunung.

Dalam penggunaan umum, alamat akan dibuat melalui masukan pengguna atau dengan mengimpor data yang ada, bergantung pada jenis prosesnya.

Saran terkait penginputan atau pengeditan alamat:

  • Gunakan widget alamat yang siap untuk internasionalisasi seperti https://github.com/google/libaddressinput.
  • Pengguna tidak boleh diberi elemen UI untuk mengisi atau mengedit kolom selain negara tempat kolom tersebut digunakan.

Untuk mendapatkan panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478.

Representasi JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Kolom
revision

integer

Revisi skema PostalAddress. Ini harus ditetapkan ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.
regionCode

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.
languageCode

string

Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini biasanya merupakan bahasa UI formulir masukan atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau padanan transliterasinya. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak berpengaruh penting terhadap kebenaran data dan tidak akan pernah memengaruhi validasi apa pun atau operasi terkait non-pemformatan.

Jika nilai tidak diketahui, maka harus dihilangkan (dibanding menentukan kemungkinan default yang salah).

Contoh: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau memerlukan penyertaan kode pos, tetapi jika kode pos digunakan, kode pos dapat memicu validasi tambahan dengan bagian alamat lain (misalnya, validasi negara bagian atau kode pos di Amerika Serikat).
sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya berupa string seperti "CEDEX", yang secara opsional diikuti dengan angka (misalnya, "CEDEX 7"), atau hanya angka saja, yang merepresentasikan "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (Côte d'Ivoire).
administrativeArea

string

Opsional. Subdivisi administrasi tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya, "Barcelona" dan bukan "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong.
locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post town. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan locality kosong dan gunakan addressLines.
sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, atau distrik.
addressLines[]

string

Baris alamat tidak terstruktur yang menggambarkan level alamat yang lebih rendah.

Karena nilai dalam addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya, "Austin, TX"), urutan baris haruslah jelas. Urutan baris alamat harus "urutan amplop" untuk negara atau wilayah alamat. Di tempat baris alamat ini dapat bervariasi (misalnya, Jepang), address_language digunakan untuk membuatnya eksplisit (misalnya, "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat yang paling spesifik dapat dipilih berdasarkan bahasa.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari regionCode dengan semua informasi yang tersisa ditempatkan di addressLines. Memformat alamat seperti itu dengan sangat akurat tanpa geocoding dapat dilakukan, tetapi tidak ada alasan semantik yang dapat dibuat mengenai salah satu komponen alamat hingga setidaknya sebagian diselesaikan.

Membuat alamat yang hanya berisi regionCode dan addressLines, lalu melakukan geocoding adalah cara yang direkomendasikan untuk menangani alamat yang sepenuhnya tidak terstruktur (alih-alih menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif).
recipients[]

string

Opsional. Penerima di alamat. Kolom ini dapat, dalam keadaan tertentu, berisi informasi multibaris. Misalnya, ini bisa berisi informasi "alamat lainnya".
organization

string

Opsional. Nama organisasi di alamat.

AddressComponent

Komponen terstruktur yang membentuk alamat yang diformat, jika informasi ini tersedia.

Representasi JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Kolom
longText

string

Deskripsi teks lengkap atau nama komponen alamat. Misalnya, komponen alamat untuk negara Australia dapat memiliki long_name "Australia".
shortText

string

Nama tekstual yang disingkat untuk komponen alamat, jika tersedia. Misalnya, komponen alamat untuk negara Australia dapat memiliki short_name "AU".
types[]

string

Array yang menunjukkan jenis komponen alamat.
languageCode

string

Bahasa yang digunakan untuk memformat komponen ini, dalam notasi CLDR.

PlusCode

Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan persegi panjang 14 m x 14 m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang menggantikan awalan dengan lokasi referensi.

Representasi JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Kolom
globalCode

string

Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang merepresentasikan area 1/8000 derajat x 1/8000 derajat (~14 x 14 meter).
compoundCode

string

Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norwegia", yang berisi sufiks kode global dan mengganti awalan dengan nama entitas referensi yang diformat.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Area Pandang

Area tampilan lintang-bujur, yang ditampilkan sebagai dua titik low dan high yang berlawanan secara diagonal. Area tampilan dianggap sebagai wilayah tertutup, yaitu mencakup batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif. Berbagai kasus mencakup:

  • Jika low = high, area tampilan terdiri dari satu titik tersebut.

  • Jika low.longitude > high.longitude, rentang bujur akan dibalik (area tampilan melintasi garis bujur 180 derajat).

  • Jika low.longitude = -180 derajat dan high.longitude = 180 derajat, area pandang akan mencakup semua bujur.

  • Jika low.longitude = 180 derajat dan high.longitude = -180 derajat, rentang bujur kosong.

  • Jika low.latitude > high.latitude, rentang garis lintang kosong.

low dan high harus diisi, dan kotak yang ditampilkan tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Viewport kosong akan menyebabkan error.

Misalnya, area tampilan ini sepenuhnya mencakup New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representasi JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Kolom
low

object (LatLng)

Wajib. Titik terendah area pandang.
high

object (LatLng)

Wajib. Titik tinggi area pandang.

Tinjau

Informasi tentang ulasan tempat.

Representasi JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Kolom
name

string

Referensi yang merepresentasikan ulasan tempat ini yang dapat digunakan untuk mencari ulasan tempat ini lagi (juga disebut nama "resource" API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

String waktu terbaru yang diformat, yang menyatakan waktu ulasan relatif terhadap waktu saat ini dalam bentuk yang sesuai untuk bahasa dan negara.
text

object (LocalizedText)

Teks ulasan yang dilokalkan.
originalText

object (LocalizedText)

Teks ulasan dalam bahasa aslinya.
rating

number

Angka antara 1,0 dan 5,0, juga disebut jumlah bintang.
authorAttribution

object (AuthorAttribution)

Penulis ulasan ini.
publishTime

string (Timestamp format)

Stempel waktu untuk ulasan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
flagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ulasan.
googleMapsUri

string

Link untuk menampilkan ulasan di Google Maps.

AuthorAttribution

Informasi tentang penulis data UGC. Digunakan di Photo, dan Review.

Representasi JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Kolom
displayName

string

Nama penulis Photo atau Review.
uri

string

URI penulis Photo atau Review.
photoUri

string

URI foto profil penulis Photo atau Review.

OpeningHours

Informasi tentang jam buka tempat.

Representasi JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Kolom
periods[]

object (Period)

Jangka waktu buka tempat ini selama seminggu. Periode diurutkan secara kronologis, dalam zona waktu lokal tempat. Nilai kosong (tetapi tidak ada) menunjukkan tempat yang tidak pernah buka, misalnya karena ditutup sementara untuk renovasi.

Hari mulai periods TIDAK tetap dan tidak boleh diasumsikan sebagai hari Minggu. API menentukan hari mulai berdasarkan berbagai faktor. Misalnya, untuk bisnis yang beroperasi 24/7, periode pertama dapat dimulai pada hari permintaan. Untuk bisnis lain, mungkin hari pertama dalam seminggu saat mereka buka.

CATATAN: Urutan array periods tidak bergantung pada urutan array weekdayDescriptions. Jangan menganggap bahwa keduanya akan dimulai pada hari yang sama.
weekdayDescriptions[]

string

String yang dilokalkan yang menjelaskan jam buka tempat ini, satu string untuk setiap hari dalam seminggu.

CATATAN: Urutan hari dan awal pekan ditentukan oleh lokalitas (bahasa dan wilayah). Urutan array periods tidak bergantung pada urutan array weekdayDescriptions. Jangan menganggap bahwa keduanya akan dimulai pada hari yang sama.

Akan kosong jika jam tidak diketahui atau tidak dapat dikonversi menjadi teks yang dilokalkan. Contoh: "Minggu: 18.00–06.00"
secondaryHoursType

enum (SecondaryHoursType)

String jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder.
specialDays[]

object (SpecialDay)

Informasi terstruktur untuk hari khusus yang termasuk dalam periode yang dicakup oleh jam buka yang ditampilkan. Hari khusus adalah hari yang dapat memengaruhi jam buka suatu tempat, misalnya Hari Natal. Tetapkan untuk currentOpeningHours dan currentSecondaryOpeningHours jika ada jam buka khusus.
nextOpenTime

string (Timestamp format)

Waktu berikutnya periode jam buka saat ini dimulai hingga 7 hari ke depan. Kolom ini hanya diisi jika periode jam buka tidak aktif pada saat permintaan ditayangkan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
nextCloseTime

string (Timestamp format)

Waktu berakhir periode jam buka saat ini paling lambat 7 hari ke depan. Kolom ini hanya diisi jika periode jam buka aktif pada saat permintaan ditayangkan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
openNow

boolean

Apakah periode jam buka saat ini aktif. Untuk jam buka reguler dan jam buka saat ini, kolom ini berarti apakah tempat tersebut buka. Untuk jam buka sekunder dan jam buka sekunder saat ini, kolom ini berarti apakah jam sekunder tempat ini aktif.

Periode

Periode tempat tetap dalam status openNow.

Representasi JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Kolom
open

object (Point)

Waktu tempat mulai buka.
close

object (Point)

Waktu tempat mulai ditutup.

Titik

Poin perubahan status.

Representasi JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Kolom
date

object (Date)

Tanggal dalam zona waktu lokal untuk tempat tersebut.
truncated

boolean

Apakah endpoint ini dipangkas atau tidak. Pemangkasan terjadi saat jam sebenarnya berada di luar waktu yang ingin kita kembalikan di antara jam tersebut, sehingga kita memangkas jam kembali ke batas ini. Hal ini memastikan bahwa paling banyak 24 * 7 jam sejak tengah malam pada hari permintaan dikembalikan.
day

integer

Hari dalam seminggu, sebagai bilangan bulat dalam rentang 0-6. 0 adalah Minggu, 1 adalah Senin, dll.
hour

integer

Jam dalam format 24 jam. Rentang dari 0 hingga 23.
minute

integer

Menit. Rentang dari 0 hingga 59.

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

SecondaryHoursType

Jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Nilai default jika jenis jam sekunder tidak ditentukan.
DRIVE_THROUGH Jam layanan drive-through untuk bank, restoran, atau apotek.
HAPPY_HOUR Happy hour.
DELIVERY Jam pengiriman.
TAKEOUT Waktu pengambilan.
KITCHEN Jam buka dapur.
BREAKFAST Waktu sarapan.
LUNCH Waktu makan siang.
DINNER Waktu makan malam.
BRUNCH Waktu makan siang.
PICKUP Waktu pengambilan.
ACCESS Jam akses untuk tempat penyimpanan.
SENIOR_HOURS Jam khusus untuk lansia.
ONLINE_SERVICE_HOURS Jam layanan online.

SpecialDay

Informasi terstruktur untuk hari khusus yang termasuk dalam periode yang dicakup oleh jam buka yang ditampilkan. Hari khusus adalah hari yang dapat memengaruhi jam buka suatu tempat, misalnya Hari Natal.

Representasi JSON 
{
  "date": {
    object (Date)
  }
}
Kolom
date

object (Date)

Tanggal hari istimewa ini.

TimeZone

Mewakili zona waktu dari Database Zona Waktu IANA.

Representasi JSON 
{
  "id": string,
  "version": string
}
Kolom
id

string

Zona waktu IANA Time Zone Database. Misalnya, "America/New_York".
version

string

Opsional. Nomor versi Database Zona Waktu IANA. Misalnya, "2019a".

Foto

Informasi tentang foto suatu tempat.

Representasi JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Kolom
name

string

ID. Referensi yang merepresentasikan foto tempat ini yang dapat digunakan untuk mencari foto tempat ini lagi (juga disebut nama "resource" API: places/{placeId}/photos/{photo}).
widthPx

integer

Lebar maksimum yang tersedia, dalam piksel.
heightPx

integer

Tinggi maksimum yang tersedia, dalam piksel.
authorAttributions[]

object (AuthorAttribution)

Penulis foto ini.
flagContentUri

string

Link tempat pengguna dapat melaporkan masalah pada foto.
googleMapsUri

string

Link untuk menampilkan foto di Google Maps.

BusinessStatus

Status bisnis untuk tempat.

Enum
BUSINESS_STATUS_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
OPERATIONAL Tempat ini beroperasi, tetapi belum tentu buka sekarang.
CLOSED_TEMPORARILY Tempat ini tutup sementara.
CLOSED_PERMANENTLY Tempat ini tutup permanen.

PriceLevel

Tingkat harga tempat.

Enum
PRICE_LEVEL_UNSPECIFIED Tingkat harga tempat tidak ditentukan atau tidak diketahui.
PRICE_LEVEL_FREE Tempat menyediakan layanan gratis.
PRICE_LEVEL_INEXPENSIVE Tempat menyediakan layanan yang tidak mahal.
PRICE_LEVEL_MODERATE Tempat ini menyediakan layanan dengan harga sedang.
PRICE_LEVEL_EXPENSIVE Tempat ini menyediakan layanan yang mahal.
PRICE_LEVEL_VERY_EXPENSIVE Tempat ini menyediakan layanan yang sangat mahal.

Atribusi

Informasi tentang penyedia data tempat ini.

Representasi JSON 
{
  "provider": string,
  "providerUri": string
}
Kolom
provider

string

Nama penyedia data Tempat.
providerUri

string

URI ke penyedia data Tempat.

PaymentOptions

Opsi pembayaran yang diterima tempat ini.

Representasi JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Kolom
acceptsCreditCards

boolean

Tempat menerima kartu kredit sebagai pembayaran.
acceptsDebitCards

boolean

Tempat menerima kartu debit sebagai pembayaran.
acceptsCashOnly

boolean

Tempat hanya menerima pembayaran tunai. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lain.
acceptsNfc

boolean

Tempat menerima pembayaran NFC.

ParkingOptions

Informasi tentang opsi parkir untuk tempat tersebut. Tempat parkir dapat mendukung lebih dari satu opsi secara bersamaan.

Representasi JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Kolom
freeParkingLot

boolean

Tempat ini menawarkan tempat parkir gratis.
paidParkingLot

boolean

Tempat ini menawarkan tempat parkir berbayar.
freeStreetParking

boolean

Tempat ini menawarkan parkir di jalan gratis.
paidStreetParking

boolean

Tempat ini menawarkan tempat parkir di pinggir jalan berbayar.
valetParking

boolean

Tempat ini menawarkan parkir valet.
freeGarageParking

boolean

Tempat ini menawarkan parkir di garasi gratis.
paidGarageParking

boolean

Tempat ini menawarkan tempat parkir di garasi berbayar.

SubDestination

Sub-tujuan adalah tempat tertentu yang terkait dengan tempat utama. Tujuan ini memberikan tujuan yang lebih spesifik bagi pengguna yang menelusuri tempat yang besar atau kompleks, seperti bandara, taman nasional, universitas, atau stadion. Misalnya, sub-tujuan di bandara dapat mencakup terminal dan tempat parkir terkait. Sub-tujuan menampilkan ID tempat dan nama resource tempat, yang dapat digunakan dalam permintaan Place Details (Baru) berikutnya untuk mengambil detail yang lebih lengkap, termasuk nama tampilan dan lokasi sub-tujuan.

Representasi JSON 
{
  "name": string,
  "id": string
}
Kolom
name

string

Nama resource sub-tujuan.
id

string

ID tempat sub-tujuan.

AccessibilityOptions

Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat.

Representasi JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Kolom
wheelchairAccessibleParking

boolean

Tempat ini menawarkan tempat parkir khusus pengguna kursi roda.
wheelchairAccessibleEntrance

boolean

Tempat ini memiliki pintu masuk khusus pengguna kursi roda.
wheelchairAccessibleRestroom

boolean

Tempat ini memiliki toilet khusus pengguna kursi roda.
wheelchairAccessibleSeating

boolean

Tempat ini menyediakan tempat duduk khusus pengguna kursi roda.

FuelOptions

Informasi terbaru tentang opsi bahan bakar di SPBU. Informasi ini diperbarui secara berkala.

Representasi JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Kolom
fuelPrices[]

object (FuelPrice)

Harga bahan bakar terakhir yang diketahui untuk setiap jenis bahan bakar yang dimiliki SPBU ini. Ada satu entri per jenis bahan bakar yang dimiliki stasiun ini. Urutan tidak penting.

FuelPrice

Informasi harga bahan bakar untuk jenis tertentu.

Representasi JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Kolom
type

enum (FuelType)

Jenis bahan bakar.
price

object (Money)

Harga bahan bakar.
updateTime

string (Timestamp format)

Waktu harga bahan bakar terakhir diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

FuelType

Jenis bahan bakar.

Enum
FUEL_TYPE_UNSPECIFIED Jenis bahan bakar tidak ditentukan.
DIESEL Bahan bakar diesel.
DIESEL_PLUS Bahan bakar diesel plus.
REGULAR_UNLEADED Bensin tanpa timbal reguler.
MIDGRADE Menengah.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Gas Minyak Cair.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Metana.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Diesel truk.

Uang

Mewakili jumlah uang dengan jenis mata uangnya.

Representasi JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Kolom
currencyCode

string

Kode mata uang tiga huruf yang ditentukan dalam ISO 4217.
units

string (int64 format)

Seluruh unit jumlahnya. Misalnya, jika currencyCode adalah "USD", maka 1 unit adalah satu dolar AS.
nanos

integer

Jumlah unit nano (10^-9) dari jumlah. Nilainya harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos dapat positif, nol, atau negatif. Jika units negatif, nanos harus negatif atau nol. Misalnya $-1,75 direpresentasikan sebagai units=-1 dan nanos=-750.000.000.

EVChargeOptions

Informasi tentang Stasiun Pengisian Kendaraan Listrik Umum yang dihosting di Place. Terminologi mengikuti https://afdc.energy.gov/fuels/electricity_infrastructure.html Satu port dapat mengisi daya satu mobil dalam satu waktu. Satu port memiliki satu atau beberapa konektor. Satu SPKLU memiliki satu atau beberapa port.

Representasi JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Kolom
connectorCount

integer

Jumlah konektor di SPKLU ini. Namun, karena beberapa port dapat memiliki beberapa konektor, tetapi hanya dapat mengisi daya satu mobil dalam satu waktu (misalnya), jumlah konektor mungkin lebih besar daripada jumlah total mobil yang dapat mengisi daya secara bersamaan.
connectorAggregation[]

object (ConnectorAggregation)

Daftar penggabungan konektor pengisian daya kendaraan listrik yang berisi konektor dengan jenis yang sama dan kecepatan pengisian daya yang sama.

ConnectorAggregation

Informasi pengisian daya kendaraan listrik dikelompokkan menurut [type, maxChargeRateKw]. Menampilkan penggabungan pengisian daya EV untuk konektor yang memiliki jenis dan kecepatan pengisian daya maks yang sama dalam kW.

Representasi JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Kolom
type

enum (EVConnectorType)

Jenis konektor agregasi ini.
maxChargeRateKw

number

Kecepatan pengisian daya maksimum statis dalam kw dari setiap konektor dalam penggabungan.
count

integer

Jumlah konektor dalam penggabungan ini.
availabilityLastUpdateTime

string (Timestamp format)

Stempel waktu saat informasi ketersediaan konektor dalam agregasi ini terakhir diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
availableCount

integer

Jumlah konektor dalam agregasi ini yang saat ini tersedia.
outOfServiceCount

integer

Jumlah konektor dalam penggabungan ini yang saat ini tidak berfungsi.

EVConnectorType

Lihat http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 untuk mengetahui informasi/konteks tambahan tentang jenis konektor pengisi daya EV.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Konektor tidak ditentukan.
EV_CONNECTOR_TYPE_OTHER Jenis konektor lainnya.
EV_CONNECTOR_TYPE_J1772 Konektor jenis 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Konektor IEC 62196 tipe 2. Sering disebut sebagai MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Konektor jenis CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC dan DC). Berdasarkan SAE. Konektor J-1772 Type-1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC dan DC). Berdasarkan konektor Mennekes Type-2
EV_CONNECTOR_TYPE_TESLA Konektor TESLA generik. Ini adalah NACS di Amerika Utara, tetapi dapat berupa non-NACS di belahan dunia lainnya (misalnya CCS Combo 2 (CCS2) atau GB/T). Nilai ini kurang merepresentasikan jenis konektor sebenarnya, dan lebih merepresentasikan kemampuan untuk mengisi daya kendaraan merek Tesla di stasiun pengisian daya milik Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Jenis GB/T sesuai dengan standar GB/T di China. Jenis ini mencakup semua jenis GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Stopkontak tidak ditentukan.
EV_CONNECTOR_TYPE_NACS North American Charging System (NACS), yang distandardisasi sebagai SAE J3400.

GenerativeSummary

Ringkasan tempat yang dibuat AI.

Representasi JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Kolom
overview

object (LocalizedText)

Ringkasan tempat.
overviewFlagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan ikhtisar.
disclosureText

object (LocalizedText)

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

ContainingPlace

Info tentang tempat di mana tempat ini berada.

Representasi JSON 
{
  "name": string,
  "id": string
}
Kolom
name

string

Nama resource tempat lokasi ini berada.
id

string

ID tempat dari tempat di mana tempat ini berada.

AddressDescriptor

Deskripsi relasional lokasi. Mencakup serangkaian bangunan terkenal terdekat yang diberi peringkat dan area yang berisi secara presisi serta hubungannya dengan lokasi target.

Representasi JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Kolom
landmarks[]

object (Landmark)

Daftar tempat terkenal di sekitar yang diurutkan berdasarkan peringkat. Bangunan terdekat dan paling dikenal diberi peringkat pertama.
areas[]

object (Area)

Daftar berperingkat area yang berisi atau berdekatan. Area yang paling mudah dikenali dan paling presisi diberi peringkat pertama.

Tempat terkenal

Informasi dasar tentang tempat terkenal dan hubungan tempat terkenal tersebut dengan lokasi target.

Landmark adalah tempat terkenal yang dapat digunakan untuk mendeskripsikan lokasi.

Representasi JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Kolom
name

string

Nama resource landmark.
placeId

string

ID tempat landmark.
displayName

object (LocalizedText)

Nama tampilan tempat penting.
types[]

string

Kumpulan tag jenis untuk tempat terkenal ini. Untuk mengetahui daftar lengkap kemungkinan nilai, lihat https://developers.google.com/maps/documentation/places/web-service/place-types.
spatialRelationship

enum (SpatialRelationship)

Menentukan hubungan spasial antara target lokasi dan landmark.
straightLineDistanceMeters

number

Jarak garis lurus, dalam meter, antara titik tengah target dan titik tengah landmark. Dalam beberapa situasi, nilai ini bisa lebih panjang dari travelDistanceMeters.
travelDistanceMeters

number

Jarak perjalanan, dalam meter, di sepanjang jaringan jalan dari target ke tempat terkenal, jika diketahui. Nilai ini tidak memperhitungkan moda transportasi, seperti berjalan kaki, mengemudi, atau bersepeda.

SpatialRelationship

Menentukan hubungan spasial antara target lokasi dan landmark.

Enum
NEAR Ini adalah hubungan default jika tidak ada yang lebih spesifik di bawah yang berlaku.
WITHIN Landmark memiliki geometri spasial dan target berada dalam batasnya.
BESIDE Target berdekatan langsung dengan landmark.
ACROSS_THE_ROAD Target berada tepat di seberang bangunan di sisi lain jalan.
DOWN_THE_ROAD Di rute yang sama dengan lokasi penting, tetapi tidak di samping atau di seberang.
AROUND_THE_CORNER Tidak berada di rute yang sama dengan lokasi, tetapi hanya berjarak satu belokan.
BEHIND Dekat dengan struktur bangunan landmark, tetapi lebih jauh dari pintu masuknya di jalan.

Area

Informasi area dan hubungan area dengan lokasi target.

Area mencakup sublokalitas yang tepat, lingkungan, dan kompleks besar yang berguna untuk mendeskripsikan lokasi.

Representasi JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Kolom
name

string

Nama resource area.
placeId

string

ID tempat area.
displayName

object (LocalizedText)

Nama tampilan area.
containment

enum (Containment)

Menentukan hubungan spasial antara lokasi target dan area.

Pembatasan

Menentukan hubungan spasial antara lokasi target dan area.

Enum
CONTAINMENT_UNSPECIFIED Penampungan tidak ditentukan.
WITHIN Lokasi target berada dalam wilayah area, dekat dengan bagian tengah.
OUTSKIRTS Lokasi target berada dalam wilayah area, dekat dengan tepi.
NEAR Lokasi target berada di luar area wilayah, tetapi dekat.

PriceRange

Rentang harga yang terkait dengan Tempat. endPrice dapat dibatalkan, yang menunjukkan rentang tanpa batas atas (misalnya, "Lebih dari Rp1.000.000").

Representasi JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Kolom
startPrice

object (Money)

Ujung rendah rentang harga (inklusif). Harga harus sama dengan atau di atas jumlah ini.
endPrice

object (Money)

Ujung atas rentang harga (eksklusif). Harga harus lebih rendah dari jumlah ini.

ReviewSummary

Ringkasan tempat yang dibuat AI menggunakan ulasan pengguna.

Representasi JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
Kolom
text

object (LocalizedText)

Ringkasan ulasan pengguna.
flagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosureText

object (LocalizedText)

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.
reviewsUri

string

Link untuk menampilkan ulasan tempat ini di Google Maps.

EvChargeAmenitySummary

Ringkasan fasilitas di dekat SPKLU. Ini hanya berlaku untuk tempat dengan jenis electric_vehicle_charging_station. Kolom overview dijamin akan diberikan, sedangkan kolom lainnya bersifat opsional.

Representasi JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Kolom
overview

object (ContentBlock)

Ringkasan fasilitas yang tersedia. Hal ini dijamin akan diberikan.
coffee

object (ContentBlock)

Ringkasan opsi kopi di sekitar.
restaurant

object (ContentBlock)

Ringkasan restoran di sekitar.
store

object (ContentBlock)

Ringkasan toko terdekat.
flagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosureText

object (LocalizedText)

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

ContentBlock

Blok konten yang dapat ditayangkan secara terpisah.

Representasi JSON 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
Kolom
content

object (LocalizedText)

Konten yang terkait dengan topik.
referencedPlaces[]

string

Daftar nama resource tempat yang dirujuk. Nama ini dapat digunakan di API lain yang menerima nama resource Place.

NeighborhoodSummary

Ringkasan tempat menarik di dekat lokasi.

Representasi JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Kolom
overview

object (ContentBlock)

Ringkasan umum lingkungan sekitar.
description

object (ContentBlock)

Deskripsi mendetail tentang lingkungan sekitar.
flagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.
disclosureText

object (LocalizedText)

Pesan pengungkapan AI "Diringkas dengan Gemini" (dan varian yang dilokalkan). Respons akan dalam bahasa yang ditentukan dalam permintaan jika tersedia.

Metode

autocomplete

 Menampilkan prediksi untuk input yang diberikan.

get

 Mendapatkan detail tempat berdasarkan nama resource-nya, yang merupakan string dalam format places/{place_id}.

searchNearby

 Menelusuri tempat di dekat lokasi.

searchText

 Penelusuran tempat berbasis kueri teks.