Package google.maps.places.v1

ดัชนี

สถานที่

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

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

ช่อง
landmarks[]

Landmark

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

Area

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

พื้นที่

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

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

ช่อง
name

string

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

string

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

LocalizedText

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

Containment

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

การล้อมองค์ประกอบ

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

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

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

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

สถานที่สำคัญคือสถานที่โดดเด่นที่ใช้เพื่ออธิบายสถานที่ตั้งได้

ช่อง
name

string

ชื่อทรัพยากรของสถานที่สำคัญ
place_id

string

รหัสสถานที่ของสถานที่สำคัญ
display_name

LocalizedText

ชื่อที่แสดงของสถานที่สำคัญ
types[]

string

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

SpatialRelationship

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

float

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

float

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

SpatialRelationship

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

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

AuthorAttribution

ข้อมูลเกี่ยวกับผู้เขียนข้อมูล UGC ใช้ใน Photo และ Review

ช่อง
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

ขอโปรโตคอลสำหรับการเติมข้อความอัตโนมัติของสถานที่

ช่อง
input

string

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

LocationBias

ไม่บังคับ เอนเอียงผลลัพธ์ไปยังสถานที่ที่ระบุ

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

LocationRestriction

ไม่บังคับ จำกัดผลการค้นหาไว้ที่สถานที่ที่ระบุ

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

string

ไม่บังคับ รวมประเภทสถานที่หลัก (เช่น "restaurant" หรือ "gas_station") ในประเภทสถานที่ (https://developers.google.com/maps/documentation/places/web-service/place-types) หรือเฉพาะ (regions) หรือเฉพาะ (cities) ระบบจะแสดงสถานที่ก็ต่อเมื่อประเภทหลักของสถานที่นั้นรวมอยู่ในรายการนี้ โดยระบุได้สูงสุด 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

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

int32

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

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

bool

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

string

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

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

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

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

bool

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

LocationBias

ภูมิภาคที่จะค้นหา ผลลัพธ์อาจมีอคติเกี่ยวกับภูมิภาคที่ระบุ

ช่อง

ฟิลด์ Union type

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

Viewport

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

Circle

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

LocationRestriction

ภูมิภาคที่จะค้นหา ผลการค้นหาจะจํากัดเฉพาะภูมิภาคที่ระบุ

ช่อง

ฟิลด์ Union type

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

Viewport

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

Circle

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

AutocompletePlacesResponse

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

ช่อง
suggestions[]

Suggestion

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

คำแนะนำ

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

ช่อง

ฟิลด์ Union 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

รายการประเภทที่ใช้กับสถานที่นี้จากตาราง A หรือตาราง B ใน 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

ออฟเซ็ตแบบอิงตาม 0 ของอักขระ Unicode ตัวแรกของสตริง (รวม)
end_offset

int32

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

StructuredFormat

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

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

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

ช่อง
main_text

FormattableText

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

FormattableText

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

วงกลม

วงกลมที่มี LatLng เป็นศูนย์กลางและรัศมี

ช่อง
center

LatLng

ต้องระบุ ละติจูดและลองจิจูดของจุดกึ่งกลาง

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

double

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

ContentBlock

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

ช่อง
content

LocalizedText

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

string

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

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

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

ช่อง

ฟิลด์ Union 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

ข้อความที่ไฮไลต์โดยเหตุผล ซึ่งเป็นส่วนย่อยของรีวิว คำที่ต้องการไฮไลต์จะทำเครื่องหมายด้วย HighlightedTextRange ข้อความที่ไฮไลต์อาจมีหลายคำ

ช่อง
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 แห่งมีพอร์ตอย่างน้อย 1 พอร์ต

ช่อง
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

ข้อมูลการชาร์จ EV จัดกลุ่มตาม [type, 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

ดูข้อมูล/บริบทเพิ่มเติมเกี่ยวกับประเภทหัวชาร์จรถยนต์ไฟฟ้าได้ที่ 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 หัวชาร์จไฟฟ้าประเภท 2 ตามมาตรฐาน IEC 62196 มักเรียกว่า 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

FuelOptions

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

ช่อง
fuel_prices[]

FuelPrice

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

FuelPrice

ข้อมูลราคาน้ำมันสำหรับประเภทที่ระบุ

ช่อง
type

FuelType

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

Money

ราคาน้ำมัน
update_time

Timestamp

เวลาที่อัปเดตราคาเชื้อเพลิงครั้งล่าสุด

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 ดีเซลสำหรับรถบรรทุก

GetPhotoMediaRequest

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

ช่อง
name

string

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

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

int32

ไม่บังคับ ระบุความกว้างสูงสุดที่ต้องการของรูปภาพในหน่วยพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติใดมิติหนึ่ง ระบบจะปรับขนาดให้ตรงกับมิติที่เล็กกว่าใน 2 มิตินั้น โดยจำกัดไว้ที่อัตราส่วนเดิม ทั้งพร็อพเพอร์ตี้ 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

ไม่บังคับ ระบุความสูงสูงสุดที่ต้องการของรูปภาพเป็นพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติใดมิติหนึ่ง ระบบจะปรับขนาดให้ตรงกับมิติที่เล็กกว่าใน 2 มิตินั้น โดยจำกัดไว้ที่อัตราส่วนเดิม ทั้งพร็อพเพอร์ตี้ 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

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

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

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

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

รูปภาพ

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

ช่อง
name

string

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

int32

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

int32

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

AuthorAttribution

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

string

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

string

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

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

ที่อยู่ที่มนุษย์อ่านได้แบบย่อของสถานที่นี้
postal_address

PostalAddress

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

AddressComponent

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

PlusCode

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

LatLng

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

Viewport

วิวพอร์ตที่เหมาะสําหรับการแสดงสถานที่ในแผนที่ขนาดเฉลี่ย ไม่ควรใช้ Viewport นี้เป็นขอบเขตจริงหรือพื้นที่ให้บริการของธุรกิจ
rating

double

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

string

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

string

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

Review

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

OpeningHours

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

TimeZone

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

Photo

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

string

ที่อยู่ของสถานที่ในรูปแบบ Microformat ของ adr: 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

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

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

ReviewSummary

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

EvChargeAmenitySummary

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

NeighborhoodSummary

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

ConsumerAlert

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

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

bool

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

AccessibilityOptions

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

ช่อง
wheelchair_accessible_parking

bool

สถานที่นี้มีที่จอดรถที่รองรับเก้าอี้รถเข็น
wheelchair_accessible_entrance

bool

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

bool

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

bool

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

AddressComponent

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

ช่อง
long_text

string

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

string

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

string

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

string

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

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

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

ช่อง
provider

string

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

string

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

BusinessStatus

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

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

ConsumerAlert

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

ช่อง
overview

string

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

Details

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

string

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

รายละเอียด

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

ช่อง
title

string

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

string

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

ContainingPlace

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

ช่อง
name

string

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

string

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

EvChargeAmenitySummary

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

ช่อง
overview

ContentBlock

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

ContentBlock

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

ContentBlock

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

ContentBlock

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

string

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

LocalizedText

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

GenerativeSummary

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

ช่อง
overview

LocalizedText

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

string

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

LocalizedText

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

NeighborhoodSummary

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

ช่อง
overview

ContentBlock

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

ContentBlock

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

string

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

LocalizedText

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

OpeningHours

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

ช่อง
periods[]

Period

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

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

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

string

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

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

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

SecondaryHoursType

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

SpecialDay

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

Timestamp

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

Timestamp

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

bool

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

ระยะเวลา

ระยะเวลาที่สถานที่ยังคงมีสถานะ open_now

ช่อง
open

Point

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

Point

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

จุด

จุดเปลี่ยนแปลงสถานะ

ช่อง
date

Date

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

bool

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

int32

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

int32

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

int32

นาที ค่าอยู่ในช่วงระหว่าง 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

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

ช่อง
date

Date

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

ParkingOptions

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

ช่อง
free_parking_lot

bool

สถานที่นั้นมีที่จอดรถฟรี
paid_parking_lot

bool

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

bool

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

bool

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

ช่อง
global_code

string

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

string

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

ReviewSummary

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

ช่อง
text

LocalizedText

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

string

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

LocalizedText

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

string

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

SubDestination

จุดหมายย่อยคือสถานที่เฉพาะที่เชื่อมโยงกับสถานที่หลัก ซึ่งจะระบุจุดหมายที่เฉพาะเจาะจงมากขึ้นสำหรับผู้ใช้ที่ค้นหาภายในสถานที่ขนาดใหญ่หรือซับซ้อน เช่น สนามบิน อุทยานแห่งชาติ มหาวิทยาลัย หรือสนามกีฬา เช่น ปลายทางย่อยที่สนามบินอาจรวมถึงอาคารผู้โดยสารและลานจอดรถที่เกี่ยวข้อง ปลายทางย่อยจะแสดงรหัสสถานที่และชื่อทรัพยากรของสถานที่ ซึ่งสามารถใช้ในคำขอรายละเอียดสถานที่ (ใหม่) ที่ตามมาเพื่อดึงรายละเอียดที่ละเอียดยิ่งขึ้น รวมถึงชื่อที่แสดงและตำแหน่งของปลายทางย่อย

ช่อง
name

string

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

string

รหัสสถานที่ของจุดหมายย่อย

เส้นประกอบ

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

ช่อง
ฟิลด์ Union polyline_type แคปซูลประเภทของเส้นประกอบ เอาต์พุตของ Routes API จะเป็น encoded_polyline โดยค่าเริ่มต้น polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
encoded_polyline

string

เส้นประกอบที่เข้ารหัสตามที่ Routes API แสดงผลโดยค่าเริ่มต้น ดูเครื่องมือโปรแกรมเปลี่ยนไฟล์และโปรแกรมถอดรหัส

PriceLevel

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

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

PriceRange

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

ช่อง
start_price

Money

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

Money

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

ตรวจสอบ

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

ช่อง
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

การประทับเวลาของรีวิว
flag_content_uri

string

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

string

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

Date

วันที่ผู้เขียนไปเยือนสถานที่ ระบบจะตัดทอนเป็นเดือน

RouteModifiers

แคปซูลชุดเงื่อนไขที่ไม่บังคับเพื่อตอบสนองเมื่อคำนวณเส้นทาง

ช่อง
avoid_tolls

bool

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" จะหลีกเลี่ยงถนนที่มีค่าผ่านทางหากเป็นไปได้ โดยจะให้ความสำคัญกับเส้นทางที่ไม่มีถนนที่มีค่าผ่านทาง โดยจะมีผลเฉพาะกับ DRIVE และ TWO_WHEELER TravelMode เท่านั้น
avoid_highways

bool

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงทางหลวงเมื่อเป็นไปได้ และให้ความสำคัญกับเส้นทางที่ไม่มีทางหลวง โดยจะมีผลเฉพาะกับ DRIVE และ TWO_WHEELER TravelMode เท่านั้น
avoid_ferries

bool

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงเรือข้ามฟากเมื่อเป็นไปได้ และให้ความสำคัญกับเส้นทางที่ไม่มีเรือข้ามฟาก โดยจะมีผลเฉพาะกับ DRIVE และ TWO_WHEELER TravelMode เท่านั้น
avoid_indoor

bool

ไม่บังคับ เมื่อตั้งค่าเป็น "จริง" ระบบจะหลีกเลี่ยงการนำทางในอาคารหากเป็นไปได้ และให้ความสำคัญกับเส้นทางที่ไม่มีการนำทางในอาคาร ใช้กับ WALK TravelMode เท่านั้น

RoutingParameters

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

ช่อง
origin

LatLng

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

TravelMode

ไม่บังคับ โหมดการเดินทาง
route_modifiers

RouteModifiers

ไม่บังคับ ตัวแก้ไขเส้นทาง
routing_preference

RoutingPreference

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

RoutingPreference

ชุดค่าที่ระบุปัจจัยที่ต้องพิจารณาเมื่อคำนวณเส้นทาง

Enum
ROUTING_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนดการกำหนดเส้นทาง ค่าเริ่มต้นคือ TRAFFIC_UNAWARE
TRAFFIC_UNAWARE คำนวณเส้นทางโดยไม่พิจารณาสภาพการจราจรแบบเรียลไทม์ เหมาะสำหรับกรณีที่สภาพการจราจรไม่สำคัญหรือไม่เกี่ยวข้อง การใช้ค่านี้จะทำให้เกิดเวลาในการตอบสนองต่ำที่สุด หมายเหตุ: สำหรับ TravelMode DRIVE และ TWO_WHEELER เส้นทางและระยะเวลาที่เลือกจะอิงตามเครือข่ายถนนและสภาพการจราจรโดยเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา ไม่ใช่สภาพถนนปัจจุบัน ดังนั้น เส้นทางอาจรวมถึงถนนที่ปิดชั่วคราว ผลลัพธ์สำหรับคำขอหนึ่งๆ อาจแตกต่างกันไปตามเวลาเนื่องจากการเปลี่ยนแปลงในเครือข่ายถนน สภาพการจราจรโดยเฉลี่ยที่อัปเดตแล้ว และลักษณะการทำงานแบบกระจายของบริการ นอกจากนี้ ผลลัพธ์อาจแตกต่างกันระหว่างเส้นทางที่เกือบจะเทียบเท่ากันได้ทุกเมื่อหรือทุกความถี่
TRAFFIC_AWARE คำนวณเส้นทางโดยพิจารณาสภาพการจราจรแบบเรียลไทม์ ในทางตรงกันข้ามกับ TRAFFIC_AWARE_OPTIMAL การเพิ่มประสิทธิภาพบางอย่างจะใช้เพื่อลดเวลาในการตอบสนองอย่างมาก
TRAFFIC_AWARE_OPTIMAL คำนวณเส้นทางโดยพิจารณาสภาพการจราจรแบบเรียลไทม์โดยไม่ต้องใช้การเพิ่มประสิทธิภาพส่วนใหญ่ การใช้ค่านี้จะทำให้เกิดเวลาในการตอบสนองสูงสุด

RoutingSummary

ระยะเวลาและระยะทางจากจุดเริ่มต้นของการกำหนดเส้นทางไปยังสถานที่ในคำตอบ และช่วงที่ 2 จากสถานที่นั้นไปยังจุดหมาย หากมีการขอ หมายเหตุ: การเพิ่ม routingSummaries ในมาสก์ฟิลด์โดยไม่ได้รวมพารามิเตอร์ routingParameters.origin หรือพารามิเตอร์ searchAlongRouteParameters.polyline.encodedPolyline ไว้ในคำขอด้วยจะทำให้เกิดข้อผิดพลาด

ช่อง
legs[]

Leg

ช่วงของการเดินทาง

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

string

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

ขา

ช่วงการเดินทางคือส่วนหนึ่งของการเดินทางจากที่หนึ่งไปยังอีกที่หนึ่ง

ช่อง
duration

Duration

เวลาที่ใช้ในการเดินทางช่วงนี้
distance_meters

int32

ระยะทางของการเดินทางช่วงนี้

SearchNearbyRequest

ขอโปรโตคอลสำหรับค้นหาสถานที่ใกล้เคียง

ช่อง
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

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

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

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

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

string

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

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

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

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

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

string

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

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

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

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

string

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

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

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

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

int32

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

LocationRestriction

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

RankPreference

วิธีจัดอันดับผลลัพธ์ในการตอบกลับ
routing_parameters

RoutingParameters

ไม่บังคับ พารามิเตอร์ที่มีผลต่อการกำหนดเส้นทางไปยังผลการค้นหา

LocationRestriction

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

ช่อง

ฟิลด์ Union type

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

Circle

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

RankPreference

วิธีจัดอันดับผลลัพธ์ในการตอบกลับ

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

SearchNearbyResponse

โปรโตการตอบกลับสำหรับการค้นหาในบริเวณใกล้เคียง

ช่อง
places[]

Place

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

RoutingSummary

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

SearchTextRequest

โปรโตคอลคำขอสำหรับ 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

ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่เปิดอยู่ ค่าเริ่มต้นคือ False
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

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

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

ไม่บังคับ พารามิเตอร์เพิ่มเติมสำหรับการกำหนดเส้นทางไปยังผลลัพธ์
search_along_route_parameters

SearchAlongRouteParameters

ไม่บังคับ Proto ของพารามิเตอร์เพิ่มเติมสำหรับการค้นหาตามเส้นทาง
include_pure_service_area_businesses

bool

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

EVOptions

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

ช่อง
minimum_charging_rate_kw

double

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

EVConnectorType

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

LocationBias

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

ช่อง

ฟิลด์ Union type

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

Viewport

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

Circle

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

LocationRestriction

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

ช่อง

ฟิลด์ Union type

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

Viewport

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

RankPreference

วิธีจัดอันดับผลลัพธ์ในการตอบกลับ

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

SearchAlongRouteParameters

ระบุเส้นประกอบที่คำนวณไว้ล่วงหน้าจาก Routes API ซึ่งกำหนดเส้นทางที่จะค้นหา การค้นหาตามเส้นทางจะคล้ายกับการใช้ตัวเลือกคำขอ locationBias หรือ locationRestriction เพื่อให้ผลการค้นหามีแนวโน้มไปในทิศทางใดทิศทางหนึ่ง อย่างไรก็ตาม แม้ว่าตัวเลือก locationBias และ locationRestriction จะช่วยให้คุณระบุภูมิภาคเพื่อกำหนดผลการค้นหาได้ แต่ตัวเลือกนี้จะช่วยให้คุณกำหนดผลการค้นหาตามเส้นทางการเดินทางได้

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

ช่อง
polyline

Polyline

ต้องระบุ เส้นประกอบของเส้นทาง

SearchTextResponse

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

ช่อง
places[]

Place

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

RoutingSummary

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

ContextualContent

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

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

string

โทเค็นที่ส่งเป็น page_token เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นหรือเว้นว่างช่องนี้ไว้ จะไม่มีหน้าถัดไป
search_uri

string

ลิงก์จะช่วยให้ผู้ใช้ค้นหาด้วยข้อความค้นหาเดียวกันกับที่ระบุไว้ในคำขอใน Google Maps ได้

TravelMode

ตัวเลือกโหมดการเดินทาง ตัวเลือกเหล่านี้สอดคล้องกับสิ่งที่ Routes API มีให้

Enum
TRAVEL_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการเดินทาง ค่าเริ่มต้นคือ DRIVE
DRIVE เดินทางโดยรถยนต์นั่งส่วนบุคคล
BICYCLE เดินทางด้วยจักรยาน ไม่รองรับใน search_along_route_parameters
WALK เดินทางด้วยการเดิน ไม่รองรับใน search_along_route_parameters
TWO_WHEELER ยานพาหนะ 2 ล้อที่ขับเคลื่อนด้วยเครื่องยนต์ทุกประเภท เช่น สกูตเตอร์และจักรยานยนต์ โปรดทราบว่าสิ่งนี้แตกต่างจากBICYCLEรูปแบบการเดินทางซึ่งครอบคลุมการเดินทางที่ใช้แรงคน ไม่รองรับใน search_along_route_parameters รองรับเฉพาะในประเทศที่ระบุไว้ในประเทศและภูมิภาคที่รองรับสำหรับยานพาหนะ 2 ล้อ