REST Resource: places

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

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

การแสดง JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "googleMapsTypeLabel": {
    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)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "openingDate": {
    object (Date)
  },
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "transitStation": {
    object (TransitStation)
  },
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "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,
  "utcOffsetMinutes": integer,
  "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

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

object (LocalizedText)

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

object (LocalizedText)

ป้ายกำกับประเภทของสถานที่ใน Google Maps ซึ่งแปลเป็นภาษาของคำขอ (หากมี) เช่น "ร้านอาหาร" "คาเฟ่" "สนามบิน" เป็นต้น ป้ายกำกับประเภทอาจแตกต่างจากชื่อที่แสดงของประเภทหลัก และอาจไม่ใช่ประเภทที่รองรับในตารางประเภทสถานที่ของ Places API
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 รายการ
photos[]

object (Photo)

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

string

ที่อยู่ของสถานที่ในรูปแบบ Microformat ของ adr: http://microformats.org/wiki/adr
businessStatus

enum (BusinessStatus)

สถานะธุรกิจสำหรับสถานที่
openingDate

object (Date)

วันที่สถานที่นี้จะเปิดในอนาคต ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อสถานะธุรกิจเป็น FUTURE_OPENING เท่านั้น
priceLevel

enum (PriceLevel)

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

object (Attribution)

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

string

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

string

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

object (OpeningHours)

เวลาทำการสำหรับ 7 วันถัดไป (รวมถึงวันนี้) โดยรวมเวลาทำการพิเศษด้วย ระยะเวลาจะเริ่มตั้งแต่เวลาเที่ยงคืนของวันที่ส่งคำขอและสิ้นสุดเวลา 23:59 น. ในอีก 6 วันต่อมา หากเวลาทำการจริงอยู่นอกช่วงนี้ ระบบจะตัดเวลาทำการ เช่น หากสถานที่เปิดตั้งแต่ 22:00 น. ของเมื่อวานจนถึง 06:00 น. ของวันนี้ ระบบจะตัดเวลาทำการเป็น 00:00 น. ของวันนี้จนถึง 06:00 น. ของวันนี้ ฟิลด์นี้รวมถึงฟิลด์ย่อย specialDays ของเวลาทำการทั้งหมด ซึ่งตั้งค่าไว้สำหรับวันที่ที่มีเวลาทำการพิเศษ
regularOpeningHours

object (OpeningHours)

เวลาทำการปกติคือเวลาทำการของสถานที่ตามกำหนดเวลาปกติ โปรดทราบว่าหากสถานที่เปิดตลอดเวลา (24 ชั่วโมง) ระบบจะไม่ตั้งค่าช่อง close ไคลเอ็นต์สามารถใช้เวลาทำการที่เปิดตลอดเวลา (24 ชั่วโมง) ซึ่งแสดงเป็นช่วง open ที่มี day ที่มีค่า 0, hour ที่มีค่า 0 และ minute ที่มีค่า 0
currentSecondaryOpeningHours[]

object (OpeningHours)

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

object (OpeningHours)

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

object (TimeZone)

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

object (LocalizedText)

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

object (PaymentOptions)

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

object (ParkingOptions)

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

object (SubDestination)

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

object (FuelOptions)

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

object (EVChargeOptions)

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

object (GenerativeSummary)

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

object (ContainingPlace)

รายการสถานที่ที่สถานที่ปัจจุบันตั้งอยู่
addressDescriptor

object (AddressDescriptor)

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

object (PriceRange)

ช่วงราคาที่เชื่อมโยงกับสถานที่
reviewSummary

object (ReviewSummary)

ข้อมูลสรุปเกี่ยวกับสถานที่ที่ AI สร้างขึ้นโดยใช้รีวิวจากผู้ใช้
evChargeAmenitySummary

object (EvChargeAmenitySummary)

สรุปสิ่งอำนวยความสะดวกใกล้สถานีชาร์จ EV
neighborhoodSummary

object (NeighborhoodSummary)

สรุปจุดที่น่าสนใจใกล้กับสถานที่
consumerAlert

object (ConsumerAlert)

ข้อความแจ้งเตือนผู้บริโภคสำหรับสถานที่เมื่อเราตรวจพบกิจกรรมรีวิวที่น่าสงสัยในธุรกิจหรือธุรกิจที่ละเมิดนโยบาย
movedPlace

string

หากสถานที่นี้ปิดถาวรและย้ายไปยังสถานที่ใหม่ ฟิลด์นี้จะมีชื่อทรัพยากรของสถานที่ใหม่ในรูปแบบ places/{placeId} หากสถานที่นี้ย้ายหลายครั้ง ช่องนี้จะแสดงสถานที่แรกที่ย้าย ช่องนี้จะไม่มีข้อมูลหากสถานที่ไม่ได้ย้าย
movedPlaceId

string

หากสถานที่นี้ปิดถาวรและย้ายไปยังสถานที่ใหม่ ฟิลด์นี้จะมีรหัสสถานที่ของสถานที่ใหม่ หากสถานที่นี้ย้ายหลายครั้ง ช่องนี้จะแสดงสถานที่แรกที่ย้าย ช่องนี้จะไม่มีข้อมูลหากสถานที่ไม่ได้ย้าย
transitStation

object (TransitStation)

ข้อมูลสถานีขนส่งของสถานที่
entrances[]

object (Entrance)

ทางเข้าของจุดหมายนี้
navigationPoints[]

object (NavigationPoint)

จุดนำทางสำหรับจุดหมายนี้
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

ระบุว่าสถานที่นี้เสิร์ฟอาหารมังสวิรัติหรือไม่
utcOffsetMinutes

integer

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

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

string

ไม่บังคับ แขวงของที่อยู่ เช่น ย่าน เขต หรืออำเภอ
addressLines[]

string

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

เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภทและบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "ออสติน เท็กซัส") จึงควรระบุลำดับบรรทัดให้ชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับซองจดหมาย" สำหรับประเทศหรือภูมิภาคของที่อยู่ ในที่ที่อาจแตกต่างกัน (เช่น ญี่ปุ่น) จะใช้ 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 x 1/8000 องศา (~14 x 14 เมตร)
compoundCode

string

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

LatLng

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

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

number

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

number

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

วิวพอร์ต

วิวพอร์ตในรูปแบบละติจูด-ลองจิจูด ซึ่งกำหนดด้วยจุด 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,
  "flagContentUri": string,
  "googleMapsUri": string,
  "visitDate": {
    object (Date)
  }
}
ช่อง
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 เสมอ และใช้ตัวเลขเศษส่วน 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
visitDate

object (Date)

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

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

วันที่

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

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

รูปภาพ

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

การแสดง 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 สถานประกอบการปิดถาวรแล้ว
FUTURE_OPENING สถานประกอบการจะเปิดในอนาคต

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 ของผู้ให้บริการข้อมูลของสถานที่

OpeningHours

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

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

object (Period)

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

วันเริ่มต้นของperiodsไม่ได้กำหนดไว้และไม่ควรคิดว่าเป็นวันอาทิตย์ API จะกำหนดวันเริ่มต้นตามปัจจัยต่างๆ เช่น สำหรับธุรกิจที่เปิดตลอด 24 ชั่วโมงทุกวัน ช่วงแรกอาจเริ่มในวันที่ส่งคำขอ สำหรับธุรกิจอื่นๆ อาจเป็นวันแรกของสัปดาห์ที่ธุรกิจเปิดทำการ

หมายเหตุ: การจัดเรียงอาร์เรย์ periods ไม่ขึ้นอยู่กับการจัดเรียงอาร์เรย์ weekdayDescriptions อย่าคิดว่าการทดสอบจะเริ่มในวันเดียวกัน
weekdayDescriptions[]

string

สตริงที่แปลแล้วซึ่งอธิบายเวลาทำการของสถานที่นี้ โดยมีสตริง 1 รายการสำหรับแต่ละวันของสัปดาห์

หมายเหตุ: ลำดับของวันและจุดเริ่มต้นของสัปดาห์จะกำหนดโดยภาษาและภูมิภาค การเรียงลำดับของอาร์เรย์ periods ไม่ขึ้นอยู่กับการเรียงลำดับของอาร์เรย์ weekdayDescriptions อย่าคิดว่าการทดสอบจะเริ่มในวันเดียวกัน

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

enum (SecondaryHoursType)

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

object (SpecialDay)

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

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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

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

ระยะเวลา

ระยะเวลาที่สถานที่ยังคงมีสถานะ 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

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

integer

ในนาทีที่ ค่าอยู่ในช่วง 0-59

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"

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 เสมอ และใช้ตัวเลขเศษส่วน 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 ที่โฮสต์ใน Place คำศัพท์เป็นไปตาม https://afdc.energy.gov/fuels/electricity_infrastructure.html พอร์ต 1 พอร์ตจะชาร์จรถยนต์ได้ 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)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 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 หัวชาร์จไฟฟ้าประเภท 1 J1772
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) อิงตามหัวต่อ 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 ระบบการชาร์จของอเมริกาเหนือ (North American Charging System หรือ NACS) ซึ่งได้รับการรับรองมาตรฐานเป็น SAE J3400

GenerativeSummary

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

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

object (LocalizedText)

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

string

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

object (LocalizedText)

ข้อความการเปิดเผยข้อมูลเกี่ยวกับ AI "สรุปด้วย Gemini" (และข้อความที่แปลเป็นภาษาท้องถิ่น) โดยจะอยู่ในภาษาที่ระบุในคำขอ หากมี

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)

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

ReviewSummary

ข้อมูลสรุปเกี่ยวกับสถานที่ที่ AI สร้างขึ้นโดยใช้รีวิวจากผู้ใช้

การแสดง JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
ช่อง
text

object (LocalizedText)

สรุปรีวิวจากผู้ใช้
flagContentUri

string

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

object (LocalizedText)

ข้อความการเปิดเผยข้อมูลเกี่ยวกับ AI "สรุปด้วย Gemini" (และข้อความที่แปลเป็นภาษาต่างๆ) โดยจะอยู่ในภาษาที่ระบุในคำขอ หากมี
reviewsUri

string

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

EvChargeAmenitySummary

สรุปสิ่งอำนวยความสะดวกใกล้สถานีชาร์จ EV การดำเนินการนี้ใช้ได้กับสถานที่ประเภท electric_vehicle_charging_station เท่านั้น ระบบรับประกันว่าจะระบุข้อมูลในช่อง overview ส่วนช่องอื่นๆ จะระบุหรือไม่ก็ได้

การแสดง JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
ช่อง
overview

object (ContentBlock)

ภาพรวมของสิ่งอำนวยความสะดวกที่มีให้บริการ รับประกันว่าจะมีการให้บริการ
coffee

object (ContentBlock)

สรุปตัวเลือกกาแฟใกล้เคียง
restaurant

object (ContentBlock)

สรุปเกี่ยวกับร้านอาหารที่อยู่ใกล้เคียง
store

object (ContentBlock)

สรุปเกี่ยวกับร้านค้าใกล้เคียง
flagContentUri

string

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

object (LocalizedText)

ข้อความการเปิดเผยข้อมูลเกี่ยวกับ AI "สรุปด้วย Gemini" (และข้อความที่แปลเป็นภาษาท้องถิ่น) โดยจะอยู่ในภาษาที่ระบุในคำขอ หากมี

ContentBlock

บล็อกเนื้อหาที่แสดงแยกกันได้

การแสดง JSON 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
ช่อง
content

object (LocalizedText)

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

string

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

NeighborhoodSummary

สรุปจุดที่น่าสนใจใกล้กับสถานที่

การแสดง JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
ช่อง
overview

object (ContentBlock)

สรุปภาพรวมของย่าน
description

object (ContentBlock)

คำอธิบายโดยละเอียดของย่าน
flagContentUri

string

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

object (LocalizedText)

ข้อความการเปิดเผยข้อมูลเกี่ยวกับ AI "สรุปด้วย Gemini" (และข้อความที่แปลเป็นภาษาท้องถิ่น) โดยจะอยู่ในภาษาที่ระบุในคำขอ หากมี

ConsumerAlert

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

การแสดง JSON 
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
ช่อง
overview

string

ภาพรวมของข้อความแจ้งเตือนผู้บริโภค
details

object (Details)

รายละเอียดของข้อความแจ้งเตือนผู้บริโภค
languageCode

string

รหัสภาษาของข้อความการแจ้งเตือนผู้บริโภค นี่คือรหัสภาษา BCP 47

รายละเอียด

รายละเอียดของข้อความแจ้งเตือนผู้บริโภค

การแสดง JSON 
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
ช่อง
title

string

ชื่อที่จะแสดงพร้อมกับคำอธิบาย
description

string

คำอธิบายของข้อความแจ้งเตือนผู้บริโภค

TransitStation

แสดงข้อมูลเฉพาะการขนส่งสำหรับสถานที่

การแสดง JSON 
{
  "displayName": {
    object (LocalizedText)
  },
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "stops": [
    {
      object (TransitStop)
    }
  ]
}
ช่อง
displayName

object (LocalizedText)

ชื่อสถานีเป็นภาษาท้องถิ่น
agencies[]

object (TransitAgency)

บริษัทขนส่งที่ให้บริการสถานีนี้
stops[]

object (TransitStop)

รถประจำทางหยุดที่สถานีนี้

TransitAgency

แสดงถึงบริษัทขนส่ง

การแสดง JSON 
{
  "displayName": {
    object (LocalizedText)
  },
  "url": string,
  "fareUrl": string,
  "icon": {
    object (TransitIcon)
  },
  "lines": [
    {
      object (TransitLine)
    }
  ]
}
ช่อง
displayName

object (LocalizedText)

ชื่อเอเจนซี (เช่น "VTA") ในภาษาที่ขอ
url

string

URL ของหน้าแรกของเอเจนซี
fareUrl

string

URL ของหน้ารายละเอียดค่าโดยสารของเอเจนซี
icon

object (TransitIcon)

ตัวระบุไอคอนสำหรับไอคอนที่มีการแปลและมีแบรนด์ของระบบขนส่งสาธารณะ (เช่น รถไฟใต้ดินลอนดอน) ซึ่งควรใช้แทน TransitLine.vehicle_icon ใน UI
lines[]

object (TransitLine)

เส้นทางขนส่งสาธารณะที่ให้บริการโดยหน่วยงานนี้

TransitIcon

ไอคอนสำหรับเส้นทางขนส่งสาธารณะ ยานพาหนะ หรือหน่วยงาน

การแสดง JSON 
{
  "url": string,
  "nameIncluded": boolean
}
ช่อง
url

string

URL ของไอคอน
nameIncluded

boolean

ไม่ว่าชื่อจะอยู่ในไอคอนหรือไม่ และไม่จำเป็นต้องแสดงชื่อข้างไอคอน

TransitLine

แสดงถึงเส้นทางขนส่งสาธารณะเส้นเดียว

การแสดง JSON 
{
  "id": string,
  "vehicleType": enum (VehicleType),
  "displayName": {
    object (LocalizedText)
  },
  "shortDisplayName": {
    object (LocalizedText)
  },
  "textColor": string,
  "backgroundColor": string,
  "url": string,
  "icon": {
    object (TransitIcon)
  },
  "vehicleIcon": {
    object (TransitIcon)
  }
}
ช่อง
id

string

รหัสของเส้นทางขนส่งสาธารณะที่ใช้ระบุเส้นทางขนส่งสาธารณะนั้นๆ ได้อย่างไม่ซ้ำกันในบรรดาเส้นทางขนส่งสาธารณะอื่นๆ ในสถานีขนส่งเดียวกัน เราไม่รับประกันว่าตัวระบุนี้จะคงที่ในคำตอบต่างๆ
vehicleType

enum (VehicleType)

ประเภทของยานพาหนะที่ใช้เส้นทางนี้
displayName

object (LocalizedText)

ชื่อแบบยาวของเส้นทางขนส่งสาธารณะนี้ (เช่น "Sunnydale local")
shortDisplayName

object (LocalizedText)

ชื่อย่อของเส้นทางขนส่งสาธารณะนี้ (เช่น "S2")
textColor

string

สีข้อความของป้ายกำกับสำหรับเส้นทางขนส่งสาธารณะนี้ในรูปแบบเลขฐานสิบหก #RRGGBB เช่น #909CE1
backgroundColor

string

สีพื้นหลังของป้ายกำกับสำหรับเส้นทางขนส่งสาธารณะนี้ในรูปแบบเลขฐานสิบหก #RRGGBB เช่น #909CE1 นอกจากนี้ยังใช้สีนี้เพื่อวาดรูปร่างสำหรับเส้นทางขนส่งสาธารณะนี้ได้ด้วย
url

string

URL ของหน้าเว็บที่มีรายละเอียดเกี่ยวกับบรรทัดนี้
icon

object (TransitIcon)

ตัวระบุไอคอนสำหรับสายนี้ (เช่น รถไฟใต้ดินในนิวยอร์ก)
vehicleIcon

object (TransitIcon)

ตัวระบุไอคอนสำหรับยานพาหนะประเภทนี้

VehicleType

ประเภทยานพาหนะสำหรับเส้นทางขนส่งสาธารณะ

Enum
VEHICLE_TYPE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุประเภทรถ
RAIL แถบข้าง
METRO_RAIL รถไฟฟ้า
SUBWAY รถไฟใต้ดิน
TRAM รถราง
MONORAIL รถไฟรางเดี่ยว
HEAVY_RAIL รถไฟทั่วไป
COMMUTER_TRAIN รถไฟ
HIGH_SPEED_TRAIN รถไฟความเร็วสูง
LONG_DISTANCE_TRAIN รถไฟทางไกล
BUS รถประจำทาง
INTERCITY_BUS รถบัสทางไกล
TROLLEYBUS รถรางที่ใช้ไฟฟ้า
SHARE_TAXI แชร์แท็กซี่
COACH โค้ช
FERRY เรือข้ามฟาก
CABLE_CAR เคเบิลคาร์
GONDOLA_LIFT กระเช้าลอยฟ้า
FUNICULAR กระเช้าไฟฟ้า
SPECIAL พิเศษ
HORSE_CARRIAGE รถม้า
AIRPLANE เครื่องบิน

TransitStop

แสดงป้ายรถประจำทางภายในสถานี นี่คือสถานที่ที่เฉพาะเจาะจงซึ่งผู้โดยสารขึ้นและลงจากยานพาหนะขนส่งสาธารณะ เช่น ชานชาลาหรือช่องจอดรถประจำทาง ซึ่งแตกต่างจากDepartureซึ่งเป็นเหตุการณ์ที่ยานพาหนะออกจากป้ายในเวลาที่เฉพาะเจาะจง

การแสดง JSON 
{
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "platformCode": {
    object (LocalizedText)
  },
  "signageText": {
    object (LocalizedText)
  },
  "stopCode": {
    object (LocalizedText)
  },
  "location": {
    object (LatLng)
  },
  "wheelchairAccessibleEntrance": boolean
}
ช่อง
id

string

รหัสของป้ายหยุดรถโดยสารที่ใช้ระบุป้ายหยุดรถโดยสารที่ไม่ซ้ำกันในบรรดาป้ายหยุดรถโดยสารอื่นๆ ในสถานีขนส่งเดียวกัน เราไม่รับประกันว่าตัวระบุนี้จะคงที่ในการตอบกลับต่างๆ
displayName

object (LocalizedText)

ชื่อป้ายจอดรถ
platformCode

object (LocalizedText)

รหัสแพลตฟอร์มที่แสดงโดยป้ายหยุดนี้ โดยคุณจะจัดรูปแบบได้ตามต้องการ (เช่น "2", "Platform 2", "2-4" หรือ "1x")
signageText

object (LocalizedText)

ข้อความที่เขียนบนป้ายบอกทางสำหรับแพลตฟอร์มนี้ เช่น "ไปเซ็นทรัล" หรือ "ฝั่งตะวันออกและบรูคลิน" เมื่อไม่มี platformCode ฟิลด์นี้อาจเป็นตัวระบุเดียวสำหรับแพลตฟอร์ม อย่างไรก็ตาม คุณตั้งค่าทั้ง platformCode และ signageText พร้อมกันได้
stopCode

object (LocalizedText)

ตัวระบุที่มนุษย์อ่านได้ของป้ายหยุดรถ ซึ่งหน่วยงานขนส่งใช้เพื่อแยกความแตกต่างระหว่างป้ายหยุดรถที่มีชื่อเดียวกัน
location

object (LatLng)

ตำแหน่งของป้าย
wheelchairAccessibleEntrance

boolean

การรองรับเก้าอี้รถเข็นของป้ายนี้ ฟิลด์นี้ระบุว่ามีเส้นทางที่รองรับเก้าอี้รถเข็นจากภายนอกสถานีไปยังป้ายจอดรถหรือไม่ แต่ไม่ได้ระบุว่าขึ้นรถจากป้ายได้หรือไม่

ทางเข้า

ทางเข้าคือคู่พิกัดละติจูด/ลองจิจูดเดียวที่กำหนดตำแหน่งของจุดเข้าและออกของสถานที่

การแสดง JSON 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Tag)
  ]
}
ช่อง
location

object (LatLng)

ตำแหน่งของทางเข้า
tags[]

enum (Tag)

รายการแท็กที่อธิบายทางเข้า

แท็ก

ลักษณะที่อธิบายทางเข้า

Enum
TAG_UNSPECIFIED ไม่ได้ใช้
PREFERRED

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

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

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

หมายเหตุ: PREFERRED ทางเข้าอาจไม่ได้ให้สิทธิ์เข้าถึงสถานที่หลัก และทางเข้าที่ไม่ใช่PREFERREDอาจให้สิทธิ์เข้าถึงสถานที่หลัก

TravelMode

โหมดการเดินทางที่เหมาะสมกับจุดนำทางนี้

Enum
TRAVEL_MODE_UNSPECIFIED ไม่ได้ใช้
DRIVE เหมาะสำหรับการขับขี่
WALK เหมาะกับการเดิน

การใช้งาน

การใช้งานที่จุดนำทางนี้รองรับ ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต

Enum
USAGE_UNSPECIFIED ไม่ได้ใช้
DROPOFF เหมาะสำหรับส่งผู้โดยสาร เช่น สถานที่ส่งผู้โดยสารของบริการเรียกรถ
PICKUP เหมาะสำหรับการรับผู้โดยสาร เช่น สถานที่ขึ้นรถของแอปเรียกรถ
PARKING เหมาะสำหรับจอดรถ เช่น ภายในลานจอดรถ

เมธอด

autocomplete

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

get

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

searchNearby

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

searchText

 การค้นหาสถานที่โดยอิงตามคำค้นหาที่เป็นข้อความ