REST Resource: places

Resource: Tempat

Semua informasi yang merepresentasikan 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)
  },
  "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)
  }
}
Kolom
name

string

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

id

string

ID unik suatu tempat.

displayName

object (LocalizedText)

Nama tempat yang dilokalkan, sesuai sebagai deskripsi singkat yang dapat dibaca manusia. Misalnya, "Google Sydney", "Starbucks", "Pyrmont", dll.

types[]

string

Sekumpulan tag jenis untuk hasil ini. Misalnya, "politik" dan "lokalitas". Untuk 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 dari hasil yang diberikan. Jenis ini harus merupakan salah satu jenis yang didukung Places API. Misalnya, "restoran", "kafe", "bandara", dll. Sebuah tempat hanya dapat memiliki satu jenis utama. Untuk 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 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 orang untuk tempat ini.

shortFormattedAddress

string

Alamat singkat yang dapat dibaca orang untuk tempat ini.

addressComponents[]

object (AddressComponent)

Komponen berulang untuk setiap tingkat lokalitas. Perhatikan fakta berikut tentang array addressComponents[]: - Array komponen alamat mungkin berisi lebih banyak komponen daripada formatAddress. - 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 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 untuk lintang/bujur lokasi tempat.

location

object (LatLng)

Posisi tempat ini.

viewport

object (Viewport)

Area pandang yang cocok untuk menampilkan tempat pada peta berukuran rata-rata.

rating

number

Rating antara 1,0 dan 5,0, berdasarkan ulasan pengguna 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 suatu jaringan bisnis (misalnya, toko IKEA), biasanya berupa situs untuk toko tersebut, bukan keseluruhan jaringan bisnis tersebut.

reviews[]

object (Review)

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

regularOpeningHours

object (OpeningHours)

Jam operasional reguler.

photos[]

object (Photo)

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

adrFormatAddress

string

Alamat tempat tersebut dalam adr microformat: 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 bersama hasil ini.

iconMaskBaseUri

string

URL yang terpotong ke mask ikon. Pengguna dapat mengakses jenis ikon yang berbeda dengan menambahkan akhiran jenis ke akhir (misalnya, ".svg" atau ".png").

iconBackgroundColor

string

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

currentOpeningHours

object (OpeningHours)

Jam operasional selama tujuh hari ke depan (termasuk hari ini). Jangka waktu tersebut 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 sekunder berbeda dari jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pengiriman sebagai jam sekunder. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang ditentukan sebelumnya (seperti DRIVE_SMS, 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 sekunder reguler bisnis. Jam sekunder berbeda dari jam buka utama bisnis. Misalnya, restoran dapat menentukan jam drive-through atau jam pengiriman sebagai jam sekunder. Kolom ini mengisi subkolom jenis, yang diambil dari daftar jenis jam buka yang ditentukan sebelumnya (seperti DRIVE_SMS, PICKUP, atau takeOUT) berdasarkan jenis tempat.

editorialSummary

object (LocalizedText)

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

paymentOptions

object (PaymentOptions)

Opsi pembayaran yang diterima tempat tersebut. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran akan dibatalkan penetapannya.

parkingOptions

object (ParkingOptions)

Opsi parkir yang disediakan oleh tempat tersebut.

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

utcOffsetMinutes

integer

Selisih jumlah menit antara zona waktu tempat ini saat ini dari UTC. Hal 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 pengeksporan.

delivery

boolean

Menentukan apakah bisnis mendukung layanan pesan antar.

dineIn

boolean

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

curbsidePickup

boolean

Menentukan apakah bisnis mendukung opsi ambil di tepi jalan.

reservable

boolean

Menentukan apakah tempat mendukung reservasi.

servesBreakfast

boolean

Menentukan apakah tempat 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 menyajikan anggur.

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 menyediakan musik live.

menuForChildren

boolean

Tempat ini memiliki menu anak-anak.

servesCocktails

boolean

Tempat menyajikan koktail.

servesDessert

boolean

Tempat ini menyajikan hidangan pencuci mulut.

servesCoffee

boolean

Tempat menyajikan kopi.

goodForChildren

boolean

Tempat ini cocok untuk anak-anak.

allowsDogs

boolean

{i>Place <i}memungkinkan {i>dogs<i}.

restroom

boolean

Tempat ini memiliki toilet.

goodForGroups

boolean

Tempat mengakomodasi grup.

goodForWatchingSports

boolean

Tempat ini cocok untuk menonton acara olahraga.

accessibilityOptions

object (AccessibilityOptions)

Informasi tentang opsi aksesibilitas yang ditawarkan tempat.

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 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 dari "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 14 m x 14 m (1/8000 derajat) atau kotak yang 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 mewakili area 1/8000 x 1/8000 derajat (~14 kali 14 meter).

compoundCode

string

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

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double 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 Tampilan

Area pandang lintang dan bujur, yang direpresentasikan sebagai dua titik low dan high yang secara diagonal berlawanan. Area pandang dianggap sebagai area 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 pandang melintasi garis bujur 180 derajat).

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

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

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

low dan high harus diisi, dan kotak yang diwakili tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menghasilkan 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 rendah area pandang.

high

object (LatLng)

Wajib. Titik tinggi area pandang.

Review

Informasi tentang ulasan suatu tempat.

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

string

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

relativePublishTimeDescription

string

String waktu terbaru yang diformat, 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, juga disebut jumlah bintang.

authorAttribution

object (AuthorAttribution)

Penulis ulasan ini.

publishTime

string (Timestamp format)

Stempel waktu untuk peninjauan.

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

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)
    }
  ],
  "openNow": boolean
}
Kolom
periods[]

object (Period)

Periode tempat ini buka selama seminggu. Periode ini diurutkan secara kronologis, dimulai dari hari Minggu di zona waktu tempat-tempat lokal. Nilai kosong (tetapi tidak ada) menunjukkan tempat yang tidak pernah buka, misalnya karena tutup 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 buka tidak diketahui atau tidak dapat dikonversi ke teks yang dilokalkan. Contoh: "Sun: 18.00–06.00"

secondaryHoursType

enum (SecondaryHoursType)

String jenis yang digunakan untuk mengidentifikasi jenis jam buka sekunder.

specialDays[]

object (SpecialDay)

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

openNow

boolean

Apakah tempat ini buka sekarang? Selalu ada kecuali jika kami tidak memiliki data waktu atau zona waktu untuk jam buka ini.

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

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 ketika jam sebenarnya berada di luar waktu yang ingin kami kembalikan, jadi kami memotong jam kembali ke batas tersebut. Hal ini memastikan bahwa paling banyak 24 * 7 jam dari tengah malam pada hari permintaan dikembalikan.

day

integer

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

hour

integer

Jam dalam 2 digit. Rentang dari 00 hingga 23.

minute

integer

Menit dalam 2 digit. Rentang dari 00 hingga 59.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan nol tahun (misalnya, hari jadi).
  • Setahun dengan sendirinya, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan nol hari (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 saat jenis jam sekunder tidak ditentukan.
DRIVE_THROUGH Jam drive-through untuk bank, restoran, atau apotek.
HAPPY_HOUR Waktu senang-senang.
DELIVERY Jam pengiriman.
TAKEOUT Jam layanan bawa pulang.
KITCHEN Jam memasak.
BREAKFAST Jam sarapan.
LUNCH Jam makan siang.
DINNER Jam makan malam.
BRUNCH Jam sarapan siang.
PICKUP Waktu penjemputan.
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 berada 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 sebuah tempat.

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

string

Pengenal. Referensi yang mewakili foto tempat ini, yang mungkin digunakan untuk mencari foto tempat ini lagi (juga disebut nama "sumber daya" 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.

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 usaha tutup permanen.

PriceLevel

Tingkat harga tempat.

Enum
PRICE_LEVEL_UNSPECIFIED Tingkat harga tempat tidak ditentukan atau tidak diketahui.
PRICE_LEVEL_FREE Place menyediakan layanan gratis.
PRICE_LEVEL_INEXPENSIVE Place menyediakan layanan murah.
PRICE_LEVEL_MODERATE Place menyediakan layanan dengan harga menengah.
PRICE_LEVEL_EXPENSIVE Place menyediakan layanan yang mahal.
PRICE_LEVEL_VERY_EXPENSIVE Place 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

Tempatkan kartu kredit sebagai pembayaran.

acceptsDebitCards

boolean

Place menerima kartu debit sebagai pembayaran.

acceptsCashOnly

boolean

Place hanya menerima uang tunai sebagai pembayaran. Tempat dengan atribut ini mungkin masih menerima metode pembayaran lain.

acceptsNfc

boolean

Place 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

Place menawarkan tempat parkir gratis.

paidParkingLot

boolean

Tempat ini menawarkan tempat parkir berbayar.

freeStreetParking

boolean

Place menawarkan parkir di pinggir jalan gratis.

paidStreetParking

boolean

Place menawarkan parkir di pinggir jalan berbayar.

valetParking

boolean

Tempat menawarkan parkir valet.

freeGarageParking

boolean

Place menawarkan parkir di garasi gratis.

paidGarageParking

boolean

Tempat menawarkan parkir berbayar di garasi.

SubDestination

Tempatkan nama resource dan id sub-tujuan yang berhubungan dengan tempat. Misalnya, terminal yang berbeda adalah tujuan yang berbeda dari sebuah bandara.

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

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

boolean

Place 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 memiliki 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 yang diketahui terakhir untuk setiap jenis bahan bakar yang dimiliki SPBU ini. Ada satu tiket masuk 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 maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

FuelType

Jenis bahan bakar.

Enum
FUEL_TYPE_UNSPECIFIED Jenis bahan bakar belum ditetapkan.
DIESEL Bahan bakar diesel.
REGULAR_UNLEADED Reguler tanpa timbal.
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 Bio-diesel.
TRUCK_DIESEL Truk diesel.

Uang

Menyatakan jumlah uang dengan jenis mata uangnya.

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

string

Tiga huruf kode mata uang 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 satuan nano (10^-9) dari jumlahnya. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos bisa 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 berikut https://afdc.energy.gov/fuels/electricity_infrastructure.html Satu port dapat mengisi daya satu mobil pada 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 (mis.) 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 dengan jenis dan kecepatan pengisian daya yang sama.

ConnectorAggregation

Informasi SPKLU dikelompokkan berdasarkan [jenis, maxChargeRateKw]. Menampilkan agregasi pengisian daya EV dari konektor yang memiliki jenis dan tingkat 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

Rasio pengisian daya maksimum statis dalam kw 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 maksimal sembilan digit fraksional. 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 berfungsi.

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 tipe 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 Sistem Pengisian Daya Gabungan (AC dan DC). Berdasarkan SAE. Konektor J-1772 Tipe-1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistem Pengisian Daya Gabungan (AC dan DC). Berdasarkan konektor Mennekes Tipe-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 Kombo 2 (CCS2) atau GB/T). Nilai ini kurang mewakili jenis konektor sebenarnya, dan lebih mewakili kemampuan untuk mengisi daya kendaraan bermerek Tesla di SPKLU 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.

Metode

autocomplete

Menampilkan prediksi untuk input yang diberikan.

get

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

searchNearby

Menelusuri tempat di dekat lokasi.

searchText

Kueri teks berdasarkan penelusuran tempat.