Package google.maps.places.v1

ดัชนี

สถานที่

คำจำกัดความของบริการสำหรับ Places API หมายเหตุ: ทุกคำขอ (ยกเว้นคำขอการเติมข้อความอัตโนมัติ) ต้องมีการตั้งค่ามาสก์ฟิลด์นอกโปรโตคอลคำขอ (ไม่กำหนด all/*) ตั้งค่าฟิลด์มาสก์ผ่านส่วนหัว HTTP X-Goog-FieldMask ได้ ดูที่ https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

รับสื่อรูปภาพที่มีสตริงอ้างอิงรูปภาพ
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

AuthorAttribution

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

ช่อง
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

ขอโปรโตคอลสำหรับ AutocompletePlaces

ช่อง
input

string

ต้องระบุ สตริงข้อความที่จะค้นหา
location_bias

LocationBias

ไม่บังคับ การให้น้ำหนักพิเศษตามตำแหน่งที่ระบุ

ควรตั้งค่าไม่เกิน location_bias หรือ location_restriction หากไม่ได้ตั้งค่าไว้ ผลลัพธ์จะมีการให้น้ำหนักตามที่อยู่ IP ซึ่งหมายความว่าที่อยู่ IP จะจับคู่กับตำแหน่งที่ไม่ถูกต้องและใช้เป็นสัญญาณการให้น้ำหนัก
location_restriction

LocationRestriction

ไม่บังคับ จำกัดผลการค้นหาในตำแหน่งที่ระบุ

ควรตั้งค่าไม่เกิน location_bias หรือ location_restriction หากไม่ได้ตั้งค่าไว้ ผลลัพธ์จะมีการให้น้ำหนักตามที่อยู่ IP ซึ่งหมายความว่าที่อยู่ IP จะจับคู่กับตำแหน่งที่ไม่ถูกต้องและใช้เป็นสัญญาณการให้น้ำหนัก
included_primary_types[]

string

ไม่บังคับ ระบุประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types ระบบจะแสดงสถานที่ก็ต่อเมื่อประเภทหลักของสถานที่ดังกล่าวรวมอยู่ในรายการนี้เท่านั้น ระบุได้สูงสุด 5 ค่า หากไม่มีการระบุประเภท ระบบจะแสดงผลสถานที่ทุกประเภท
included_region_codes[]

string

ไม่บังคับ รวมเฉพาะผลลัพธ์ในภูมิภาคที่ระบุ โดยระบุเป็นรหัสภูมิภาคแบบ 2 อักขระของ CLDR ได้สูงสุด 15 รายการ ชุดที่ว่างเปล่าจะไม่จำกัดผลลัพธ์ หากตั้งค่าทั้ง location_restriction และ included_region_codes ผลลัพธ์จะอยู่ในบริเวณทางแยก
language_code

string

ไม่บังคับ ภาษาของผลการค้นหา ค่าเริ่มต้นคือ en-US ผลการค้นหาอาจเป็นภาษาผสม หากภาษาที่ใช้ในinputต่างจากlanguage_code หรือหากสถานที่ที่ส่งคืนไม่มีคำแปลจากภาษาท้องถิ่นเป็นlanguage_code
region_code

string

ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นรหัสภูมิภาคแบบ 2 อักขระของ CLDR ซึ่งจะส่งผลต่อการจัดรูปแบบที่อยู่ การจัดอันดับผลลัพธ์ และอาจส่งผลต่อผลลัพธ์ที่จะแสดง การดำเนินการนี้ไม่ได้จำกัดผลลัพธ์เฉพาะภูมิภาคที่ระบุ หากต้องการจำกัดผลการค้นหาให้แสดงเฉพาะภูมิภาค ให้ใช้ region_code_restriction
origin

LatLng

ไม่บังคับ จุดเริ่มต้นที่จะคำนวณระยะทางทางภูมิศาสตร์ไปยังจุดหมาย (แสดงผลเป็น distance_meters) หากไม่ระบุค่านี้ ระบบจะไม่แสดงผลระยะทางทางภูมิศาสตร์
input_offset

int32

ไม่บังคับ ออฟเซ็ตอักขระ Unicode ของ input ที่อิงตามศูนย์ซึ่งแสดงตำแหน่งเคอร์เซอร์ใน input ตำแหน่งเคอร์เซอร์อาจมีผลต่อการคาดคะเนที่แสดงขึ้น

หากเว้นว่างไว้ ระบบจะใช้ระยะเวลาตามค่าเริ่มต้น input
include_query_predictions

bool

ไม่บังคับ หากจริง การตอบกลับจะรวมทั้งการคาดคะเนสถานที่และคำค้นหา มิฉะนั้นการตอบกลับจะแสดงเฉพาะการคาดคะเนสถานที่เท่านั้น
session_token

string

ไม่บังคับ สตริงที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อจุดประสงค์ในการเรียกเก็บเงิน ต้องเป็น URL และสตริง base64 ที่ปลอดภัยสำหรับชื่อไฟล์ที่มีความยาวอักขระ ASCII ไม่เกิน 36 ตัว มิฉะนั้น ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์ข้อความค้นหา และสรุปเมื่อเลือกสถานที่และมีการเรียกรายละเอียดสถานที่หรือตรวจสอบที่อยู่ แต่ละเซสชันอาจมีการค้นหาหลายรายการ ตามด้วยรายละเอียดสถานที่หรือคำขอตรวจสอบที่อยู่ 1 รายการ ข้อมูลเข้าสู่ระบบที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สําหรับแต่ละเซสชัน หากไม่ระบุพารามิเตอร์ session_token หรือหากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินจากเซสชันเสมือนว่าไม่ได้ระบุโทเค็นเซสชันไว้ (เรียกเก็บเงินคำขอแต่ละรายการแยกกัน)

เราขอแนะนำหลักเกณฑ์ต่อไปนี้

  • ใช้โทเค็นเซสชันสำหรับการโทรที่เติมข้อความอัตโนมัติทั้งหมด
  • สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน เราขอแนะนำให้ใช้ UUID เวอร์ชัน 4
  • ตรวจสอบว่าข้อมูลเข้าสู่ระบบที่ใช้สำหรับคำขอการเติมข้อความอัตโนมัติ รายละเอียดสถานที่ และการตรวจสอบที่อยู่ทั้งหมดในเซสชันเป็นของโปรเจ็กต์ Cloud Console เดียวกัน
  • อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันให้เซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับมากกว่า 1 เซสชันจะส่งผลให้มีการเรียกเก็บเงินแต่ละคำขอแยกกัน

LocationBias

ภูมิภาคที่จะค้นหา ผลลัพธ์อาจมีการให้น้ำหนักพิเศษกับภูมิภาคที่ระบุ

ช่อง

ฟิลด์สหภาพ type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

วิวพอร์ตที่ระบุโดยมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้
circle

Circle

วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี

LocationRestriction

ภูมิภาคที่จะค้นหา ผลลัพธ์จะถูกจำกัดไว้ในภูมิภาคที่ระบุ

ช่อง

ฟิลด์สหภาพ type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

วิวพอร์ตที่ระบุโดยมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้
circle

Circle

วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี

AutocompletePlacesResponse

Proto การตอบกลับสำหรับ AutocompletePlaces

ช่อง
suggestions[]

Suggestion

มีรายการคำแนะนำที่เรียงตามลำดับความเกี่ยวข้องจากมากไปหาน้อย

คำแนะนำ

ผลลัพธ์ของคำแนะนำที่เติมข้อความอัตโนมัติ

ช่อง

ฟิลด์สหภาพ kind

kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
place_prediction

PlacePrediction

การคาดคะเนสำหรับสถานที่
query_prediction

QueryPrediction

การคาดคะเนสำหรับการค้นหา

FormattableText

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

ช่อง
text

string

ข้อความที่อาจใช้ตามที่เป็นอยู่หรือมีรูปแบบเป็น matches
matches[]

StringRange

รายการช่วงสตริงซึ่งระบุตำแหน่งที่คำขออินพุตตรงกันใน text สามารถใช้ช่วงเพื่อจัดรูปแบบส่วนที่เฉพาะเจาะจงของ text ได้ สตริงย่อยอาจไม่ใช่การจับคู่ที่ตรงกันทั้งหมดของ input หากการจับคู่นั้นกำหนดโดยเกณฑ์อื่นๆ ที่ไม่ใช่การจับคู่สตริง (เช่น การแก้ไขตัวสะกดหรือการทับศัพท์)

ค่าเหล่านี้เป็นออฟเซ็ตอักขระ Unicode ของ text ช่วงอย่างแน่นอนจะเรียงลำดับตามค่าออฟเซ็ตที่เพิ่มขึ้น

PlacePrediction

ผลการคาดการณ์สำหรับการคาดคะเนการเติมข้อความอัตโนมัติในสถานที่

ช่อง
place

string

ชื่อทรัพยากรของสถานที่ที่แนะนำ ชื่อนี้สามารถใช้ใน API อื่นๆ ที่ยอมรับชื่อสถานที่
place_id

string

ตัวระบุที่ไม่ซ้ำของสถานที่ที่แนะนำ ตัวระบุนี้ใช้ได้ใน API อื่นๆ ที่ยอมรับรหัสสถานที่
text

FormattableText

มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่ปรากฏ สำหรับผลสถานประกอบการ ซึ่งมักจะเป็นชื่อธุรกิจและที่อยู่

แนะนำให้ใช้ text สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI เดียว นักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI 2 รายการแยกกัน แต่มีความเกี่ยวข้องกันอาจต้องการใช้ structured_format แทน การแสดงการคาดคะเนสถานที่มี 2 วิธีที่แตกต่างกัน ผู้ใช้ไม่ควรพยายามแยกวิเคราะห์ structured_format เป็น text หรือกลับกัน

ข้อความนี้อาจแตกต่างจาก display_name ที่แสดงโดย GetPlace

อาจเป็นภาษาผสม หากคำขอ input และ language_code เป็นภาษาอื่น หรือหากสถานที่ไม่มีคำแปลจากภาษาท้องถิ่นเป็น language_code
structured_format

StructuredFormat

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

เราขอแนะนำให้ใช้ structured_format สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI 2 รายการแยกกัน แต่มีความเกี่ยวข้องกัน นักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI เดียวอาจต้องการใช้ text แทน การแสดงการคาดคะเนสถานที่มี 2 วิธีที่แตกต่างกัน ผู้ใช้ไม่ควรพยายามแยกวิเคราะห์ structured_format เป็น text หรือกลับกัน
types[]

string

รายชื่อประเภทที่ใช้กับสถานที่นี้จากตาราง ก หรือตาราง ข ใน https://developers.google.com/maps/documentation/places/web-service/place-types

ประเภทคือการจัดหมวดหมู่สถานที่ สถานที่ที่มีประเภทสถานที่ร่วมกันจะมีลักษณะคล้ายกัน
distance_meters

int32

ความยาวของภูมิศาสตร์ในหน่วยเมตรจาก origin หากระบุ origin การคาดการณ์บางอย่าง เช่น เส้นทาง อาจไม่แสดงช่องนี้

QueryPrediction

ผลการคาดการณ์สำหรับการคาดคะเนการเติมข้อความอัตโนมัติในข้อความค้นหา

ช่อง
text

FormattableText

ข้อความที่คาดการณ์ ข้อความนี้ไม่ได้แสดงสถานที่ แต่เป็นข้อความค้นหาที่สามารถใช้ในปลายทางการค้นหา (เช่น การค้นหาข้อความ)

แนะนำให้ใช้ text สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI เดียว นักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI 2 รายการแยกกัน แต่มีความเกี่ยวข้องกันอาจต้องการใช้ structured_format แทน ทั้งสองวิธีนี้แสดงถึงการคาดคะเนข้อความค้นหาที่แตกต่างกัน 2 วิธี ผู้ใช้ไม่ควรพยายามแยกวิเคราะห์ structured_format เป็น text หรือกลับกัน

อาจอยู่ในภาษาผสมหากคำขอ input และ language_code เป็นภาษาอื่น หรือหากส่วนหนึ่งของข้อความค้นหาไม่มีคำแปลจากภาษาท้องถิ่นเป็น language_code
structured_format

StructuredFormat

รายละเอียดของการคาดคะเนข้อความค้นหาเป็นข้อความหลักที่มีข้อความค้นหาและข้อความรองซึ่งมีคุณลักษณะเพิ่มเติมที่ชัดเจน (เช่น เมืองหรือภูมิภาค)

เราขอแนะนำให้ใช้ structured_format สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI 2 รายการแยกกัน แต่มีความเกี่ยวข้องกัน นักพัฒนาซอฟต์แวร์ที่ต้องการแสดงองค์ประกอบ UI เดียวอาจต้องการใช้ text แทน ทั้งสองวิธีนี้แสดงถึงการคาดคะเนข้อความค้นหาที่แตกต่างกัน 2 วิธี ผู้ใช้ไม่ควรพยายามแยกวิเคราะห์ structured_format เป็น text หรือกลับกัน

StringRange

ระบุสตริงย่อยภายในข้อความที่กำหนด

ช่อง
start_offset

int32

ออฟเซ็ตแบบศูนย์ของอักขระ Unicode ตัวแรกของสตริง (รวม)
end_offset

int32

ออฟเซ็ตของอักขระ Unicode ตัวสุดท้ายแบบศูนย์ (ไม่รวม)

StructuredFormat

มีรายละเอียดการคาดคะเนสถานที่หรือการค้นหาเป็นข้อความหลักและข้อความรอง

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

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

ช่อง
main_text

FormattableText

แสดงชื่อของสถานที่หรือข้อความค้นหา
secondary_text

FormattableText

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

วงกลม

วงกลมที่มีละติจูดและลองจิจูดเป็นจุดศูนย์กลางและรัศมี

ช่อง
center

LatLng

ต้องระบุ ศูนย์กลางละติจูดและลองจิจูด

ช่วงละติจูดต้องอยู่ในช่วง [-90.0, 90.0] ช่วงของลองจิจูดต้องอยู่ในช่วง [-180.0, 180.0]
radius

double

ต้องระบุ รัศมีวัดเป็นเมตร รัศมีต้องอยู่ภายใน [0.0, 50000.0]

ContentBlock

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

ช่อง
topic

string

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

LocalizedText

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

References

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

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

ContextualContent

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

เนื้อหาตามบริบทของการค้นหาสถานที่

ช่อง
reviews[]

Review

รายการรีวิวเกี่ยวกับสถานที่นี้ สืบเนื่องจากข้อความค้นหาสถานที่
photos[]

Photo

ข้อมูล (รวมถึงข้อมูลอ้างอิง) เกี่ยวกับรูปภาพของสถานที่นี้ ซึ่งต่อเนื่องมาจากข้อความค้นหาสถานที่
justifications[]

Justification

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

เหตุผลรองรับสถานที่

การให้เหตุผล

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

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

ช่อง

ฟิลด์สหภาพ justification

justification ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative เหตุผลรองรับ BusinessAvailabilityAttributes หน้านี้แสดงแอตทริบิวต์บางอย่างที่ธุรกิจมีซึ่งผู้ใช้ปลายทางอาจสนใจ

ช่อง
takeout

bool

หากสถานที่ให้บริการสั่งกลับบ้าน
delivery

bool

หากสถานที่มีบริการจัดส่ง
dine_in

bool

หากสถานที่ให้บริการนั่งรับประทานที่ร้าน

ReviewJustification

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

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

ช่อง
highlighted_text

HighlightedText
review

Review

รีวิวที่สร้างข้อความที่ไฮไลต์

HighlightedText

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

ช่อง
text

string
highlighted_text_ranges[]

HighlightedTextRange

รายการช่วงของข้อความที่ไฮไลต์

HighlightedTextRange

ช่วงของข้อความที่ไฮไลต์

ช่อง
start_index

int32
end_index

int32

EVChargeOptions

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

ช่อง
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

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

ช่อง
type

EVConnectorType

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

double

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

int32

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

Timestamp

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

int32

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

int32

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

EVConnectorType

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

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

FuelOptions

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

ช่อง
fuel_prices[]

FuelPrice

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

FuelPrice

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

ช่อง
type

FuelType

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

Money

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

Timestamp

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

FuelType

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

Enum
FUEL_TYPE_UNSPECIFIED ประเภทเชื้อเพลิงที่ไม่ระบุ
DIESEL เชื้อเพลิงดีเซล
REGULAR_UNLEADED ไร้โอกาสเป็นประจำ
MIDGRADE เบนซินระดับกลาง
PREMIUM Premium
SP91 SP 91
SP91_E10 SP 91 E10
SP92 SP 92
SP95 SP 95
SP95_E10 SP95 E10
SP98 SP 98
SP99 SP 99
SP100 SP 100
LPG LPG
E80 E 80.
E85 จ 85.
METHANE มีเทน
BIO_DIESEL ไบโอดีเซล
TRUCK_DIESEL น้ำมันดีเซลสำหรับรถบรรทุก

GetPhotoMediaRequest

คำขอดึงข้อมูลรูปภาพของสถานที่โดยใช้ชื่อทรัพยากรรูปภาพ

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของสื่อรูปภาพในรูปแบบ places/{place_id}/photos/{photo_reference}/media

ชื่อทรัพยากรของรูปภาพตามที่แสดงในช่อง photos.name ของวัตถุสถานที่จะอยู่ในรูปแบบ places/{place_id}/photos/{photo_reference} คุณต้องเพิ่ม /media ต่อท้ายทรัพยากรรูปภาพจึงจะได้ชื่อทรัพยากรสื่อรูปภาพ
max_width_px

int32

ไม่บังคับ ระบุความกว้างที่ต้องการสูงสุดเป็นพิกเซลของรูปภาพ หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าขนาดใดขนาดหนึ่ง จะมีการปรับขนาดให้ตรงกับขนาดที่เล็กกว่า โดยจำกัดตามอัตราส่วนต้นฉบับ ทั้งพร็อพเพอร์ตี้ max_height_px และ max_width_px ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 หากค่าไม่อยู่ในช่วงที่อนุญาต ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

ต้องระบุ max_height_px หรือ max_width_px อย่างน้อย 1 รายการ หากไม่ได้ระบุทั้ง max_height_px และ max_width_px ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
max_height_px

int32

ไม่บังคับ ระบุความสูงสูงสุดที่ต้องการเป็นพิกเซลของรูปภาพ หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าขนาดใดขนาดหนึ่ง จะมีการปรับขนาดให้ตรงกับขนาดที่เล็กกว่า โดยจำกัดตามอัตราส่วนต้นฉบับ ทั้งพร็อพเพอร์ตี้ max_height_px และ max_width_px ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 หากค่าไม่อยู่ในช่วงที่อนุญาต ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

ต้องระบุ max_height_px หรือ max_width_px อย่างน้อย 1 รายการ หากไม่ได้ระบุทั้ง max_height_px และ max_width_px ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
skip_http_redirect

bool

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

GetPlaceRequest

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

ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของสถานที่ในรูปแบบ places/{place_id}
language_code

string

ไม่บังคับ รายละเอียดสถานที่จะแสดงพร้อมภาษาที่ต้องการ หากมี

รายชื่อภาษาที่สนับสนุนในปัจจุบัน: https://developers.google.com/maps/faq#languagesupport
region_code

string

ไม่บังคับ รหัสภูมิภาคหรือรหัสประเทศแบบ Unicode (CLDR) ของตำแหน่งที่มาของคำขอ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่เฉพาะภูมิภาค (หากมี) พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง ดูข้อมูลเพิ่มเติมได้ที่ https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html

โปรดทราบว่าขณะนี้ยังไม่รองรับรหัสภูมิภาค 3 หลัก
session_token

string

ไม่บังคับ สตริงที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อจุดประสงค์ในการเรียกเก็บเงิน ต้องเป็น URL และสตริง base64 ที่ปลอดภัยสำหรับชื่อไฟล์ที่มีความยาวอักขระ ASCII ไม่เกิน 36 ตัว มิฉะนั้น ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์ข้อความค้นหา และสรุปเมื่อเลือกสถานที่และมีการเรียกรายละเอียดสถานที่หรือตรวจสอบที่อยู่ แต่ละเซสชันอาจมีการค้นหาหลายรายการ ตามด้วยรายละเอียดสถานที่หรือคำขอตรวจสอบที่อยู่ 1 รายการ ข้อมูลเข้าสู่ระบบที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สําหรับแต่ละเซสชัน หากไม่ระบุพารามิเตอร์ session_token หรือหากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินจากเซสชันเสมือนว่าไม่ได้ระบุโทเค็นเซสชันไว้ (เรียกเก็บเงินคำขอแต่ละรายการแยกกัน)

เราขอแนะนำหลักเกณฑ์ต่อไปนี้

  • ใช้โทเค็นเซสชันสำหรับการโทรที่เติมข้อความอัตโนมัติทั้งหมด
  • สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน เราขอแนะนำให้ใช้ UUID เวอร์ชัน 4
  • ตรวจสอบว่าข้อมูลเข้าสู่ระบบที่ใช้สำหรับคำขอการเติมข้อความอัตโนมัติ รายละเอียดสถานที่ และการตรวจสอบที่อยู่ทั้งหมดในเซสชันเป็นของโปรเจ็กต์ Cloud Console เดียวกัน
  • อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันให้เซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับมากกว่า 1 เซสชันจะส่งผลให้มีการเรียกเก็บเงินแต่ละคำขอแยกกัน

รูปภาพ

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

ช่อง
name

string

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

int32

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

int32

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

AuthorAttribution

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

PhotoMedia

สื่อรูปภาพจาก Places API

ช่อง
name

string

ชื่อทรัพยากรของสื่อรูปภาพในรูปแบบ places/{place_id}/photos/{photo_reference}/media
photo_uri

string

URI ระยะเวลาสั้นที่ใช้แสดงผลรูปภาพได้

สถานที่

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

ช่อง
name

string

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

string

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

LocalizedText

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

string

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

string

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

LocalizedText

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

string

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

string

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

string

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

string

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

AddressComponent

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

PlusCode

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

LatLng

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

Viewport

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

double

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

string

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

string

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

Review

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

OpeningHours

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

Photo

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

string

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

BusinessStatus

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

PriceLevel

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

Attribution

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

string

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

string

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

OpeningHours

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

OpeningHours

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

OpeningHours

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

LocalizedText

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

PaymentOptions

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

ParkingOptions

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

SubDestination

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

FuelOptions

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

EVChargeOptions

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

GenerativeSummary

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

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

AreaSummary

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

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

int32

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

int32

จำนวนรีวิวทั้งหมด (แบบมีหรือไม่มีข้อความ) สำหรับสถานที่นี้
takeout

bool

ระบุว่าธุรกิจรองรับการถ่ายโอนหรือไม่
delivery

bool

ระบุว่าธุรกิจรองรับการแสดงโฆษณาหรือไม่
dine_in

bool

ระบุว่าธุรกิจรองรับตัวเลือกที่นั่งในร่มหรือกลางแจ้ง
curbside_pickup

bool

ระบุว่าธุรกิจรองรับการรับสินค้าโดยไม่ต้องลงจากรถหรือไม่
reservable

bool

ระบุว่าสถานที่นี้รองรับการจองหรือไม่
serves_breakfast

bool

ระบุว่าสถานที่ให้บริการอาหารเช้าหรือไม่
serves_lunch

bool

ระบุว่าสถานที่ให้บริการอาหารกลางวันหรือไม่
serves_dinner

bool

ระบุว่าสถานที่ให้บริการอาหารค่ำหรือไม่
serves_beer

bool

ระบุว่าสถานที่ให้บริการเบียร์หรือไม่
serves_wine

bool

ระบุว่าสถานที่ให้บริการไวน์หรือไม่
serves_brunch

bool

ระบุว่าสถานที่ให้บริการอาหารมื้อสายหรือไม่
serves_vegetarian_food

bool

ระบุว่าสถานที่ให้บริการอาหารมังสวิรัติหรือไม่
outdoor_seating

bool

ทั้งยังมีที่นั่งกลางแจ้ง
live_music

bool

สถานที่มีดนตรีสด
menu_for_children

bool

สถานที่นี้มีเมนูสำหรับเด็ก
serves_cocktails

bool

ร้านนี้เสิร์ฟค็อกเทล
serves_dessert

bool

ร้านนี้เสิร์ฟของหวาน
serves_coffee

bool

ร้านนี้เสิร์ฟกาแฟ
good_for_children

bool

สถานที่นี้เหมาะสำหรับเด็ก
allows_dogs

bool

สถานที่นี้อนุญาตให้สุนัขเข้าได้
restroom

bool

สถานที่นี้มีห้องน้ำ
good_for_groups

bool

สถานที่รองรับกลุ่มลูกค้า
good_for_watching_sports

bool

สถานที่ที่เหมาะสำหรับการชมกีฬา
accessibility_options

AccessibilityOptions

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

AccessibilityOptions

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

ช่อง
wheelchair_accessible_parking

bool

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

bool

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

bool

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

bool

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

AddressComponent

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

ช่อง
long_text

string

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

string

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

string

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

string

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

AreaSummary

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

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

ช่อง
content_blocks[]

ContentBlock

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

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

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

ช่อง
provider

string

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

string

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

BusinessStatus

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

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

GenerativeSummary

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

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

ช่อง
overview

LocalizedText

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

LocalizedText

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

References

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

OpeningHours

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

ช่อง
periods[]

Period

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

string

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

SecondaryHoursType

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

SpecialDay

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

bool

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

ระยะเวลา

ช่วงเวลาที่สถานที่จะยังคงอยู่ในสถานะ open_now

ช่อง
open

Point

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

Point

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

จุด

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

ช่อง
date

Date

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

bool

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

int32

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

int32

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

int32

เลขนาที 2 หลัก ค่าอยู่ในช่วงระหว่าง 00 ถึง 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

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

ช่อง
date

Date

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

ParkingOptions

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

ช่อง
free_parking_lot

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

PaymentOptions

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

ช่อง
accepts_credit_cards

bool

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

bool

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

bool

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

bool

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

PlusCode

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

ช่อง
global_code

string

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

string

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

SubDestination

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

ช่อง
name

string

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

string

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

PriceLevel

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

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

รายการอ้างอิง

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

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

ช่อง
reviews[]

Review

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

string

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

ตรวจสอบ

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

ช่อง
name

string

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

string

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

LocalizedText

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

LocalizedText

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

double

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

AuthorAttribution

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

Timestamp

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

SearchNearbyRequest

ขอ Proto สำหรับ Search Nearby

ช่อง
language_code

string

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

รายชื่อภาษาที่สนับสนุนในปัจจุบัน: https://developers.google.com/maps/faq#languagesupport
region_code

string

รหัสภูมิภาคหรือรหัสประเทศแบบ Unicode (CLDR) ของตำแหน่งที่มาของคำขอ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่เฉพาะภูมิภาค (หากมี) พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมได้ที่ https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html

โปรดทราบว่าขณะนี้ยังไม่รองรับรหัสภูมิภาค 3 หลัก
included_types[]

string

ประเภทสถานที่ที่ระบุ (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

โดยสามารถระบุประเภทจากตาราง ก ได้สูงสุด 50 ประเภท

หากมีประเภทที่ขัดแย้งกัน เช่น ประเภทหนึ่งๆ ปรากฏทั้งใน total_types และ excluded_type ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {included_types = ["restaurant"], excluded_primary_types = ["การตั้งค่า"]} สถานที่ที่ส่งคืนจะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
excluded_types[]

string

ยกเว้นประเภทสถานที่ (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

โดยสามารถระบุประเภทจากตาราง ก ได้สูงสุด 50 ประเภท

หากลูกค้าระบุทั้งinclude_types (เช่น ร้านอาหาร) และ excluded_type (เช่น คาเฟ่) คำตอบควรรวมสถานที่ที่เป็นร้านอาหารแต่ไม่ใช่คาเฟ่ การตอบสนองประกอบด้วยสถานที่ที่ตรงกับinclude_types อย่างน้อย 1 รายการ และไม่มี excluded_types

หากมีประเภทที่ขัดแย้งกัน เช่น ประเภทหนึ่งๆ ปรากฏทั้งใน total_types และ excluded_type ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {included_types = ["restaurant"], excluded_primary_types = ["การตั้งค่า"]} สถานที่ที่ส่งคืนจะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
included_primary_types[]

string

ระบุประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types สถานที่สามารถมีประเภทหลักได้เพียงประเภทเดียวจากตารางประเภทที่รองรับที่เชื่อมโยงกับสถานที่ดังกล่าว

โดยสามารถระบุประเภทจากตาราง ก ได้สูงสุด 50 ประเภท

หากมีประเภทหลักที่ขัดแย้งกัน เช่น ประเภทปรากฏทั้งในประเภท include_primary_types และ excluded_primary_type ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {included_types = ["restaurant"], excluded_primary_types = ["การตั้งค่า"]} สถานที่ที่ส่งคืนจะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
excluded_primary_types[]

string

ยกเว้นประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station") จาก https://developers.google.com/maps/documentation/places/web-service/place-types

โดยสามารถระบุประเภทจากตาราง ก ได้สูงสุด 50 ประเภท

หากมีประเภทหลักที่ขัดแย้งกัน เช่น ประเภทปรากฏทั้งในประเภท include_primary_types และ excluded_primary_type ระบบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT

หากระบุประเภทสถานที่โดยมีข้อจำกัดหลายประเภท ระบบจะแสดงผลเฉพาะสถานที่ที่ตรงกับข้อจำกัดทั้งหมดเท่านั้น เช่น หากเรามี {included_types = ["restaurant"], excluded_primary_types = ["การตั้งค่า"]} สถานที่ที่ส่งคืนจะให้บริการที่เกี่ยวข้องกับ "ร้านอาหาร" แต่ไม่ได้ดำเนินธุรกิจในฐานะ "ร้านอาหาร" เป็นหลัก
max_result_count

int32

จำนวนผลลัพธ์สูงสุดที่จะแสดง ต้องมีค่าตั้งแต่ 1 ถึง 20 (ค่าเริ่มต้น) เท่านั้น หากไม่ได้ตั้งค่าไว้ ค่าตัวเลขจะกลับไปเป็นขีดจำกัดสูงสุด หากตั้งค่าจำนวนเป็นลบหรือเกินขีดจำกัดสูงสุด ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
location_restriction

LocationRestriction

ต้องระบุ ภูมิภาคที่จะค้นหา
rank_preference

RankPreference

วิธีจัดอันดับผลการค้นหาในการตอบกลับ

LocationRestriction

ภูมิภาคที่จะค้นหา

ช่อง

ฟิลด์สหภาพ type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
circle

Circle

วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี

RankPreference

วิธีจัดอันดับผลการค้นหาในการตอบกลับ

Enum
RANK_PREFERENCE_UNSPECIFIED ไม่ได้ตั้งค่า RankPreference จะใช้อันดับตาม POPULARITY โดยค่าเริ่มต้น
DISTANCE จัดอันดับผลการค้นหาตามระยะทาง
POPULARITY จัดอันดับผลการค้นหาตามความนิยม

SearchNearbyResponse

Proto ตอบกลับสำหรับ Search Nearby

ช่อง
places[]

Place

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

SearchTextRequest

ขอ Proto สำหรับ SearchText

ช่อง
text_query

string

ต้องระบุ การค้นหาข้อความสำหรับการค้นหาข้อความ
language_code

string

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

รายชื่อภาษาที่สนับสนุนในปัจจุบัน: https://developers.google.com/maps/faq#languagesupport
region_code

string

รหัสภูมิภาคหรือรหัสประเทศแบบ Unicode (CLDR) ของตำแหน่งที่มาของคำขอ พารามิเตอร์นี้ใช้เพื่อแสดงรายละเอียดสถานที่ เช่น ชื่อสถานที่เฉพาะภูมิภาค (หากมี) พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

ดูข้อมูลเพิ่มเติมได้ที่ https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html

โปรดทราบว่าขณะนี้ยังไม่รองรับรหัสภูมิภาค 3 หลัก
rank_preference

RankPreference

วิธีจัดอันดับผลการค้นหาในการตอบกลับ
included_type

string

ประเภทสถานที่ที่ขอ ดูประเภททั้งหมดที่รองรับได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-types รองรับเพียงประเภทเดียว
open_now

bool

ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่เปิดให้บริการอยู่ ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้เป็น "เท็จ"
min_rating

double

กรองผลลัพธ์ที่มีการให้คะแนนของผู้ใช้โดยเฉลี่ยต่ำกว่าขีดจำกัดนี้อย่างชัดเจน ค่าที่ถูกต้องต้องเป็นแบบลอยที่อยู่ระหว่าง 0 ถึง 5 (โดยรวม) ที่รอบ 0.5 ซึ่งก็คือ [0, 0.5, 1.0, ... , 5.0] โดยรวม คะแนนอินพุตจะปัดเศษขึ้นเป็น 0.5(เพดาน) ที่ใกล้เคียงที่สุด เช่น คะแนน 0.6 จะทำให้ผลลัพธ์ทั้งหมดที่มีคะแนนต่ำกว่า 1.0 ออก
max_result_count
(deprecated)

int32

เลิกใช้งานแล้ว: ใช้ page_size แทน

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

หากระบุทั้ง max_result_count และ page_size ระบบจะไม่สนใจ max_result_count
page_size

int32

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

หากระบุทั้ง max_result_count และ page_size ระบบจะไม่สนใจ max_result_count
page_token

string

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

เมื่อทำการใส่เลขหน้า พารามิเตอร์ทั้งหมดนอกเหนือจาก page_token, page_size และ max_result_count ที่ระบุอยู่ใน TextSearch ต้องตรงกับการเรียกเริ่มต้นที่ระบุโทเค็นของหน้า มิฉะนั้น ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
price_levels[]

PriceLevel

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

bool

ใช้เพื่อตั้งค่าการกรองประเภทที่เข้มงวดสำหรับinclude_type หากตั้งค่าเป็น "จริง" ระบบจะแสดงเฉพาะผลลัพธ์ประเภทเดียวกันเท่านั้น ค่าเริ่มต้นคือ "เท็จ"
location_bias

LocationBias

ภูมิภาคที่จะค้นหา ตำแหน่งนี้มีการให้น้ำหนักพิเศษ ซึ่งหมายความว่าอาจมีการแสดงผลลัพธ์รอบๆ ตำแหน่งที่ระบุ ตั้งค่าพร้อมกับ location_restriction ไม่ได้
location_restriction

LocationRestriction

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

EVOptions

ไม่บังคับ ตั้งค่าตัวเลือก EV ที่ค้นหาได้ของคำขอค้นหาสถานที่

EVOptions

ตัวเลือก EV ที่ค้นหาได้ของคำขอค้นหาสถานที่

ช่อง
minimum_charging_rate_kw

double

ไม่บังคับ อัตราการชาร์จขั้นต่ำที่ต้องการเป็นกิโลวัตต์ สถานที่ที่มีอัตราการชาร์จต่ำกว่าอัตราที่ระบุจะถูกกรองออก
connector_types[]

EVConnectorType

ไม่บังคับ รายการประเภทเครื่องมือเชื่อมต่อ EV ที่ต้องการ สถานที่ที่ไม่รองรับเครื่องมือเชื่อมต่อประเภทใดๆ ที่ระบุไว้จะถูกกรองออก

LocationBias

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

ช่อง

ฟิลด์สหภาพ type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

กล่องสี่เหลี่ยมผืนผ้าระบุได้จากมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้ rectangle.high() ต้องเป็นจุดตะวันออกเฉียงเหนือของวิวพอร์ตรูปสี่เหลี่ยมผืนผ้า rectangle.low() ต้องเป็นจุดตะวันตกเฉียงใต้ของวิวพอร์ตรูปสี่เหลี่ยมผืนผ้า rectangle.low().latitude() ต้องไม่เกิน rectangle.high().latitude() ซึ่งจะทำให้ช่วงละติจูดว่างเปล่า วิวพอร์ตรูปสี่เหลี่ยมผืนผ้าต้องไม่กว้างกว่า 180 องศา
circle

Circle

วงกลมที่กำหนดโดยจุดศูนย์กลางและรัศมี

LocationRestriction

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

ช่อง

ฟิลด์สหภาพ type

type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

กล่องสี่เหลี่ยมผืนผ้าระบุได้จากมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้ rectangle.high() ต้องเป็นจุดตะวันออกเฉียงเหนือของวิวพอร์ตรูปสี่เหลี่ยมผืนผ้า rectangle.low() ต้องเป็นจุดตะวันตกเฉียงใต้ของวิวพอร์ตรูปสี่เหลี่ยมผืนผ้า rectangle.low().latitude() ต้องไม่เกิน rectangle.high().latitude() ซึ่งจะทำให้ช่วงละติจูดว่างเปล่า วิวพอร์ตรูปสี่เหลี่ยมผืนผ้าต้องไม่กว้างกว่า 180 องศา

RankPreference

วิธีจัดอันดับผลการค้นหาในการตอบกลับ

Enum
RANK_PREFERENCE_UNSPECIFIED สำหรับคำค้นหาเชิงหมวดหมู่ เช่น "ร้านอาหารในเชียงใหม่" ระบบจะใช้ RELEVANCE เป็นค่าเริ่มต้น สำหรับคำค้นหาที่ไม่เกี่ยวข้องกับหมวดหมู่ เช่น "Mountain View, CA" เราขอแนะนำให้คุณไม่ตั้งค่า rankPreference
DISTANCE จัดอันดับผลการค้นหาตามระยะทาง
RELEVANCE จัดอันดับผลการค้นหาตามความเกี่ยวข้อง ลำดับการจัดเรียงจะกำหนดโดยกลุ่มการจัดอันดับปกติ

SearchTextResponse

โปรโตคอลการตอบสนองสำหรับ SearchText

ช่อง
places[]

Place

รายการสถานที่ที่ตรงกับเกณฑ์การค้นหาข้อความของผู้ใช้
contextual_contents[]

ContextualContent

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

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

string

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