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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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

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

string

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

object (LocalizedText)

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

string

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

string

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

string

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

string

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

object (AddressComponent)

องค์ประกอบที่ซ้ำกันสำหรับแต่ละระดับย่าน โปรดศึกษาข้อเท็จจริงต่อไปนี้เกี่ยวกับอาร์เรย์ addressComponents[] - อาร์เรย์ของคอมโพเนนต์ที่อยู่อาจมีคอมโพเนนต์มากกว่า formatAddress - อาร์เรย์ไม่จำเป็นต้องรวมเอนทิตีทางการเมืองทั้งหมดที่มีที่อยู่ นอกจากที่อยู่ที่รวมอยู่ใน formatAddress หากต้องการดึงข้อมูลหน่วยงานทางการเมืองทั้งหมดที่มีที่อยู่หนึ่งๆ คุณควรใช้การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ โดยส่งผ่านละติจูด/ลองจิจูดของที่อยู่เป็นพารามิเตอร์ไปยังคำขอ - เราไม่รับประกันว่ารูปแบบของการตอบกลับคำขอจะเหมือนกัน โดยเฉพาะอย่างยิ่ง จำนวน addressComponents จะแตกต่างกันไปตามที่อยู่ที่ขอ และอาจเปลี่ยนแปลงเมื่อเวลาผ่านไปสำหรับที่อยู่เดียวกัน คอมโพเนนต์เปลี่ยนตำแหน่งในอาร์เรย์ได้ ประเภทของคอมโพเนนต์เปลี่ยนแปลงได้ คอมโพเนนต์บางอย่างอาจไม่มีในการตอบกลับในภายหลัง
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 ในรูปแบบเลขฐาน 16 เช่น #909CE1
currentOpeningHours

object (OpeningHours)

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

object (OpeningHours)

ประกอบด้วยรายการข้อมูลในช่วงเวลา 7 วันข้างหน้า รวมถึงข้อมูลเกี่ยวกับเวลาทำการรองของธุรกิจ เวลาทำการรองแตกต่างจากเวลาทำการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุช่วงเวลาขับรถหรือเวลาจัดส่งเป็นเวลาทำการรองได้ ช่องนี้จะสร้างช่องย่อยของประเภท ซึ่งดึงมาจากรายการประเภทเวลาทำการที่กำหนดไว้ล่วงหน้า (เช่น DRIVE_THROUGH, PICKUP หรือ TAKEOUT) ตามประเภทของสถานที่ ช่องนี้จะมีช่องย่อยพิเศษของทุกชั่วโมง ซึ่งกำหนดสำหรับวันที่ที่มีเวลาทำการพิเศษ
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
generativeSummary

object (GenerativeSummary)

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

ข้อมูลสรุปของสถานที่ที่ AI สร้างขึ้น
areaSummary

object (AreaSummary)

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

สรุปพื้นที่ของสถานที่นั้นที่ AI สร้างขึ้น
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

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

string

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

string

อาร์เรย์ที่ระบุประเภทขององค์ประกอบที่อยู่
languageCode

string

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

PlusCode

Plus Code (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, Ramberg,นอร์เวย์" ซึ่งมีส่วนต่อท้ายรหัสสากล และแทนที่คำนำหน้าด้วยชื่อที่จัดรูปแบบของเอนทิตีอ้างอิง

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

ข้อมูลเกี่ยวกับผู้เขียนข้อมูล UGC ใช้ใน 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

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

enum (SecondaryHoursType)

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

object (SpecialDay)

ข้อมูลที่มีโครงสร้างสำหรับวันพิเศษที่อยู่ภายในระยะเวลาเวลาทำการที่ส่งคืน วันพิเศษคือวันที่อาจส่งผลต่อเวลาทำการของสถานที่ เช่น วันคริสต์มาส ตั้งค่า Currents สำหรับ CurrentOpeningHours และปัจจุบันsecondaryOpeningHours หากมีเวลาทำการพิเศษ
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 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

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

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

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี
month

integer

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

integer

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

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

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

การแสดง 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 Place มีบริการฟรี
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

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

boolean

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

boolean

สถานที่มีที่จอดรถฟรี
paidGarageParking

boolean

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

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 E 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

จำนวนหัวชาร์จไฟฟ้าที่สถานีนี้ อย่างไรก็ตาม เนื่องจากพอร์ตบางพอร์ตอาจมีขั้วต่อได้หลายขั้ว แต่ชาร์จรถยนต์ได้ทีละคันเท่านั้น (เช่น) จำนวนขั้วต่ออาจมากกว่าจำนวนรถทั้งหมดที่สามารถชาร์จพร้อมกันได้
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 เต้ารับติดผนังที่ไม่ระบุ

GenerativeSummary

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

ข้อมูลสรุปของสถานที่ที่ AI สร้างขึ้น

การแสดง JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
ช่อง
overview

object (LocalizedText)

ภาพรวมของสถานที่
description

object (LocalizedText)

คำอธิบายสถานที่โดยละเอียด
references

object (References)

ข้อมูลอ้างอิงที่ใช้สร้างคำอธิบายข้อมูลสรุป

ข้อมูลอ้างอิง

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

การอ้างอิงว่าคอนเทนต์จาก Generative AI นั้นเกี่ยวข้อง

การแสดง JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
ช่อง
reviews[]

object (Review)

รีวิวที่ใช้เป็นข้อมูลอ้างอิง
places[]

string

รายการชื่อทรัพยากรของสถานที่ที่อ้างอิง ชื่อนี้สามารถใช้ใน API อื่นๆ ที่ยอมรับชื่อแหล่งข้อมูลของ Place

AreaSummary

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

สรุปพื้นที่ของสถานที่นั้นที่ AI สร้างขึ้น

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

object (ContentBlock)

บล็อกเนื้อหาที่เขียนสรุปพื้นที่ โดยแต่ละบล็อกจะมีหัวข้อเฉพาะเกี่ยวกับพื้นที่นั้นๆ

ContentBlock

บล็อกเนื้อหาที่สามารถแสดงทีละรายการ

การแสดง JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
ช่อง
topic

string

หัวข้อของเนื้อหา เช่น "ภาพรวม" หรือ "ร้านอาหาร"
content

object (LocalizedText)

เนื้อหาที่เกี่ยวข้องกับหัวข้อ
references

object (References)

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative

การอ้างอิงที่เกี่ยวข้องกับบล็อกเนื้อหานี้

เมธอด

autocomplete

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

get

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

searchNearby

 ค้นหาสถานที่ที่อยู่ใกล้ตำแหน่ง

searchText

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