REST Resource: places

Resource: Place

Semua informasi yang mewakili 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,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "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)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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 nilai yang mungkin, 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 berupa salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Suatu tempat hanya dapat memiliki satu jenis utama. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Tabel A dan Tabel B di https://developers.google.com/maps/documentation/places/web-service/place-types

primaryTypeDisplayName

object (LocalizedText)

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

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 dapat dibaca manusia untuk tempat ini.

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 lintang/bujur alamat sebagai parameter ke permintaan tersebut. - Format respons tidak dijamin tetap sama di antara permintaan. Secara khusus, jumlah addressComponents 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 pada peta berukuran sedang. Area pandang 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), situs ini biasanya adalah situs untuk setiap toko, bukan keseluruhan jaringan.

reviews[]

object (Review)

Daftar ulasan tentang tempat ini, diurutkan menurut 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 selalu buka (24 jam) yang direpresentasikan sebagai jangka waktu [open][OpeningHours.Period.open] yang berisi [day][Point.day] dengan nilai 0, [hour][Point.hour] dengan nilai 0, dan [minute][Point.minute] dengan nilai 0.

photos[]

object (Photo)

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

adrFormatAddress

string

Alamat tempat dalam microformat 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 terpotong ke masker ikon. Pengguna dapat mengakses berbagai jenis ikon dengan menambahkan akhiran jenis di bagian akhir (misalnya, ".svg" atau ".png").

iconBackgroundColor

string

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

currentOpeningHours

object (OpeningHours)

Jam buka selama tujuh hari ke depan (termasuk hari ini). Jangka waktu dimulai pada tengah malam pada tanggal permintaan dan berakhir pada pukul 23.59 enam hari kemudian. Kolom ini mencakup subkolom specialDays dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.

currentSecondaryOpeningHours[]

object (OpeningHours)

Berisi array entri untuk tujuh hari ke depan, termasuk informasi tentang jam buka sekunder bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam buka drive-thru atau jam buka pesan antar 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 subkolom specialDays dari semua jam, yang ditetapkan untuk tanggal yang memiliki jam khusus.

regularSecondaryOpeningHours[]

object (OpeningHours)

Berisi array entri untuk informasi tentang jam buka sekunder reguler bisnis. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam buka drive-thru atau jam buka pesan antar 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 teks, 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 tersebut. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan.

parkingOptions

object (ParkingOptions)

Opsi 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 tentang opsi pengisian daya kendaraan listrik.

generativeSummary

object (GenerativeSummary)

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Ringkasan tempat yang dibuat AI.

areaSummary

object (AreaSummary)

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Ringkasan area tempat bisnis berada yang dibuat AI.

containingPlaces[]

object (ContainingPlace)

Daftar tempat tempat lokasi saat ini berada.

addressDescriptor

object (AddressDescriptor)

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

priceRange

object (PriceRange)

Rentang harga yang terkait dengan Tempat.

utcOffsetMinutes

integer

Jumlah menit zona waktu tempat ini saat ini dioffset dari UTC. Ini dinyatakan dalam menit untuk mendukung zona waktu yang diimbangi dengan 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 pesan antar.

delivery

boolean

Menentukan apakah bisnis mendukung pesan antar.

dineIn

boolean

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

curbsidePickup

boolean

Menentukan apakah bisnis mendukung layanan ambil di tepi jalan.

reservable

boolean

Menentukan apakah tempat mendukung reservasi.

servesBreakfast

boolean

Menentukan apakah tempat tersebut menyajikan sarapan.

servesLunch

boolean

Menentukan apakah tempat tersebut menyajikan makan siang.

servesDinner

boolean

Menentukan apakah tempat tersebut menyajikan makan malam.

servesBeer

boolean

Menentukan apakah tempat tersebut menyajikan bir.

servesWine

boolean

Menentukan apakah tempat tersebut menyajikan wine.

servesBrunch

boolean

Menentukan apakah tempat tersebut menyajikan sarapan siang.

servesVegetarianFood

boolean

Menentukan apakah tempat tersebut menyajikan makanan vegetarian.

outdoorSeating

boolean

Tempat ini menyediakan tempat duduk outdoor.

liveMusic

boolean

Tempat ini menyediakan musik live.

menuForChildren

boolean

Tempat ini memiliki menu untuk anak-anak.

servesCocktails

boolean

Tempat ini menyajikan koktail.

servesDessert

boolean

Tempat ini menyajikan hidangan penutup.

servesCoffee

boolean

Tempat ini menyajikan kopi.

goodForChildren

boolean

Tempatnya cocok untuk anak-anak.

allowsDogs

boolean

Tempat mengizinkan.

restroom

boolean

Tempat memiliki toilet.

goodForGroups

boolean

Tempat dapat menampung grup.

goodForWatchingSports

boolean

Tempat cocok untuk menonton acara olahraga.

accessibilityOptions

object (AccessibilityOptions)

Informasi tentang opsi aksesibilitas yang ditawarkan suatu tempat.

pureServiceAreaBusiness

boolean

Menunjukkan apakah tempat tersebut merupakan 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 teks, seperti "en-US" atau "sr-Latn".

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

AddressComponent

Komponen terstruktur yang membentuk alamat berformat, 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 mungkin 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 14mx14m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang mengganti awalan dengan lokasi referensi.

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

string

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

compoundCode

string

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

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali 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 pandang lintang-bujur, yang direpresentasikan sebagai dua titik low dan high yang berlawanan secara diagonal. Area pandang 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 meliputi:

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

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

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

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

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

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

Misalnya, area pandang 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 tertinggi 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 mewakili 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 peninjauan 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, yang juga disebut jumlah bintang.

authorAttribution

object (AuthorAttribution)

Penulis ulasan ini.

publishTime

string (Timestamp format)

Stempel waktu untuk ulasan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

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)

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

weekdayDescriptions[]

string

String yang dilokalkan yang menjelaskan jam buka tempat ini, satu string untuk setiap hari dalam seminggu. 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 sekunder.

specialDays[]

object (SpecialDay)

Informasi terstruktur untuk hari-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.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

nextCloseTime

string (Timestamp format)

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

openNow

boolean

Apakah periode jam buka saat ini aktif. Untuk jam buka reguler dan jam buka saat ini, kolom ini menunjukkan apakah tempat tersebut buka. Untuk jam buka sekunder dan jam buka sekunder saat ini, kolom ini menunjukkan apakah jam buka 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

Titik 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 terpotong atau tidak. Pemotongan terjadi saat jam sebenarnya berada di luar waktu yang ingin kita tampilkan, sehingga kita memotong jam kembali ke batas ini. Hal ini memastikan bahwa paling lama 24 * 7 jam dari tengah malam pada hari permintaan ditampilkan.

day

integer

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

hour

integer

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

minute

integer

Menit. Rentang dari 0 hingga 59.

Tanggal

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

  • 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 bulan. 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 sekunder.

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

SpecialDay

Informasi terstruktur untuk hari-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 spesial ini.

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 mewakili 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 ini menyediakan layanan yang murah.
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 tersebut.

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

boolean

Tempat ini menerima kartu kredit sebagai pembayaran.

acceptsDebitCards

boolean

Tempat menerima kartu debit sebagai pembayaran.

acceptsCashOnly

boolean

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

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 garasi gratis.

paidGarageParking

boolean

Tempat ini menawarkan parkir garasi berbayar.

SubDestination

Nama resource tempat dan ID sub-tujuan yang terkait dengan tempat. Misalnya, terminal yang berbeda adalah tujuan bandara yang berbeda.

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 parkir khusus pengguna kursi roda.

wheelchairAccessibleEntrance

boolean

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

FuelType

Jenis bahan bakar.

Enum
FUEL_TYPE_UNSPECIFIED Jenis bahan bakar tidak ditentukan.
DIESEL Bahan bakar diesel.
REGULAR_UNLEADED Bensin tanpa timbal biasa.
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 LPG.
E80 E 80.
E85 E 85.
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 Tempat. 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 stasiun memiliki satu atau beberapa port.

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

integer

Jumlah konektor di stasiun 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 dari jumlah total mobil yang dapat mengisi daya secara bersamaan.

connectorAggregation[]

object (ConnectorAggregation)

Daftar agregasi konektor pengisian daya kendaraan listrik yang berisi konektor dari jenis yang sama dan tarif pengisian daya yang sama.

ConnectorAggregation

Informasi pengisian daya kendaraan listrik yang dikelompokkan menurut [type, maxChargeRateKw]. Menampilkan agregasi pengisian daya Kendaraan Listrik dari konektor yang memiliki jenis dan tarif pengisian daya maksimum 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 agregasi.

count

integer

Jumlah konektor dalam agregasi ini.

availabilityLastUpdateTime

string (Timestamp format)

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

availableCount

integer

Jumlah konektor dalam agregasi ini yang saat ini tersedia.

outOfServiceCount

integer

Jumlah konektor dalam agregasi ini yang saat ini tidak dapat digunakan.

EVConnectorType

Lihat http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 untuk informasi/konteks tambahan tentang jenis konektor pengisian daya kendaraan listrik.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Konektor tidak ditentukan.
EV_CONNECTOR_TYPE_OTHER Jenis konektor lainnya.
EV_CONNECTOR_TYPE_J1772 Konektor J1772 jenis 1.
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 bagian lain dunia (misalnya, CCS Combo 2 (CCS2) atau GB/T). Nilai ini kurang mewakili jenis konektor sebenarnya, dan lebih mewakili 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.

GenerativeSummary

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Ringkasan tempat yang dibuat AI.

Representasi JSON
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
Kolom
overview

object (LocalizedText)

Ringkasan tempat.

overviewFlagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan ringkasan.

description

object (LocalizedText)

Deskripsi mendetail tentang tempat.

descriptionFlagContentUri

string

Link tempat pengguna dapat melaporkan masalah dengan ringkasan deskripsi.

references

object (References)

Referensi yang digunakan untuk membuat deskripsi ringkasan.

Referensi

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Referensi yang terkait dengan konten generatif.

Representasi JSON
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Kolom
reviews[]

object (Review)

Ulasan yang berfungsi sebagai referensi.

places[]

string

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

AreaSummary

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Ringkasan area tempat bisnis berada yang dibuat AI.

Representasi JSON
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
Kolom
contentBlocks[]

object (ContentBlock)

Blok konten yang menyusun ringkasan area. Setiap blok memiliki topik terpisah tentang area tersebut.

flagContentUri

string

Link tempat pengguna dapat melaporkan masalah terkait ringkasan.

ContentBlock

Blok konten yang dapat ditayangkan satu per satu.

Representasi JSON
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Kolom
topic

string

Topik konten, misalnya "ringkasan" atau "restoran".

content

object (LocalizedText)

Konten yang terkait dengan topik.

references

object (References)

Eksperimental: Lihat https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative untuk mengetahui detail selengkapnya.

Referensi yang terkait dengan blok konten ini.

ContainingPlace

Info tentang tempat tempat ini berada.

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

string

Nama resource tempat tempat ini berada.

id

string

ID tempat tempat tempat ini berada.

AddressDescriptor

Deskripsi relasional lokasi. Mencakup kumpulan penanda terdekat yang diberi peringkat dan area penampung yang akurat serta hubungannya dengan lokasi target.

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

object (Landmark)

Daftar tempat terkenal di sekitar yang diberi peringkat. Penanda terdekat dan yang paling mudah dikenali akan diberi peringkat pertama.

areas[]

object (Area)

Daftar yang diurutkan berdasarkan area yang berisi atau berdekatan. Area yang paling mudah dikenali dan akurat akan diberi peringkat pertama.

Tempat terkenal

Informasi penanda dasar dan hubungan penanda dengan lokasi target.

Penanda adalah tempat yang mudah dilihat dan 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 penanda.

placeId

string

ID tempat penanda.

displayName

object (LocalizedText)

Nama tampilan penanda.

types[]

string

Kumpulan tag jenis untuk penanda ini. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat https://developers.google.com/maps/documentation/places/web-service/place-types.

spatialRelationship

enum (SpatialRelationship)

Menentukan hubungan spasial antara lokasi target dan penanda.

straightLineDistanceMeters

number

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

travelDistanceMeters

number

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

SpatialRelationship

Menentukan hubungan spasial antara lokasi target dan penanda.

Enum
NEAR Ini adalah hubungan default jika tidak ada yang lebih spesifik di bawah ini yang berlaku.
WITHIN Penanda memiliki geometri spasial dan target berada dalam batasnya.
BESIDE Target berada tepat di samping penanda.
ACROSS_THE_ROAD Target berada tepat di seberang penanda di sisi lain jalan.
DOWN_THE_ROAD Di rute yang sama dengan penanda, tetapi tidak di samping atau di seberang.
AROUND_THE_CORNER Tidak berada di rute yang sama dengan penanda, tetapi hanya satu belokan.
BEHIND Dekat dengan struktur penanda tetapi lebih jauh dari pintu masuk jalannya.

Area

Informasi area dan hubungan area dengan lokasi target.

Area mencakup sublokalitas, lingkungan, dan kompleks besar yang akurat 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 Pembatasan tidak ditentukan.
WITHIN Lokasi target berada dalam wilayah area, dekat dengan pusat.
OUTSKIRTS Lokasi target berada dalam wilayah area, dekat dengan tepi.
NEAR Lokasi target berada di luar wilayah area, tetapi berdekatan.

PriceRange

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

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

object (Money)

Ujung bawah rentang harga (inklusif). Harga harus sama dengan atau lebih tinggi dari jumlah ini.

endPrice

object (Money)

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

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.