REST Resource: places

แหล่งข้อมูล: สถานที่

ข้อมูลทั้งหมดที่แสดงถึงสถานที่

การแสดง 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)
  }
}
ช่อง
name

string

ชื่อทรัพยากรของสถานที่นี้ในรูปแบบ places/{placeId} สามารถใช้เพื่อค้นหาสถานที่
id

string

ตัวระบุที่ไม่ซ้ำกันของสถานที่
displayName

object (LocalizedText)

ชื่อที่แปลแล้วของสถานที่ เหมาะที่จะเป็นคำอธิบายสั้นๆ ที่มนุษย์อ่านได้ เช่น "Google Sydney", "Starbucks", "Pyrmont" ฯลฯ
types[]

string

ชุดของแท็กประเภทสำหรับผลลัพธ์นี้ เช่น "การเมือง" และ "ย่าน" ดูรายการค่าที่เป็นไปได้ทั้งหมดในตาราง A และตาราง B ที่ https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

ประเภทหลักของผลการค้นหาที่ระบุ ประเภทนี้ต้องเป็นประเภทที่รองรับ Places API เช่น "ร้านอาหาร" "คาเฟ่" "สนามบิน" ฯลฯ สถานที่มีประเภทหลักได้เพียงประเภทเดียวเท่านั้น ดูรายการค่าที่เป็นไปได้ทั้งหมดในตาราง A และตาราง B ที่ https://developers.google.com/maps/documentation/places/web-service/place-types
primaryTypeDisplayName

object (LocalizedText)

ชื่อที่แสดงของประเภทหลัก ซึ่งแปลเป็นภาษาในคำขอ (หากมี) ดูรายการค่าที่เป็นไปได้ทั้งหมดในตาราง A และตาราง B ที่ https://developers.google.com/maps/documentation/places/web-service/place-types
nationalPhoneNumber

string

หมายเลขโทรศัพท์ที่มนุษย์อ่านได้สำหรับสถานที่นั้น ซึ่งอยู่ในรูปแบบระดับประเทศ
internationalPhoneNumber

string

หมายเลขโทรศัพท์ที่มนุษย์อ่านได้ของสถานที่ดังกล่าวในรูปแบบระหว่างประเทศ
formattedAddress

string

ที่อยู่แบบเต็มที่มนุษย์อ่านได้สำหรับสถานที่นี้
shortFormattedAddress

string

ที่อยู่สั้นๆ ที่มนุษย์อ่านได้สำหรับสถานที่นี้
addressComponents[]

object (AddressComponent)

คอมโพเนนต์ที่ซ้ำกันสำหรับแต่ละระดับย่าน ข้อเท็จจริงเกี่ยวกับอาร์เรย์ addressคอมโพเนนต์[] มีดังนี้ - อาร์เรย์ของคอมโพเนนต์ที่อยู่อาจมีคอมโพเนนต์มากกว่า formatAddress - อาร์เรย์ไม่จำเป็นต้องรวมหน่วยงานทางการเมืองทั้งหมดที่มีที่อยู่ นอกเหนือจากที่อยู่ใน formatAddress หากต้องการดึงข้อมูลหน่วยงานทางการเมืองทั้งหมดที่มีที่อยู่หนึ่งๆ คุณควรใช้การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ โดยส่งผ่านละติจูด/ลองจิจูดของที่อยู่เป็นพารามิเตอร์ไปยังคำขอ - เราไม่รับประกันว่ารูปแบบของการตอบกลับระหว่างคำขอจะยังคงเหมือนเดิม โดยเฉพาะอย่างยิ่ง จำนวนของ addressElements จะแตกต่างกันไปตามที่อยู่ที่ขอ และอาจมีการเปลี่ยนแปลงสำหรับที่อยู่เดียวกันเมื่อเวลาผ่านไป คอมโพเนนต์เปลี่ยนตำแหน่งในอาร์เรย์ได้ ประเภทของคอมโพเนนต์สามารถเปลี่ยนแปลงได้ คอมโพเนนต์บางรายการอาจหายไปในการตอบสนองในภายหลัง
plusCode

object (PlusCode)

Plus Code ของตำแหน่งสถานที่ละติจูด/ลองจิจูด
location

object (LatLng)

ตำแหน่งของสถานที่นี้
viewport

object (Viewport)

วิวพอร์ตที่เหมาะสำหรับการแสดงสถานที่บนแผนที่ขนาดเฉลี่ย
rating

number

คะแนนระหว่าง 1.0 ถึง 5.0 ตามรีวิวของผู้ใช้เกี่ยวกับสถานที่นี้
googleMapsUri

string

URL ที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับสถานที่นี้
websiteUri

string

เว็บไซต์ที่เชื่อถือได้ของสถานที่นี้ เช่น หน้าแรกของธุรกิจ โปรดทราบว่าสำหรับสถานที่ที่เป็นส่วนหนึ่งของเครือ (เช่น ร้านค้า IKEA) โดยปกติจะเป็นเว็บไซต์ของร้านค้าแต่ละแห่ง ไม่ใช่เว็บไซต์ในเครือทั้งหมด
reviews[]

object (Review)

รายการรีวิวเกี่ยวกับสถานที่นี้โดยจัดเรียงตามความเกี่ยวข้อง คุณส่งคืนรีวิวได้สูงสุด 5 รายการ
regularOpeningHours

object (OpeningHours)

เวลาทำการปกติ
photos[]

object (Photo)

ข้อมูล (รวมถึงข้อมูลอ้างอิง) เกี่ยวกับรูปภาพของสถานที่นี้ สามารถส่งคืนรูปภาพได้สูงสุด 10 ภาพ
adrFormatAddress

string

ที่อยู่ของสถานที่ใน adr microformat: http://microformats.org/wiki/adr
businessStatus

enum (BusinessStatus)

สถานะธุรกิจของสถานที่
priceLevel

enum (PriceLevel)

ระดับราคาของสถานที่นี้
attributions[]

object (Attribution)

กลุ่มผู้ให้บริการข้อมูลที่ต้องแสดงพร้อมกับผลการค้นหานี้
iconMaskBaseUri

string

URL ที่ถูกตัดไปยังมาสก์ไอคอน ผู้ใช้สามารถเข้าถึงไอคอนประเภทต่างๆ ได้โดยต่อท้ายประเภทต่อท้าย (เช่น ".svg" หรือ ".png")
iconBackgroundColor

string

สีพื้นหลังของ icon_mask ในรูปแบบเลขฐานสิบหก เช่น #909CE1
currentOpeningHours

object (OpeningHours)

เวลาทำการในอีก 7 วันข้างหน้า (รวมวันนี้) ระยะเวลาเริ่มต้นตอนเที่ยงคืนของวันที่ส่งคำขอ และสิ้นสุดเวลา 23:59 น. ใน 6 วันถัดไป ช่องนี้จะมีช่องย่อย SpecialDays ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ
currentSecondaryOpeningHours[]

object (OpeningHours)

มีอาร์เรย์ของรายการในช่วง 7 วันข้างหน้า รวมถึงข้อมูลเกี่ยวกับเวลาทําการรองของธุรกิจ เวลาทำการรองต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุเวลาขับรถทรูหรือเวลาจัดส่งเป็นเวลาทำการรอง ช่องนี้เติมข้อมูลในช่องย่อยประเภท ซึ่งดึงมาจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น DRIVE_THROUGH, PICKUP หรือ TAKEOUT) โดยอิงตามประเภทของสถานที่ ช่องนี้จะมีช่องย่อย SpecialDays ของเวลาทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ
regularSecondaryOpeningHours[]

object (OpeningHours)

มีอาร์เรย์ของรายการสำหรับข้อมูลเกี่ยวกับเวลาทําการรองปกติของธุรกิจ เวลาทำการรองต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุเวลาขับรถทรูหรือเวลาจัดส่งเป็นเวลาทำการรอง ช่องนี้เติมข้อมูลในช่องย่อยประเภท ซึ่งดึงมาจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น DRIVE_THROUGH, PICKUP หรือ TAKEOUT) โดยอิงตามประเภทของสถานที่
editorialSummary

object (LocalizedText)

มีข้อมูลสรุปของสถานที่ ข้อมูลสรุปจะประกอบด้วยข้อความภาพรวม และมีรหัสภาษาสำหรับข้อมูลเหล่านี้ด้วย (หากมี) ข้อความสรุปต้องนำเสนอตามที่เป็นอยู่ และจะแก้ไขหรือเปลี่ยนแปลงไม่ได้
paymentOptions

object (PaymentOptions)

ตัวเลือกการชำระเงินที่สถานที่ยอมรับ หากข้อมูลตัวเลือกการชำระเงินไม่พร้อมใช้งาน ระบบจะยกเลิกการตั้งค่าช่องตัวเลือกการชำระเงิน
parkingOptions

object (ParkingOptions)

ตัวเลือกที่จอดรถที่สถานที่มีให้บริการ
subDestinations[]

object (SubDestination)

รายการจุดหมายย่อยที่เกี่ยวข้องกับสถานที่
fuelOptions

object (FuelOptions)

ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงในปั๊มน้ำมัน ข้อมูลนี้ได้รับการอัปเดตอย่างสม่ำเสมอ
evChargeOptions

object (EVChargeOptions)

ข้อมูลของตัวเลือกการชาร์จแบตเตอรี่ EV
utcOffsetMinutes

integer

ปัจจุบันเขตเวลาของสถานที่แห่งนี้ถูกออฟเซ็ตจาก UTC เป็นนาที ซึ่งจะแสดงเป็นนาทีเพื่อรองรับเขตเวลาที่มีการชดเชยด้วยเศษส่วนของชั่วโมง เช่น X ชั่วโมงและ 15 นาที
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)

ข้อมูลเกี่ยวกับตัวเลือกการช่วยเหลือพิเศษที่สถานที่นั้นๆ มีให้

LocalizedText

รูปแบบข้อความที่แปลแล้วในภาษาใดภาษาหนึ่ง

การแสดง JSON 
{
  "text": string,
  "languageCode": string
}
ช่อง
text

string

สตริงที่แปลแล้วในภาษาที่สอดคล้องกับ languageCode ด้านล่าง
languageCode

string

รหัสภาษา BCP-47 ของข้อความ เช่น "en-US" หรือ "sr-Latn"

ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier

AddressComponent

คอมโพเนนต์ที่มีโครงสร้างซึ่งสร้างที่อยู่ที่จัดรูปแบบ หากมีข้อมูลนี้

การแสดง JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
ช่อง
longText

string

คำอธิบายข้อความแบบเต็มหรือชื่อของคอมโพเนนต์ที่อยู่ ตัวอย่างเช่น ส่วนประกอบที่อยู่สำหรับประเทศออสเตรเลียอาจมี Long_name เป็น "Australia"
shortText

string

ชื่อที่เป็นข้อความแบบย่อสำหรับองค์ประกอบที่อยู่ หากมี เช่น คอมโพเนนต์ที่อยู่สำหรับประเทศออสเตรเลียอาจมี short_name เป็น "AU"
types[]

string

อาร์เรย์ที่ระบุประเภทของคอมโพเนนต์ที่อยู่
languageCode

string

ภาษาที่ใช้จัดรูปแบบคอมโพเนนต์นี้ในรูปแบบ CLDR

PlusCode

โค้ด Plus (http://plus.codes) เป็นการอ้างอิงตำแหน่งที่มี 2 รูปแบบ คือ โค้ดส่วนกลางที่กำหนดขนาด 14mx14m (1/8000 ขององศา) หรือสี่เหลี่ยมผืนผ้าเล็ก และโค้ดแบบผสมแทนที่คำนำหน้าด้วยตำแหน่งอ้างอิง

การแสดง JSON 
{
  "globalCode": string,
  "compoundCode": string
}
ช่อง
globalCode

string

รหัสทั่วโลก (แบบสมบูรณ์) เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ 1/8000 x 1/8000 องศา (ประมาณ 14 x 14 เมตร)
compoundCode

string

รหัสประกอบของสถานที่ เช่น "33GV+HQ, รามเบิร์ก, นอร์เวย์" ซึ่งมีส่วนต่อท้ายของรหัสสากล และแทนที่คำนำหน้าด้วยชื่อที่มีการจัดรูปแบบของเอนทิตีอ้างอิง

LatLng

วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ค่านี้แสดงเป็นเลขคู่คู่แทนองศาละติจูดและลองจิจูดองศา ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ภายในช่วงมาตรฐาน

การแสดง JSON 
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูดเป็นองศา ค่าต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูด หน่วยเป็นองศา ค่าต้องอยู่ในช่วง [-180.0, +180.0]

วิวพอร์ต

วิวพอร์ตละติจูด-ลองจิจูด ซึ่งแสดงเป็นแนวทแยงมุม 2 จุดตรงข้ามกับจุด low และจุด high วิวพอร์ตถือเป็นพื้นที่แบบปิด กล่าวคือ รวมขอบเขตของวิวพอร์ตไว้ด้วย ขอบเขตละติจูดต้องอยู่ในช่วง -90 ถึง 90 องศา และขอบเขตลองจิจูดต้องอยู่ในช่วง -180 ถึง 180 องศา กรณีต่างๆ ได้แก่

  • หาก low = high วิวพอร์ตจะประกอบด้วยจุดเดียวนั้น

  • หาก low.longitude > high.longitude ช่วงลองจิจูดจะกลับกัน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา)

  • หาก low.longitude = -180 องศาและ high.longitude = 180 องศา วิวพอร์ตจะรวมลองจิจูดทั้งหมด

  • หาก low.longitude = 180 องศาและ high.longitude = -180 องศา ช่วงลองจิจูดจะว่างเปล่า

  • หากเป็น low.latitude > high.latitude ช่วงละติจูดจะว่างเปล่า

ต้องระบุทั้ง low และ high และช่องแทนต้องไม่ว่างเปล่า (ตามที่ระบุด้วยคำจำกัดความด้านบน) การมีวิวพอร์ตที่ว่างเปล่าจะทำให้เกิดข้อผิดพลาด

ตัวอย่างเช่น วิวพอร์ตนี้รวมนครนิวยอร์กทั้งหมดดังนี้

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

การแสดง JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ช่อง
low

object (LatLng)

ต้องระบุ จุดต่ำของวิวพอร์ต
high

object (LatLng)

ต้องระบุ จุดสูงของวิวพอร์ต

รีวิว

ข้อมูลเกี่ยวกับรีวิวของสถานที่

การแสดง JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
ช่อง
name

string

ข้อมูลอ้างอิงที่แสดงถึงรีวิวสถานที่นี้ ซึ่งอาจใช้ในการค้นหารีวิวสถานที่นี้อีกครั้ง (หรือที่เรียกว่าชื่อ "ทรัพยากร" ของ API: places/{placeId}/reviews/{review})
relativePublishTimeDescription

string

สตริงเวลาล่าสุดที่จัดรูปแบบ ซึ่งแสดงเวลาในการตรวจสอบที่สัมพันธ์กับเวลาปัจจุบันในแบบฟอร์มที่เหมาะสมสำหรับภาษาและประเทศ
text

object (LocalizedText)

ข้อความที่แปลแล้วของรีวิว
originalText

object (LocalizedText)

ข้อความรีวิวในภาษาต้นฉบับ
rating

number

ตัวเลขระหว่าง 1.0 ถึง 5.0 หรือเรียกว่าจำนวนดาว
authorAttribution

object (AuthorAttribution)

ผู้เขียนรีวิวนี้
publishTime

string (Timestamp format)

การประทับเวลาสำหรับการตรวจสอบ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

AuthorAttribution

ข้อมูลเกี่ยวกับผู้เขียนข้อมูลเนื้อหาที่ผู้ใช้สร้างขึ้น ใช้ในPhotoและReview

การแสดง JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
ช่อง
displayName

string

ชื่อผู้เขียน Photo หรือ Review
uri

string

URI ของผู้เขียน Photo หรือ Review
photoUri

string

URI รูปโปรไฟล์ของผู้เขียน Photo หรือ Review

OpeningHours

ข้อมูลเกี่ยวกับเวลาทําการของสถานที่

การแสดง JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
ช่อง
periods[]

object (Period)

ช่วงเวลาที่สถานที่แห่งนี้เปิดทำการในระหว่างสัปดาห์ ช่วงเวลาจะเรียงตามลำดับเวลา เริ่มจากวันอาทิตย์ในเขตเวลาท้องถิ่นของสถานที่ ค่าว่าง (แต่ไม่ได้ขาดไป) บ่งชี้ถึงสถานที่ที่ไม่เคยเปิด เช่น เพราะปิดทำการปรับปรุงชั่วคราว
weekdayDescriptions[]

string

สตริงที่แปลแล้วที่อธิบายเวลาทำการของสถานที่นี้ สตริง 1 รายการสำหรับแต่ละวันของสัปดาห์ ค่านี้จะว่างเปล่าหากไม่ทราบเวลาทำการหรือแปลงเป็นข้อความที่แปลแล้วไม่ได้ เช่น "อาทิตย์: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

สตริงประเภทที่ใช้ระบุประเภทของเวลาทําการรอง
specialDays[]

object (SpecialDay)

Structured Data สำหรับวันพิเศษที่อยู่ภายในระยะเวลาที่เวลาทำการที่แสดงครอบคลุม วันพิเศษคือวันที่อาจส่งผลต่อเวลาทำการของสถานที่ เช่น วันคริสต์มาส ตั้งค่าไว้สำหรับ currentOpeningHours และ currentPrimaryOpeningHours
openNow

boolean

สถานที่นี้เปิดอยู่ตอนนี้ไหม แสดงตลอดเวลา เว้นแต่เราจะไม่มีข้อมูลช่วงเวลาของวันหรือเขตเวลาสำหรับเวลาทำการเหล่านี้

ระยะเวลา

ช่วงเวลาที่สถานที่ดังกล่าวยังคงอยู่ในสถานะ openNow

การแสดง JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
ช่อง
open

object (Point)

เวลาที่สถานที่เริ่มเปิดทำการ
close

object (Point)

เวลาที่สถานที่เริ่มปิด

จุด

คะแนนการเปลี่ยนสถานะ

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
ช่อง
date

object (Date)

วันที่ในเขตเวลาท้องถิ่นของสถานที่
truncated

boolean

ปลายทางนี้ถูกตัดออกหรือไม่ การตัดทอนจะเกิดขึ้นเมื่อเวลาจริงอยู่นอกช่วงเวลาที่เราต้องการแสดงเวลาทำการระหว่างนั้น ดังนั้นเราจึงตัดชั่วโมงดังกล่าวกลับไปยังขอบเขตเหล่านี้ วิธีนี้ช่วยให้มั่นใจว่าระบบจะส่งคืนคำขอไม่เกิน 24 * 7 ชั่วโมงนับจากเที่ยงคืนของวันที่ส่งคำขอ
day

integer

วันของสัปดาห์เป็นจำนวนเต็มในช่วง 0-6 0 คือวันอาทิตย์ 1 คือวันจันทร์ เป็นต้น
hour

integer

ชั่วโมงเป็นเลข 2 หลัก ค่าอยู่ในช่วง 00 ถึง 23
minute

integer

เลขนาที 2 หลัก ค่าอยู่ในช่วงระหว่าง 00 ถึง 59

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลามีการระบุไว้ที่อื่นหรือไม่มีนัยสำคัญ โดยวันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจแสดงถึงข้อใดข้อหนึ่งต่อไปนี้

  • วันที่แบบเต็มซึ่งมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • ผ่านไป 1 ปี โดยมี 0 เดือนกับ 0 วัน
  • ปีและเดือนที่มี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง:

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือปีและเดือนที่วันไม่เป็นนัยสำคัญ

SecondaryHoursType

ประเภทที่ใช้ระบุประเภทของเวลาทําการรอง

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุประเภทเวลารอง
DRIVE_THROUGH เวลาไดรฟ์ทรูสำหรับธนาคาร ร้านอาหาร หรือร้านขายยา
HAPPY_HOUR ช่วงลดราคาอาหารหรือเครื่องดื่ม
DELIVERY ชั่วโมงนำส่ง
TAKEOUT ช่วงเวลาที่ให้บริการสั่งกลับบ้าน
KITCHEN ชั่วโมงครัว
BREAKFAST ช่วงเวลาอาหารเช้า
LUNCH ช่วงเวลาอาหารกลางวัน
DINNER ช่วงเวลาอาหารเย็น
BRUNCH ช่วงเวลาอาหารมื้อสาย
PICKUP ช่วงเวลารับสินค้า
ACCESS จำนวนชั่วโมงที่เข้าถึงพื้นที่เก็บข้อมูล
SENIOR_HOURS เวลาทำการพิเศษสำหรับผู้สูงอายุ
ONLINE_SERVICE_HOURS เวลาทำการออนไลน์

SpecialDay

Structured Data สำหรับวันพิเศษที่อยู่ภายในระยะเวลาที่เวลาทำการที่แสดงครอบคลุม วันพิเศษคือวันที่อาจส่งผลต่อเวลาทำการของสถานที่ เช่น วันคริสต์มาส

การแสดง JSON 
{
  "date": {
    object (Date)
  }
}
ช่อง
date

object (Date)

วันที่สำหรับวันพิเศษนี้

รูปภาพ

ข้อมูลเกี่ยวกับรูปภาพของสถานที่

การแสดง JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
ช่อง
name

string

ตัวระบุ ข้อมูลอ้างอิงแทนรูปภาพของสถานที่นี้ซึ่งอาจนำมาใช้เพื่อค้นหารูปภาพของสถานที่นี้อีกครั้ง (หรือที่เรียกว่าชื่อ "ทรัพยากร" ของ API: places/{placeId}/photos/{photo})
widthPx

integer

ความกว้างสูงสุดที่ใช้ได้เป็นพิกเซล
heightPx

integer

ความสูงที่มีได้สูงสุดในหน่วยพิกเซล
authorAttributions[]

object (AuthorAttribution)

ผู้เขียนของรูปภาพนี้

BusinessStatus

สถานะธุรกิจของสถานที่

Enum
BUSINESS_STATUS_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
OPERATIONAL สถานประกอบการยังดำเนินกิจการอยู่ อาจจะยังไม่ได้เปิดอยู่ในตอนนี้
CLOSED_TEMPORARILY สถานประกอบการถูกปิดชั่วคราว
CLOSED_PERMANENTLY สถานประกอบการถูกปิดเป็นการถาวร

PriceLevel

ระดับราคาของสถานที่นี้

Enum
PRICE_LEVEL_UNSPECIFIED ไม่ได้ระบุหรือไม่ทราบระดับราคาของสถานที่
PRICE_LEVEL_FREE ที่พักมีบริการฟรี
PRICE_LEVEL_INEXPENSIVE สถานที่นี้ให้บริการไม่แพง
PRICE_LEVEL_MODERATE สถานที่นี้ให้บริการในราคาปานกลาง
PRICE_LEVEL_EXPENSIVE สถานที่นี้มีบริการราคาแพง
PRICE_LEVEL_VERY_EXPENSIVE สถานที่นี้ให้บริการราคาแพงมาก

การระบุแหล่งที่มา

ข้อมูลเกี่ยวกับผู้ให้บริการข้อมูลของสถานที่นี้

การแสดง JSON 
{
  "provider": string,
  "providerUri": string
}
ช่อง
provider

string

ชื่อผู้ให้บริการข้อมูลของสถานที่
providerUri

string

URI ไปยังผู้ให้บริการข้อมูลของสถ านที่

PaymentOptions

ตัวเลือกการชำระเงินที่สถานที่ยอมรับ

การแสดง JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
ช่อง
acceptsCreditCards

boolean

สถานที่รับบัตรเครดิตเป็นการชำระเงิน
acceptsDebitCards

boolean

รับบัตรเดบิตเป็นการชำระเงิน
acceptsCashOnly

boolean

สถานที่รับชำระเงินเป็นเงินสดเท่านั้น สถานที่ที่มีแอตทริบิวต์นี้อาจยังยอมรับวิธีการชำระเงินอื่นๆ อยู่
acceptsNfc

boolean

สถานที่นี้รับชำระเงินผ่าน NFC

ParkingOptions

ข้อมูลเกี่ยวกับตัวเลือกที่จอดรถของสถานที่ ที่จอดรถอาจรองรับตัวเลือกมากกว่า 1 แบบพร้อมกัน

การแสดง JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
ช่อง
freeParkingLot

boolean

สถานที่ให้บริการที่จอดรถฟรี
paidParkingLot

boolean

สถานที่มีที่จอดรถแบบเสียค่าใช้จ่าย
freeStreetParking

boolean

ที่พักมีที่จอดรถริมถนนฟรี
paidStreetParking

boolean

Place มีที่จอดรถริมถนนแบบเสียค่าใช้จ่าย
valetParking

boolean

ที่พักมีบริการนำรถไปจอดให้
freeGarageParking

boolean

ที่พักมีโรงจอดรถฟรี
paidGarageParking

boolean

ที่พักมีโรงจอดรถแบบเสียค่าใช้จ่าย

SubDestination

วางชื่อทรัพยากรและรหัสของปลายทางย่อยที่เกี่ยวข้องกับสถานที่ เช่น เทอร์มินัลที่ต่างกันคือจุดหมายที่ต่างกันของสนามบิน

การแสดง JSON 
{
  "name": string,
  "id": string
}
ช่อง
name

string

ชื่อทรัพยากรของปลายทางย่อย
id

string

รหัสสถานที่ของปลายทางย่อย

AccessibilityOptions

ข้อมูลเกี่ยวกับตัวเลือกการช่วยเหลือพิเศษที่สถานที่นั้นๆ มีให้

การแสดง JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
ช่อง
wheelchairAccessibleParking

boolean

ที่พักมีที่จอดรถสำหรับผู้ใช้รถเข็น
wheelchairAccessibleEntrance

boolean

สถานที่ต่างๆ มีทางเข้าสำหรับเก้าอี้รถเข็น
wheelchairAccessibleRestroom

boolean

ที่พักมีห้องน้ำสำหรับเก้าอี้รถเข็น
wheelchairAccessibleSeating

boolean

ที่พักมีที่นั่งสำหรับเก้าอี้รถเข็น

FuelOptions

ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงในปั๊มน้ำมัน ข้อมูลนี้ได้รับการอัปเดตอย่างสม่ำเสมอ

การแสดง JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
ช่อง
fuelPrices[]

object (FuelPrice)

ราคาเชื้อเพลิงที่ทราบล่าสุดสำหรับเชื้อเพลิงแต่ละประเภทที่สถานีนี้มี สถานีนี้มี 1 บัตรผ่านต่อประเภทเชื้อเพลิง ลำดับไม่สำคัญ

FuelPrice

ข้อมูลราคาเชื้อเพลิงของแต่ละประเภท

การแสดง JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
ช่อง
type

enum (FuelType)

ประเภทของเชื้อเพลิง
price

object (Money)

ราคาเชื้อเพลิง
updateTime

string (Timestamp format)

เวลาที่อัปเดตราคาน้ำมันครั้งล่าสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

FuelType

ประเภทเชื้อเพลิง

Enum
FUEL_TYPE_UNSPECIFIED ประเภทเชื้อเพลิงที่ไม่ระบุ
DIESEL เชื้อเพลิงดีเซล
REGULAR_UNLEADED ไร้โอกาสเป็นประจำ
MIDGRADE เบนซินระดับกลาง
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 จ 85.
METHANE มีเทน
BIO_DIESEL ไบโอดีเซล
TRUCK_DIESEL น้ำมันดีเซลสำหรับรถบรรทุก

เงินทอง

แสดงจำนวนเงินพร้อมประเภทสกุลเงิน

การแสดง JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
ช่อง
currencyCode

string

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217
units

string (int64 format)

หน่วยทั้งหมดของจำนวนเงิน เช่น หาก currencyCode คือ "USD" ก็ให้ 1 หน่วยเป็น 1 ดอลลาร์สหรัฐ
nanos

integer

จำนวนหน่วยนาโน (10^-9) ของปริมาตร ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก units เป็นค่าบวก nanos ต้องเป็นค่าบวกหรือ 0 หาก units เป็น 0 ค่า nanos อาจเป็นค่าบวก 0 หรือค่าลบก็ได้ หาก units เป็นค่าลบ nanos ต้องเป็นค่าลบหรือ 0 เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000

EVChargeOptions

ข้อมูลเกี่ยวกับสถานีชาร์จ EV ที่โฮสต์ในสถานที่ คำศัพท์ที่พูดตาม https://afdc.energy.gov/fuels/electricity_infrastructure.html พอร์ตชาร์จได้ทีละ 1 คัน พอร์ต 1 พอร์ตมีขั้วต่ออย่างน้อย 1 ตัว สถานี 1 แห่งมีพอร์ตอย่างน้อย 1 พอร์ต

การแสดง JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
ช่อง
connectorCount

integer

จำนวนขั้วต่อที่สถานีนี้ อย่างไรก็ตาม เนื่องจากบางพอร์ตมีขั้วต่อได้หลายตัว แต่ชาร์จรถยนต์ได้ทีละ 1 คันเท่านั้น (เช่น) จำนวนขั้วต่ออาจมากกว่าจำนวนรถทั้งหมดที่สามารถชาร์จพร้อมกันได้
connectorAggregation[]

object (ConnectorAggregation)

รายการการรวมขั้วต่อสำหรับชาร์จ EV ที่มีหัวชาร์จประเภทเดียวกันและมีอัตราการชาร์จเท่ากัน

ConnectorAggregation

ข้อมูลการชาร์จ EV ที่จัดกลุ่มตาม [type, maxChargeRateKw] แสดงการรวมการชาร์จ EV ของขั้วต่อที่มีประเภทและอัตราการชาร์จสูงสุดเดียวกันในหน่วยกิโลวัตต์

การแสดง JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
ช่อง
type

enum (EVConnectorType)

ประเภทเครื่องมือเชื่อมต่อของการรวมนี้
maxChargeRateKw

number

อัตราการชาร์จสูงสุดแบบคงที่ในหน่วยกิโลวัตต์ของขั้วต่อแต่ละตัวในการรวม
count

integer

จำนวนขั้วต่อในการรวมนี้
availabilityLastUpdateTime

string (Timestamp format)

การประทับเวลาเมื่อข้อมูลความพร้อมของเครื่องมือเชื่อมต่อในการรวมนี้ได้รับการอัปเดตครั้งล่าสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
availableCount

integer

จำนวนเครื่องมือเชื่อมต่อในการรวมนี้ที่ใช้ได้ในปัจจุบัน
outOfServiceCount

integer

จำนวนเครื่องมือเชื่อมต่อในการรวมนี้ที่ไม่พร้อมให้บริการในขณะนี้

EVConnectorType

ดูข้อมูลเพิ่มเติม/บริบทเกี่ยวกับประเภทหัวชาร์จไฟฟ้า EV ได้ที่ http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED เครื่องมือเชื่อมต่อที่ไม่ระบุ
EV_CONNECTOR_TYPE_OTHER เครื่องมือเชื่อมต่อประเภทอื่นๆ
EV_CONNECTOR_TYPE_J1772 หัวต่อ J1772 ประเภท 1
EV_CONNECTOR_TYPE_TYPE_2 หัวเสียบ IEC 62196 ประเภท 2 มักเรียกว่า MENNEKES
EV_CONNECTOR_TYPE_CHADEMO เครื่องมือเชื่อมต่อประเภท CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 ระบบชาร์จรวม (AC และ DC) อิงตาม SAE หัวต่อ Type-1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 ระบบชาร์จรวม (AC และ DC) อิงตามเครื่องมือเชื่อมต่อ Type-2 Mennekes
EV_CONNECTOR_TYPE_TESLA เครื่องมือเชื่อมต่อ TESLA ทั่วไป นี่คือ NACS ในอเมริกาเหนือแต่สามารถไม่ใช่ NACS ในที่อื่นๆ ของโลก (เช่น CCS Combo 2 (CCS2) หรือ GB/T) ค่านี้แทนประเภทของขั้วต่อจริงน้อยกว่า ส่วนค่านี้แสดงถึงความสามารถในการชาร์จรถยนต์ยี่ห้อ Tesla ที่สถานีชาร์จ Tesla โดยตรง
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T ประเภท GB/T สอดคล้องกับมาตรฐาน GB/T ในจีน ประเภทนี้ครอบคลุม GB_T ทุกประเภท
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET เต้ารับติดผนังที่ไม่ระบุ

วิธีการ

autocomplete

 แสดงผลการคาดคะเนสำหรับอินพุตที่ระบุ

get

 ดูรายละเอียดของสถานที่ตามชื่อทรัพยากรซึ่งเป็นสตริงในรูปแบบ places/{place_id}

searchNearby

 ค้นหาสถานที่ใกล้ๆ

searchText

 การค้นหาสถานที่ตามข้อความค้นหา