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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "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
}
ช่อง
name

string

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

string

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

object (LocalizedText)

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

string

ชุดแท็กประเภทสําหรับผลการค้นหานี้ เช่น "political" และ "locality" ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ตาราง ก และตาราง ข ที่ 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

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

object (PostalAddress)

ที่อยู่ในรูปแบบที่อยู่ไปรษณีย์
addressComponents[]

object (AddressComponent)

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

เวลาทําการปกติ โปรดทราบว่าหากสถานที่เปิดตลอด (24 ชั่วโมง) ระบบจะไม่ตั้งค่าช่อง close ลูกค้าสามารถเชื่อถือได้ว่า "เปิดตลอด (24 ชั่วโมง)" จะแสดงเป็นระยะเวลา open ที่มี day ที่มีค่า 0, hour ที่มีค่า 0 และ minute ที่มีค่า 0
timeZone

object (TimeZone)

เขตเวลาของฐานข้อมูลเขตเวลา IANA เช่น "America/New_York"
photos[]

object (Photo)

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

string

ที่อยู่ของสถานที่ในรูปแบบไมโครฟอร์แมต adr: 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
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 สร้างขึ้น
containingPlaces[]

object (ContainingPlace)

รายชื่อสถานที่ที่มีสถานที่ปัจจุบันอยู่
addressDescriptor

object (AddressDescriptor)

ตัวระบุที่อยู่ของสถานที่ ตัวระบุที่อยู่มีข้อมูลเพิ่มเติมที่ช่วยอธิบายสถานที่โดยใช้จุดสังเกตและพื้นที่ ดูความครอบคลุมระดับภูมิภาคของคำอธิบายที่อยู่ได้ที่ https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage
priceRange

object (PriceRange)

ช่วงราคาที่เชื่อมโยงกับสถานที่
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)

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

boolean

ระบุว่าสถานที่เป็นธุรกิจพื้นที่ให้บริการล้วนๆ หรือไม่ ธุรกิจที่ให้บริการตามสถานที่เพียงอย่างเดียวคือธุรกิจที่บริการแบบถึงที่หรือออกให้บริการแก่ลูกค้าโดยตรง โดยไม่ได้ให้บริการลูกค้า ณ ที่อยู่ธุรกิจ ตัวอย่างเช่น บริการทำความสะอาดหรือช่างประปา ธุรกิจเหล่านั้นอาจไม่มีที่อยู่หรือสถานที่ตั้งจริงบน Google Maps

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

PostalAddress

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

ในการใช้งานทั่วไป ระบบจะสร้างที่อยู่ตามข้อมูลที่ผู้ใช้ป้อนหรือจากการนําเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ

คำแนะนำเกี่ยวกับการป้อนหรือแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่พร้อมใช้งานแบบหลายภาษา เช่น https://github.com/google/libaddressinput - ผู้ใช้ไม่ควรเห็นองค์ประกอบ UI สำหรับการป้อนหรือแก้ไขช่องนอกประเทศที่ใช้ช่องนั้น

ดูคําแนะนําเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478

การแสดง JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
ช่อง
revision

integer

การแก้ไขสคีมาของ PostalAddress ต้องตั้งค่าเป็น 0 ซึ่งเป็นการแก้ไขล่าสุด

การแก้ไขใหม่ทั้งหมดต้องใช้งานร่วมกับการแก้ไขเก่าได้
regionCode

string

ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ระบบจะไม่อนุมานค่านี้และขึ้นอยู่กับผู้ใช้ที่จะตรวจสอบว่าค่านั้นถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html เช่น "CH" สำหรับสวิตเซอร์แลนด์
languageCode

string

ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาในที่อยู่นี้ (หากทราบ) ภาษานี้มักเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือภาษาที่เทียบเท่าซึ่งถอดเสียง ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูลและจะไม่ส่งผลต่อการตรวจสอบหรือการดําเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ

หากไม่ทราบค่านี้ ก็ไม่ควรระบุ (แทนที่จะระบุค่าเริ่มต้นที่ไม่ถูกต้อง)

ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en"
postalCode

string

ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศไม่ได้ใช้หรือกำหนดให้ต้องระบุรหัสไปรษณีย์ แต่หากใช้รหัสไปรษณีย์ ระบบอาจเรียกใช้การตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบรัฐหรือรหัสไปรษณีย์ในสหรัฐอเมริกา)
sortingCode

string

ไม่บังคับ รหัสการจัดเรียงเพิ่มเติมสำหรับแต่ละประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ค่าที่ใช้จะเป็นสตริง เช่น "CEDEX" ตามด้วยตัวเลข (ไม่บังคับ) (เช่น "CEDEX 7") หรือจะเป็นตัวเลขเพียงอย่างเดียวก็ได้ ซึ่งแสดงถึง "รหัสภาค" (จาไมก้า), "ตัวบ่งชี้พื้นที่การนำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (โกต-ดิวัวเร)
administrativeArea

string

ไม่บังคับ เขตบริหารย่อยที่สูงที่สุดซึ่งใช้สำหรับที่อยู่ไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด เขต หรือจังหวัด สำหรับสเปน ฟิลด์นี้จะระบุจังหวัด ไม่ใช่แคว้นปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยช่องนี้ว่างไว้
locality

string

ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมืองหรืออำเภอของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เทศบาลในอิตาลี เมืองไปรษณีย์ในสหราชอาณาจักร ในภูมิภาคของโลกที่ระบุสถานที่ตั้งไม่ชัดเจนหรือไม่เหมาะกับโครงสร้างนี้ ให้เว้นlocalityว่างไว้และใช้addressLines
sublocality

string

ไม่บังคับ เขตท้องที่ของที่อยู่ เช่น อาจเป็นย่าน เมืองเล็กๆ หรือเขต
addressLines[]

string

บรรทัดที่อยู่ที่ไม่เป็นโครงสร้างซึ่งอธิบายที่อยู่ในระดับล่าง

เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "Austin, TX") คุณจึงควรจัดเรียงบรรทัดให้ชัดเจน ลำดับบรรทัดที่อยู่ควรเป็น "ลำดับของซองจดหมาย" สำหรับประเทศหรือภูมิภาคของที่อยู่ ในที่ที่การเรียงลําดับอาจแตกต่างกัน (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อระบุให้ชัดเจน (เช่น "ja" สําหรับการเรียงลําดับจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สําหรับการเรียงลําดับจากเล็กไปใหญ่) วิธีนี้ช่วยให้คุณเลือกบรรทัดที่อยู่เฉพาะเจาะจงที่สุดตามภาษาได้

การนำเสนอโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วย regionCode ที่มีข้อมูลที่เหลือทั้งหมดอยู่ใน addressLines คุณสามารถจัดรูปแบบที่อยู่ดังกล่าวอย่างคร่าวๆ ได้โดยไม่ต้องใช้การจับคู่พิกัดภูมิศาสตร์ แต่ระบบจะไม่สามารถหาเหตุผลเชิงความหมายเกี่ยวกับองค์ประกอบที่อยู่ใดๆ ได้จนกว่าจะได้รับการแก้ไขอย่างน้อยบางส่วน

การสร้างที่อยู่ที่มีเพียง regionCode และ addressLines แล้วทำการจับคู่พิกัดภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสิ้นเชิง (แทนที่จะเดาว่าส่วนใดของที่อยู่ควรเป็นสถานที่ตั้งหรือเขตบริหาร)
recipients[]

string

ไม่บังคับ ผู้รับที่อยู่ที่ระบุ ช่องนี้อาจมีข้อมูลหลายบรรทัดในบางกรณี เช่น อาจมีข้อมูล "รับพัสดุแทน"
organization

string

ไม่บังคับ ชื่อองค์กรที่อยู่ที่ระบุ

AddressComponent

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

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

string

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

string

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

string

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

string

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

PlusCode

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

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

string

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

string

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

LatLng

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

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

number

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

number

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

วิวพอร์ต

วิวพอร์ตละติจูด-ลองจิจูดที่แสดงเป็นจุด low และ high 2 จุดที่ตรงข้ามกันตามแนวทแยงมุม วิวพอร์ตถือเป็นภูมิภาคแบบปิด กล่าวคือ วิวพอร์ตจะมีขอบเขตของตัวเอง ขอบเขตละติจูดต้องอยู่ในช่วง -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,
  "flagContentUri": string,
  "googleMapsUri": 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)

การประทับเวลาของการตรวจสอบ

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
flagContentUri

string

ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับรีวิวได้
googleMapsUri

string

ลิงก์เพื่อแสดงรีวิวใน Google Maps

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)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
ช่อง
periods[]

object (Period)

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

string

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

enum (SecondaryHoursType)

สตริงประเภทที่ใช้ระบุประเภทของชั่วโมงรอง
specialDays[]

object (SpecialDay)

ข้อมูลที่มีโครงสร้างสำหรับวันพิเศษซึ่งอยู่ในช่วงวันที่ที่เวลาเปิดทำการที่แสดงครอบคลุม วันพิเศษคือวันที่อาจส่งผลต่อเวลาทําการของสถานที่ เช่น วันคริสต์มาส ตั้งค่าสำหรับ currentOpeningHours และ currentSecondaryOpeningHours หากมีเวลาทำการพิเศษ
nextOpenTime

string (Timestamp format)

เวลาที่เปิดทำการปัจจุบันจะเริ่มขึ้นอีกครั้งในอีกไม่เกิน 7 วันข้างหน้า ระบบจะป้อนข้อมูลในช่องนี้เฉพาะในกรณีที่ช่วงเวลาเปิดทำการไม่ทำงานขณะแสดงคำขอ

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
nextCloseTime

string (Timestamp format)

เวลาที่สิ้นสุดของช่วงเวลาเปิดทำการปัจจุบันครั้งถัดไปภายใน 7 วันข้างหน้า ช่องนี้จะแสดงเฉพาะในกรณีที่ช่วงเวลาเปิดทําการใช้งานได้ ณ เวลาที่แสดงคําขอ

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
openNow

boolean

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

ระยะเวลา

ระยะเวลาที่สถานที่มีสถานะ "เปิดอยู่"

การแสดง 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

ชั่วโมงในรูปแบบ 24 ชั่วโมง อยู่ในช่วง 0 ถึง 23
minute

integer

นาที อยู่ในช่วง 0 ถึง 59

วันที่

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

  • วันที่แบบเต็มซึ่งมีค่าปี เดือน และวันที่ที่ไม่ใช่ 0
  • เดือนและวันโดยไม่มีปี (เช่น วันครบรอบ)
  • ปีเพียงอย่างเดียวที่มีเดือนเป็น 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

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

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

object (Date)

วันที่ของวันพิเศษนี้

TimeZone

แสดงเขตเวลาจากฐานข้อมูลเขตเวลา IANA

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

string

เขตเวลาของฐานข้อมูลเขตเวลา IANA เช่น "America/New_York"
version

string

ไม่บังคับ หมายเลขเวอร์ชันฐานข้อมูลเขตเวลา IANA เช่น "2019a"

รูปภาพ

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

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

string

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

integer

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

integer

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

object (AuthorAttribution)

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

string

ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับรูปภาพได้
googleMapsUri

string

ลิงก์เพื่อแสดงรูปภาพใน Google Maps

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

สถานที่มีที่จอดรถริมถนนแบบเสียค่าใช้จ่าย
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)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

FuelType

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

Enum
FUEL_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทเชื้อเพลิง
DIESEL น้ำมันดีเซล
DIESEL_PLUS น้ำมันดีเซลและน้ำมัน
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 ก๊าซปิโตรเลียมเหลว
E80 E 80
E85 E 85
E100 E 100
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 พอร์ต

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

integer

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

object (ConnectorAggregation)

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

ConnectorAggregation

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

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

enum (EVConnectorType)

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

number

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

integer

จํานวนตัวเชื่อมต่อในการรวบรวมข้อมูลนี้
availabilityLastUpdateTime

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
availableCount

integer

จํานวนตัวเชื่อมต่อในการรวมข้อมูลนี้ที่ใช้ได้ในปัจจุบัน
outOfServiceCount

integer

จํานวนขั้วต่อในการรวมกลุ่มนี้ที่ไม่พร้อมให้บริการในขณะนี้

EVConnectorType

ดูข้อมูลเพิ่มเติม/บริบทเกี่ยวกับประเภทหัวชาร์จรถยนต์ไฟฟ้าได้ที่ 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 หัวต่อ J-1772 ประเภท 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 ระบบการชาร์จแบบรวม (AC และ DC) อิงตามหัวชาร์จ Mennekes ประเภท 2
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 เต้ารับติดผนังที่ไม่ระบุ
EV_CONNECTOR_TYPE_NACS ระบบการชาร์จของอเมริกาเหนือ (NACS) ตามมาตรฐาน SAE J3400

GenerativeSummary

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

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

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

object (LocalizedText)

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

string

ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับข้อมูลสรุปภาพรวมได้
description

object (LocalizedText)

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

string

ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับข้อมูลสรุปได้
references

object (References)

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

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

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

ข้อมูลอ้างอิงที่เนื้อหาที่สร้างขึ้นเกี่ยวข้อง

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

object (Review)

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

string

รายชื่อชื่อทรัพยากรของสถานที่อ้างอิง ชื่อนี้ใช้ได้ใน API อื่นๆ ที่ยอมรับชื่อทรัพยากรสถานที่

AreaSummary

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

ข้อมูลสรุปเกี่ยวกับพื้นที่ที่สถานที่ตั้งอยู่ซึ่ง AI สร้างขึ้น

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

object (ContentBlock)

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

string

ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับข้อมูลสรุปได้

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

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

ContainingPlace

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

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

string

ชื่อทรัพยากรของสถานที่ตั้งของสถานที่นี้
id

string

รหัสสถานที่ของสถานที่ตั้งของสถานที่นี้

AddressDescriptor

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

การแสดง JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
ช่อง
landmarks[]

object (Landmark)

รายการจุดสังเกตที่อยู่ใกล้เคียงที่จัดอันดับ โดยระบบจะจัดอันดับจุดสังเกตที่เป็นที่รู้จักและอยู่ใกล้เคียงที่สุดเป็นอันดับแรก
areas[]

object (Area)

รายการที่มีการจัดอันดับของพื้นที่ที่เกี่ยวข้องหรือพื้นที่ใกล้เคียง โดยระบบจะจัดอันดับพื้นที่ที่เป็นที่รู้จักและแม่นยำที่สุดไว้ก่อน

สถานที่สำคัญ

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

จุดสังเกตคือสถานที่ที่โดดเด่นซึ่งสามารถใช้อธิบายสถานที่ได้

การแสดง JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
ช่อง
name

string

ชื่อทรัพยากรของจุดสังเกต
placeId

string

รหัสสถานที่ของจุดสังเกต
displayName

object (LocalizedText)

ชื่อที่แสดงของจุดสังเกต
types[]

string

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

enum (SpatialRelationship)

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

number

ระยะทางเส้นตรงเป็นเมตรระหว่างจุดศูนย์กลางของเป้าหมายกับจุดศูนย์กลางของจุดสังเกต ในบางสถานการณ์ ค่านี้อาจยาวกว่า travelDistanceMeters
travelDistanceMeters

number

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

SpatialRelationship

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

Enum
NEAR ความสัมพันธ์นี้เป็นความสัมพันธ์เริ่มต้นเมื่อไม่มีความสัมพันธ์ที่เฉพาะเจาะจงมากขึ้นด้านล่าง
WITHIN สถานที่สำคัญมีเรขาคณิตเชิงพื้นที่และเป้าหมายอยู่ภายในขอบเขต
BESIDE เป้าหมายอยู่ติดกับจุดสังเกตโดยตรง
ACROSS_THE_ROAD เป้าหมายอยู่ตรงข้ามกับจุดสังเกตอีกฝั่งของถนน
DOWN_THE_ROAD อยู่ในเส้นทางเดียวกับจุดสังเกต แต่ไม่ได้อยู่ข้างหรือฝั่งตรงข้าม
AROUND_THE_CORNER ไม่ได้อยู่ในเส้นทางเดียวกับจุดสังเกต แต่อยู่ห่างออกไปเพียงเลี้ยวเดียว
BEHIND อยู่ใกล้กับโครงสร้างของจุดสังเกต แต่อยู่ห่างจากทางเข้าบนถนน

พื้นที่

ข้อมูลพื้นที่และความสัมพันธ์ของพื้นที่กับสถานที่เป้าหมาย

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

การแสดง JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
ช่อง
name

string

ชื่อทรัพยากรของพื้นที่
placeId

string

รหัสสถานที่ของพื้นที่
displayName

object (LocalizedText)

ชื่อที่แสดงของพื้นที่
containment

enum (Containment)

กําหนดความสัมพันธ์เชิงพื้นที่ระหว่างตําแหน่งเป้าหมายกับพื้นที่

การควบคุมไฟ

กําหนดความสัมพันธ์เชิงพื้นที่ระหว่างตําแหน่งเป้าหมายกับพื้นที่

Enum
CONTAINMENT_UNSPECIFIED ไม่ได้ระบุการกักเก็บ
WITHIN ตำแหน่งเป้าหมายอยู่ภายในภูมิภาคของพื้นที่ใกล้กับจุดศูนย์กลาง
OUTSKIRTS สถานที่เป้าหมายอยู่ภายในภูมิภาคของพื้นที่ใกล้กับขอบ
NEAR สถานที่เป้าหมายอยู่นอกภูมิภาคของพื้นที่ แต่อยู่ใกล้ๆ

PriceRange

ช่วงราคาที่เชื่อมโยงกับสถานที่ endPrice อาจไม่มีการตั้งค่า ซึ่งบ่งบอกถึงช่วงที่ไม่มีขีดจำกัดบน (เช่น "มากกว่า $100")

การแสดง JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
ช่อง
startPrice

object (Money)

ค่าต่ำสุดของช่วงราคา (รวม) ราคาควรเท่ากับหรือมากกว่าจำนวนเงินนี้
endPrice

object (Money)

ค่าสูงสุดของช่วงราคา (ไม่รวม) ราคาควรต่ำกว่าจำนวนเงินนี้

เมธอด

autocomplete

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

get

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

searchNearby

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

searchText

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