Package google.maps.places.v1

ดัชนี

สถานที่

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

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

ต้องใช้ขอบเขต 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

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

ช่อง
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

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

ช่อง
input

string

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

LocationBias

ไม่บังคับ ปรับผลลัพธ์ให้เหมาะกับสถานที่ที่ระบุ

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

LocationRestriction

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

ควรตั้งค่า location_bias หรือ location_restriction ไม่เกิน 1 รายการ หากไม่ได้ตั้งค่าทั้ง 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

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

string

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

string

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

LatLng

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

int32

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

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

bool

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

string

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

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

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

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

bool

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

LocationBias

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

ช่อง

ฟิลด์สหภาพ type

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

Viewport

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

Circle

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

LocationRestriction

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

ช่อง

ฟิลด์สหภาพ type

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

Viewport

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

Circle

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

AutocompletePlacesResponse

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

ช่อง
suggestions[]

Suggestion

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

คำแนะนำ

ผลการค้นหาของคำแนะนำที่เติมข้อความอัตโนมัติ

ช่อง

ฟิลด์สหภาพ kind

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

PlacePrediction

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

QueryPrediction

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

FormattableText

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

ช่อง
text

string

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

StringRange

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

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

PlacePrediction

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

ช่อง
place

string

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

string

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

FormattableText

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

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

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

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

StructuredFormat

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

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

string

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

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

int32

ความยาวของเส้น geodesic เป็นเมตรจาก 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

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

ช่อง
topic

string

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

LocalizedText

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

References

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

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

ContextualContent

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

เนื้อหาที่สอดคล้องกับบริบทของคำค้นหาสถานที่

ช่อง
reviews[]

Review

รายการรีวิวเกี่ยวกับสถานที่นี้ ซึ่งสอดคล้องกับบริบทของคำค้นหาสถานที่
photos[]

Photo

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

Justification

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

เหตุผลที่เลือกสถานที่

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

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

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

ช่อง

ฟิลด์สหภาพ justification

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

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

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

ช่อง
takeout

bool

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

bool

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

bool

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

ReviewJustification

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

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

ช่อง
highlighted_text

HighlightedText
review

Review

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

HighlightedText

ข้อความที่ไฮไลต์โดยเหตุผลรองรับ ข้อมูลนี้เป็นข้อมูลย่อยของรีวิว 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 พอร์ต

ช่อง
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

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

ช่อง
type

EVConnectorType

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

double

อัตราการชาร์จสูงสุดแบบคงที่ใน kW ของขั้วต่อแต่ละตัวในการรวม
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 หัวชาร์จ J1772 ประเภท 1
EV_CONNECTOR_TYPE_TYPE_2 หัวชาร์จไฟฟ้า IEC 62196 ประเภท 2 มักเรียกว่า MENNEKES
EV_CONNECTOR_TYPE_CHADEMO หัวชาร์จไฟฟ้าประเภท CHAdeMO
EV_CONNECTOR_TYPE_CCS_COMBO_1 ระบบการชาร์จแบบรวม (AC และ DC) อิงตาม SAE หัวต่อ J-1772 ประเภท 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 ระบบการชาร์จแบบรวม (AC และ DC) อิงตามหัวชาร์จ Mennekes ประเภท 2
EV_CONNECTOR_TYPE_TESLA หัวต่อ TESLA ทั่วไป รูปแบบนี้เป็น NACS ในอเมริกาเหนือ แต่อาจไม่ใช่ NACS ในส่วนอื่นๆ ของโลก (เช่น CCS Combo 2 (CCS2) หรือ GB/T) ค่านี้ไม่ได้แสดงถึงประเภทหัวชาร์จจริง แต่แสดงถึงความสามารถในการชาร์จยานพาหนะแบรนด์ Tesla ที่สถานีชาร์จของ Tesla มากกว่า
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T ประเภท GB/T สอดคล้องกับมาตรฐาน GB/T ในจีน ประเภทนี้ครอบคลุม GB_T ทุกประเภท
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET เต้ารับติดผนังที่ไม่ระบุ
EV_CONNECTOR_TYPE_NACS ระบบการชาร์จของอเมริกาเหนือ (NACS) ตามมาตรฐาน SAE J3400

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 ของออบเจ็กต์สถานที่จะมีรูปแบบเป็น places/{place_id}/photos/{photo_reference} คุณต้องใส่ /media ต่อท้ายทรัพยากรรูปภาพเพื่อรับชื่อทรัพยากรสื่อรูปภาพ
max_width_px

int32

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

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

int32

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

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

bool

ไม่บังคับ หากตั้งค่าไว้ ระบบจะข้ามลักษณะการเปลี่ยนเส้นทาง HTTP เริ่มต้นและแสดงผลคำตอบในรูปแบบข้อความ (เช่น ในรูปแบบ JSON สำหรับ Use Case ของ 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
  • ตรวจสอบว่าข้อมูลเข้าสู่ระบบที่ใช้สำหรับคำขอการเติมข้อความอัตโนมัติของสถานที่ รายละเอียดสถานที่ และการตรวจสอบที่อยู่ทั้งหมดภายในเซสชันเป็นของโปรเจ็กต์คอนโซลระบบคลาวด์เดียวกัน
  • อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละรายการ การใช้โทเค็นเดียวกันในเซสชันมากกว่า 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

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

string

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

LocalizedText

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

string

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

string

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

string

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

string

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

AddressComponent

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

PlusCode

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

LatLng

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

Viewport

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

double

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

string

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

string

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

Review

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

OpeningHours

เวลาทําการปกติ โปรดทราบว่าหากสถานที่เปิดตลอด (24 ชั่วโมง) ระบบจะไม่ตั้งค่าช่อง close ลูกค้าสามารถเชื่อถือได้ว่า "เปิดตลอด (24 ชั่วโมง)" จะแสดงเป็นระยะเวลา [open][google.maps.places.v1.Place.OpeningHours.Period.open] ที่มี [day][Point.day] ที่มีค่า 0, [hour][Point.hour] ที่มีค่า 0 และ [minute][Point.minute] ที่มีค่า 0
time_zone

TimeZone

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

Photo

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

string

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

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

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

AreaSummary

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

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

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

AreaSummary

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

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

ช่อง
content_blocks[]

ContentBlock

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

string

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

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

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

ช่อง
provider

string

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

string

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

BusinessStatus

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

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

ContainingPlace

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

ช่อง
name

string

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

string

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

GenerativeSummary

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

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

ช่อง
overview

LocalizedText

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

string

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

LocalizedText

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

string

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

References

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

OpeningHours

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

ช่อง
periods[]

Period

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

string

สตริงที่แปลแล้วซึ่งอธิบายเวลาทําการของสถานที่นี้ โดยให้มี 1 สตริงสําหรับแต่ละวันของสัปดาห์ จะเป็นค่าว่างหากไม่ทราบเวลาทําการหรือแปลงเป็นข้อความที่แปลแล้วไม่ได้ ตัวอย่างเช่น "อาทิตย์: 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 องศาคูณ 1/8000 องศา (~14 x 14 เมตร)
compound_code

string

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

SubDestination

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

ช่อง
name

string

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

string

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

เส้นประกอบ

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

ช่อง
ฟิลด์สหภาพ 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

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

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

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

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

ช่อง
reviews[]

Review

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

string

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

ตรวจสอบ

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

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

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

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

ช่อง
legs[]

Leg

เที่ยวบินของการเดินทาง

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

string

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

ขา

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

ช่อง
duration

Duration

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

int32

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

SearchNearbyRequest

ขอโปรโตคอลสําหรับ Search Nearby

ช่อง
language_code

string

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

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

string

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

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

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

string

ประเภทสถานที่ที่รวมอยู่ (เช่น "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

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

ช่อง

ฟิลด์สหภาพ 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 ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป

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

PriceLevel

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

bool

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

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

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

SearchAlongRouteParameters

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

bool

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

EVOptions

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

ช่อง
minimum_charging_rate_kw

double

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

EVConnectorType

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

LocationBias

ภูมิภาคที่จะค้นหา สถานที่นี้ใช้เป็นค่าเบี่ยงเบน ซึ่งหมายความว่าระบบอาจแสดงผลการค้นหารอบๆ สถานที่ดังกล่าว

ช่อง

ฟิลด์สหภาพ type

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

Viewport

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

Circle

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

LocationRestriction

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

ช่อง

ฟิลด์สหภาพ type

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

Viewport

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

RankPreference

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

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

SearchAlongRouteParameters

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

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

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