Package google.maps.places.v1

Landmark

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

Area

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

string

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

string

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

LocalizedText

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

Containment

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

string

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

string

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

LocalizedText

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

string

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

SpatialRelationship

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

float

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

float

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

string

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

string

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

string

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

string

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

LocationBias

ไม่บังคับ แสดงผลการค้นหาที่เอนเอียงไปยังสถานที่ที่ระบุ

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

LocationRestriction

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

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

string

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

string

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

string

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

string

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

LatLng

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

int32

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

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

bool

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

string

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

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

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

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

bool

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

bool

ไม่บังคับ หากเป็นจริง ให้รวมธุรกิจที่ยังไม่เปิดทำการแต่จะเปิดในอนาคต

Viewport

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

Circle

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

Viewport

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

Circle

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

Suggestion

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

PlacePrediction

การคาดการณ์สำหรับสถานที่

QueryPrediction

การคาดการณ์สำหรับคำค้นหา

string

ข้อความที่อาจใช้ตามเดิมหรือจัดรูปแบบด้วย matches

StringRange

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

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

string

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

string

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

FormattableText

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

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

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

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

StructuredFormat

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

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

string

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

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

int32

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

FormattableText

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

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

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

StructuredFormat

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

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

int32

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

int32

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

FormattableText

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

FormattableText

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

LatLng

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

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

double

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

LocalizedText

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

string

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

Review

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

Photo

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

Justification

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

ReviewJustification

BusinessAvailabilityAttributesJustification

bool

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

bool

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

bool

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

HighlightedText

Review

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

string

HighlightedTextRange

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

int32

int32

int32

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

ConnectorAggregation

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

EVConnectorType

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

double

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

int32

จำนวนตัวเชื่อมต่อในการรวบรวมนี้

Timestamp

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

int32

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

int32

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

FuelPrice

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

FuelType

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

Money

ราคาน้ำมัน

Timestamp

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

string

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

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

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

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

bool

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

string

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

string

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

ดูรายการภาษาที่รองรับในปัจจุบันได้ที่ https://developers.google.com/maps/faq#languagesupport

string

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

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

string

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

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

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

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

string

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

int32

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

int32

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

AuthorAttribution

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

string

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

string

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

string

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

string

URI ที่มีอายุสั้นซึ่งใช้ในการแสดงรูปภาพได้

string

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

string

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

LocalizedText

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

string

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

string

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

LocalizedText

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

LocalizedText

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

string

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

string

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

string

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

string

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

PostalAddress

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

AddressComponent

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

PlusCode

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

LatLng

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

Viewport

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

double

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

string

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

string

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

Review

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

Photo

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

string

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

BusinessStatus

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

Date

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

PriceLevel

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

Attribution

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

string

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

string

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

OpeningHours

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

OpeningHours

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

OpeningHours

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

OpeningHours

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

TimeZone

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

LocalizedText

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

PaymentOptions

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

ParkingOptions

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

SubDestination

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

FuelOptions

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

EVChargeOptions

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

GenerativeSummary

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

ContainingPlace

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

AddressDescriptor

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

GoogleMapsLinks

ลิงก์เพื่อทริกเกอร์การดำเนินการต่างๆ ของ Google Maps

PriceRange

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

ReviewSummary

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

EvChargeAmenitySummary

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

NeighborhoodSummary

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

ConsumerAlert

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

string

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

string

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

TransitStation

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

int32

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

bool

ระบุว่าธุรกิจรองรับการสั่งกลับบ้านหรือไม่

bool

ระบุว่าธุรกิจรองรับการนำส่งหรือไม่

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

int32

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

bool

สถานที่นี้มีที่นั่งกลางแจ้ง

bool

สถานที่จัดดนตรีสด

bool

ร้านอาหารมีเมนูสำหรับเด็ก

bool

สถานที่ให้บริการค็อกเทล

bool

สถานที่นี้เสิร์ฟของหวาน

bool

สถานที่นี้มีบริการกาแฟ

bool

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

bool

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

bool

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

bool

ที่พักรองรับกลุ่ม

bool

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

AccessibilityOptions

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

bool

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

bool

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

bool

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

bool

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

bool

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

Details

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

string

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

string

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

string

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

Link

ลิงก์ที่จะแสดงพร้อมกับคำอธิบายเพื่อระบุข้อมูลเพิ่มเติม

string

ชื่อที่จะแสดงสำหรับลิงก์

string

URI ของลิงก์

string

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

string

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

ContentBlock

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

ContentBlock

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

ContentBlock

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

ContentBlock

สรุปข้อมูลร้านค้าใกล้เคียง

string

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

LocalizedText

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

LocalizedText

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

string

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

LocalizedText

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

string

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

string

ลิงก์เพื่อแสดงสถานที่นี้

string

ลิงก์สำหรับเขียนรีวิวสถานที่นี้ใน Google Maps

string

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

string

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

ContentBlock

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

ContentBlock

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

string

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

LocalizedText

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

Period

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

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

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

string

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

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

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

SecondaryHoursType

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

SpecialDay

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

Timestamp

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

Timestamp

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

bool

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

Point

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

Point

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

Date

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

bool

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

int32

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

int32

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

int32

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

Date

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

bool

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

bool

สถานที่นี้มีที่จอดรถแบบเสียเงิน

bool

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

bool

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

bool

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

bool

สถานที่นี้มีที่จอดรถในโรงจอดรถฟรี

bool

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

bool

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

bool

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

bool

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

bool

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

string

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

string

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

LocalizedText

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

string

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

LocalizedText

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

string

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

string

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

string

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

string

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

Money

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

Money

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

string

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

string

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

LocalizedText

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

LocalizedText

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

double

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

AuthorAttribution

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

Timestamp

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

string

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

string

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

Date

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

bool

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

bool

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

bool

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

bool

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

LatLng

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

TravelMode

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

RouteModifiers

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

RoutingPreference

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

Leg

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

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

string

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

Duration

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

int32

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

string

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

ดูรายการภาษาที่รองรับในปัจจุบันได้ที่ https://developers.google.com/maps/faq#languagesupport

string

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

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

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

string

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

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

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

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

string

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

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

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

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

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

string

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

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

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

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

string

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

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

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

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

int32

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

LocationRestriction

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

RankPreference

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

RoutingParameters

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

bool

ไม่บังคับ หากเป็นจริง ให้รวมธุรกิจที่ยังไม่เปิดทำการแต่จะเปิดในอนาคต

Circle

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

Place

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

RoutingSummary

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

string

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

string

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

ดูรายการภาษาที่รองรับในปัจจุบันได้ที่ https://developers.google.com/maps/faq#languagesupport

string

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

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

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

RankPreference

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

string

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

bool

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

double

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

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

int32

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

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

string

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

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

PriceLevel

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

bool

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

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

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

SearchAlongRouteParameters

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

bool

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

bool

ไม่บังคับ หากเป็นจริง ให้รวมธุรกิจที่ยังไม่เปิดทำการแต่จะเปิดในอนาคต

double

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

EVConnectorType

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

Viewport

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

Circle

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

Viewport

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

Polyline

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

Place

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

RoutingSummary

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

ContextualContent

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

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

string

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

string

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

LocalizedText

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

string

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

string

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

TransitIcon

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

TransitLine

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

string

URL ของไอคอน

bool

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

string

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

VehicleType

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

LocalizedText

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

LocalizedText

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

string

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

string

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

string

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

TransitIcon

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

TransitIcon

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

LocalizedText

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

TransitAgency

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

TransitStop

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

string

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

LatLng

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

bool

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