- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- เส้นทาง
- RouteLabel
- RouteLeg
- โพลีไลน์
- RouteLegStep
- NavigationInstruction
- การบังคับทิศทาง
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- วิวพอร์ต
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
แสดงผลเส้นทางหลักพร้อมกับเส้นทางเลือกอื่นๆ โดยกำหนดชุดปลายทางและจุดระหว่างทาง
หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องคำตอบในอินพุต คุณระบุฟิลด์มาสก์การตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields
หรือ fields
หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask
(ดูพารามิเตอร์และส่วนหัวของ URL ที่ใช้ได้) ค่านี้คือรายการเส้นทางฟิลด์ที่คั่นด้วยคอมมา ดูเอกสารประกอบโดยละเอียดเกี่ยวกับวิธีสร้างเส้นทางภาคสนาม
ตัวอย่างเช่น ในวิธีนี้
- ฟิลด์มาสก์ของช่องทั้งหมดที่มี (สำหรับการตรวจสอบด้วยตนเอง):
X-Goog-FieldMask: *
- ฟิลด์มาสก์ของระยะเวลาระดับเส้นทาง ระยะทาง และเส้นประกอบ (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google ไม่แนะนำให้ใช้มาสก์ช่องคำตอบที่มีไวลด์การ์ด (*
) หรือระบุฟิลด์มาสก์ที่ระดับบนสุด (routes
) เนื่องจากสาเหตุต่อไปนี้
- การเลือกเฉพาะช่องที่คุณต้องการจะช่วยให้เซิร์ฟเวอร์ของเราบันทึกรอบการคำนวณได้ ซึ่งทำให้เราสามารถส่งคืนผลลัพธ์ให้คุณโดยมีเวลาในการตอบสนองที่น้อยลง
- การเลือกเฉพาะช่องที่จำเป็นในงานเวอร์ชันที่ใช้งานจริงจะช่วยให้เวลาในการตอบสนองที่เสถียร เราอาจเพิ่มช่องคำตอบในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการคำนวณเพิ่มเติม หากเลือกทุกช่องหรือเลือกช่องทั้งหมดที่ระดับบนสุด ประสิทธิภาพอาจลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในคำตอบโดยอัตโนมัติ
- การเลือกเฉพาะฟิลด์ที่คุณต้องการจะให้ผลลัพธ์ที่มีขนาดการตอบกลับที่เล็กลง และทำให้อัตราการส่งข้อมูลของเครือข่ายสูงขึ้น
คำขอ HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "origin": { object ( |
ช่อง | |
---|---|
origin |
ต้องระบุ จุดอ้างอิงเดิม |
destination |
ต้องระบุ จุดอ้างอิงปลายทาง |
intermediates[] |
ไม่บังคับ ชุดของจุดอ้างอิงระหว่างเส้นทาง (ไม่รวมจุดปลายทาง) สำหรับการหยุดหรือขับผ่าน รองรับจุดอ้างอิงระดับกลางสูงสุด 25 จุด |
travelMode |
ไม่บังคับ ระบุรูปแบบการเดินทาง |
routingPreference |
ไม่บังคับ ระบุวิธีคํานวณเส้นทาง เซิร์ฟเวอร์พยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกไว้เพื่อคำนวณเส้นทาง หากค่ากำหนดการกำหนดเส้นทางทำให้เกิดข้อผิดพลาดหรือใช้เวลากับเวลาในการตอบสนองนานขึ้น ระบบจะแสดงข้อผิดพลาด คุณจะระบุตัวเลือกนี้ได้เฉพาะเมื่อ |
polylineQuality |
ไม่บังคับ ระบุค่ากําหนดคุณภาพของโพลีไลน์ |
polylineEncoding |
ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับเส้นประกอบ |
departureTime |
ไม่บังคับ เวลาออกเดินทาง หากไม่ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หมายเหตุ: คุณจะระบุ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
arrivalTime |
ไม่บังคับ เวลาถึง หมายเหตุ: ตั้งค่าได้เมื่อตั้งค่า การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
computeAlternativeRoutes |
ไม่บังคับ ระบุว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางหรือไม่ ระบบจะไม่ส่งคืนเส้นทางสำรองสำหรับคำขอที่มีจุดอ้างอิงระดับกลาง |
routeModifiers |
ไม่บังคับ ชุดเงื่อนไขที่จะปฏิบัติตามที่ส่งผลต่อวิธีคำนวณเส้นทาง |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษา Unicode โปรดดูรายการภาษาที่รองรับได้ที่การสนับสนุนภาษา เมื่อไม่ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของคำขอเส้นทาง |
regionCode |
ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดตามรหัสประเทศ |
units |
ไม่บังคับ ระบุหน่วยวัดสำหรับช่องแสดงผล ช่องเหล่านี้รวมถึงช่อง |
optimizeWaypointOrder |
ไม่บังคับ หากตั้งค่าเป็น "จริง" บริการจะพยายามลดค่าใช้จ่ายโดยรวมของเส้นทางโดยจัดเรียงจุดอ้างอิงระดับกลางที่ระบุไว้ใหม่ คำขอจะไม่สำเร็จหากจุดอ้างอิงระดับกลางเป็นจุดอ้างอิง |
requestedReferenceRoutes[] |
ไม่บังคับ ระบุเส้นทางการอ้างอิงที่จะคำนวณเป็นส่วนหนึ่งของคำขอนอกเหนือจากเส้นทางเริ่มต้น เส้นทางอ้างอิงเป็นเส้นทางที่มีวัตถุประสงค์การคํานวณเส้นทางที่แตกต่างจากเส้นทางเริ่มต้น ตัวอย่างเช่น การคำนวณเส้นทางอ้างอิง |
extraComputations[] |
ไม่บังคับ รายการการคำนวณเพิ่มเติมที่อาจนำไปใช้ในการดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในคำตอบ ต้องระบุช่องเพิ่มเติมเหล่านี้ในมาสก์ของช่องที่จะส่งคืนในการตอบกลับ |
trafficModel |
ไม่บังคับ ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการรับส่ง การตั้งค่านี้ส่งผลต่อค่าที่แสดงผลในช่องระยะเวลาใน |
transitPreferences |
ไม่บังคับ ระบุค่ากำหนดที่มีผลต่อเส้นทางที่แสดงผลสำหรับ |
เนื้อหาการตอบกลับ
v2.computeRoutes ข้อความตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "routes": [ { object ( |
ช่อง | |
---|---|
routes[] |
มีอาร์เรย์ของเส้นทางที่คำนวณแล้ว (สูงสุด 3 เส้นทาง) เมื่อคุณระบุ |
fallbackInfo |
ในบางกรณี เมื่อเซิร์ฟเวอร์ไม่สามารถคำนวณผลลัพธ์เส้นทางด้วยค่ากำหนดอินพุตทั้งหมด เซิร์ฟเวอร์อาจกลับไปใช้การคำนวณวิธีอื่น เมื่อใช้โหมดสำรอง ช่องนี้จะมีข้อมูลโดยละเอียดเกี่ยวกับการตอบกลับสำรอง มิเช่นนั้นระบบจะไม่ได้ตั้งค่าช่องนี้ |
geocodingResults |
มีข้อมูลการตอบกลับที่ระบุพิกัดทางภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่ |
PolylineQuality
ชุดค่าที่ระบุคุณภาพของเส้นประกอบ
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
ไม่ได้ระบุค่ากำหนดคุณภาพโพลีไลน์ ค่าเริ่มต้นคือ OVERVIEW |
HIGH_QUALITY |
ระบุเส้นประกอบคุณภาพสูง ซึ่งสร้างขึ้นโดยใช้จุดมากกว่า OVERVIEW แต่มีขนาดการตอบสนองเพิ่มขึ้น ใช้ค่านี้เมื่อต้องการความแม่นยำมากขึ้น |
OVERVIEW |
ระบุเส้นประกอบภาพรวม ซึ่งสร้างขึ้นโดยใช้จุดจำนวนน้อย ใช้ค่านี้เมื่อแสดงภาพรวมของเส้นทาง การใช้ตัวเลือกนี้จะมีเวลาในการตอบสนองของคำขอต่ำกว่าเมื่อเทียบกับการใช้ตัวเลือก HIGH_QUALITY |
PolylineEncoding
ระบุประเภทของโพลีไลน์ที่ต้องการให้แสดงผล
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
ไม่ได้ระบุค่ากำหนดประเภทโพลีไลน์ ค่าเริ่มต้นคือ ENCODED_POLYLINE |
ENCODED_POLYLINE |
ระบุเส้นประกอบที่เข้ารหัสโดยใช้อัลกอริทึมการเข้ารหัสแบบโพลีไลน์ |
GEO_JSON_LINESTRING |
ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString |
ReferenceRoute
เส้นทางการอ้างอิงที่รองรับบน ComputeRoutesRequest
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
ไม่ได้ใช้ คำขอที่มีค่านี้จะดำเนินการไม่สำเร็จ |
FUEL_EFFICIENT |
เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่ติดป้ายกำกับด้วยค่านี้ได้รับการกำหนดมาเพื่อเพิ่มประสิทธิภาพให้กับพารามิเตอร์ต่างๆ เช่น การบริโภคน้ำมันเชื้อเพลิง |
ExtraComputation
การคำนวณเพิ่มเติมที่จะดำเนินการในระหว่างดำเนินการตามคำขอ
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
ไม่ได้ใช้ คำขอที่มีค่านี้จะดำเนินการไม่สำเร็จ |
TOLLS |
ข้อมูลค่าผ่านทางสำหรับเส้นทาง |
FUEL_CONSUMPTION |
ปริมาณการใช้เชื้อเพลิงโดยประมาณสำหรับเส้นทาง |
TRAFFIC_ON_POLYLINE |
เส้นประกอบต่างๆ ที่รับรู้การจราจรสำหรับเส้นทาง |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions แสดงเป็นสตริงข้อความ HTML ที่จัดรูปแบบแล้ว เนื้อหานี้ให้อ่านตามที่เป็นอยู่ เนื้อหานี้ใช้สำหรับแสดงเท่านั้น อย่าแยกวิเคราะห์ข้อความโดยโปรแกรม |
เส้นทาง
ประกอบด้วยเส้นทางที่ประกอบด้วยชุดส่วนของถนนที่เชื่อมต่อกัน ซึ่งเชื่อมถึงจุดเริ่ม จุดสิ้นสุด และตรงกลาง
การแสดง JSON |
---|
{ "routeLabels": [ enum ( |
ช่อง | |
---|---|
routeLabels[] |
ป้ายกำกับสำหรับ |
legs[] |
คอลเล็กชันของขา (ส่วนของเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละขาตรงกับการเดินทางระหว่าง 2 แถวที่ไม่ใช่ |
distanceMeters |
ระยะทางในการเดินทางของเส้นทางในหน่วยเมตร |
duration |
ระยะเวลาที่ต้องใช้ในการนำทาง หากคุณตั้งค่า ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
staticDuration |
ระยะเวลาเดินทางตามเส้นทางโดยไม่พิจารณาสภาพการจราจร ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
polyline |
เส้นประกอบเส้นทางโดยรวม เส้นประกอบนี้เป็นเส้นประกอบของ |
description |
คำอธิบายเส้นทาง |
warnings[] |
อาร์เรย์ของคำเตือนที่จะแสดงเมื่อแสดงเส้นทาง |
viewport |
กรอบล้อมรอบวิวพอร์ตของเส้นประกอบ |
travelAdvisory |
ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง |
optimizedIntermediateWaypointIndex[] |
หากคุณตั้งค่า |
localizedValues |
รูปแบบข้อความแสดงพร็อพเพอร์ตี้ของ |
routeToken |
โทเค็นเส้นทางที่เข้ารหัสแบบ Base64 สำหรับเว็บซึ่งสามารถส่งผ่านไปยัง Navigation SDK ทำให้ Navigation SDK สามารถปรับโครงสร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่เปลี่ยนเส้นทาง ให้ยึดตามความตั้งใจเดิมเมื่อคุณสร้างเส้นทางด้วยการเรียกใช้ v2.computeRoutes ลูกค้าควรถือว่าโทเค็นนี้เป็น Blob ทึบ ไม่ได้มีไว้เพื่ออ่านหรือเปลี่ยนแปลง หมายเหตุ: |
RouteLabel
ป้ายกำกับสำหรับ
ที่มีประโยชน์ในการระบุคุณสมบัติเฉพาะของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นRoute
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
ค่าเริ่มต้น - ไม่ใช้ |
DEFAULT_ROUTE |
แสดงเส้นทาง "ดีที่สุด" เริ่มต้นในการคำนวณเส้นทาง |
DEFAULT_ROUTE_ALTERNATE |
ทางเลือกหนึ่งในเส้นทาง "ดีที่สุด" เริ่มต้น ระบบจะส่งคืนเส้นทางลักษณะนี้เมื่อมีการระบุ
|
FUEL_EFFICIENT |
เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่ติดป้ายกำกับด้วยค่านี้ได้รับการกำหนดมาเพื่อเพิ่มประสิทธิภาพให้กับพารามิเตอร์อีโค เช่น การบริโภคเชื้อเพลิง |
RouteLeg
ประกอบด้วยกลุ่มระหว่างจุดอ้างอิงที่ไม่ใช่ via
การแสดง JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
ช่อง | |
---|---|
distanceMeters |
ระยะทางในการเดินทางของเส้นทางในหน่วยเมตร |
duration |
ระยะเวลาที่ต้องใช้ในการนำทาง หากตั้งค่า ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
staticDuration |
ระยะเวลาเดินทางผ่านขา โดยคำนวณโดยไม่คำนึงถึงสภาพการจราจร ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
polyline |
เส้นประกอบโดยรวมของขานี้ที่มีเส้นประกอบของ |
startLocation |
ตำแหน่งเริ่มต้นของขานี้ สถานที่ตั้งนี้อาจแตกต่างจาก |
endLocation |
ตำแหน่งสิ้นสุดของขานี้ สถานที่ตั้งนี้อาจแตกต่างจาก |
steps[] |
ขั้นตอนต่างๆ ที่แสดงถึงส่วนต่างๆ ภายในขานี้ แต่ละขั้นตอนจะแสดงวิธีการไปยังส่วนต่างๆ 1 วิธี |
travelAdvisory |
มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ ในเส้นทาง |
localizedValues |
รูปแบบข้อความแสดงพร็อพเพอร์ตี้ของ |
stepsOverview |
ภาพรวมเกี่ยวกับขั้นตอนใน |
เส้นประกอบ
ห่อหุ้มโพลีไลน์ที่เข้ารหัส
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ polyline_type ห่อหุ้มประเภทของโพลีไลน์ ค่าเริ่มต้นเป็น encrypted_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
encodedPolyline |
การเข้ารหัสสตริงของโพลีไลน์โดยใช้อัลกอริทึมการเข้ารหัสแบบโพลีไลน์ |
geoJsonLinestring |
ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString |
RouteLegStep
ประกอบด้วยกลุ่มของ
ขั้นตอนจะสอดคล้องกับวิธีการไปยังส่วนต่างๆ รายการเดียว ขาเส้นทางประกอบขึ้นจากขั้นบันไดRouteLeg
การแสดง JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
ช่อง | |
---|---|
distanceMeters |
ระยะทางในการเดินทางของขั้นตอนนี้ในหน่วยเมตร ในบางกรณี ช่องนี้อาจไม่มีค่า |
staticDuration |
ระยะเวลาเดินทางผ่านขั้นตอนนี้โดยไม่พิจารณาสภาพการจราจร ในบางกรณี ช่องนี้อาจไม่มีค่า ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
polyline |
เส้นประกอบที่เชื่อมโยงกับขั้นตอนนี้ |
startLocation |
ตำแหน่งเริ่มต้นของขั้นตอนนี้ |
endLocation |
ตําแหน่งสุดท้ายของขั้นตอนนี้ |
navigationInstruction |
คำแนะนำการนำทาง |
travelAdvisory |
ประกอบด้วยข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ ในขั้นตอนการดำเนินการ |
localizedValues |
รูปแบบข้อความแสดงพร็อพเพอร์ตี้ของ |
transitDetails |
รายละเอียดเกี่ยวกับขั้นตอนนี้หากรูปแบบการเดินทางคือ |
travelMode |
รูปแบบการเดินทางที่ใช้สำหรับขั้นตอนนี้ |
การบังคับทิศทาง
ชุดของค่าที่ระบุการดำเนินการการนำทางที่จะทำในขั้นตอนปัจจุบัน (เช่น เลี้ยวซ้าย ผสาน หรือเส้นตรง)
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
ไม่ได้ใช้ |
TURN_SLIGHT_LEFT |
เบี่ยงไปทางซ้ายเล็กน้อย |
TURN_SHARP_LEFT |
เลี้ยวซ้ายหักศอก |
UTURN_LEFT |
กลับรถทางซ้าย |
TURN_LEFT |
เลี้ยวซ้าย |
TURN_SLIGHT_RIGHT |
เบี่ยงไปทางขวาเล็กน้อย |
TURN_SHARP_RIGHT |
เลี้ยวขวาหักศอก |
UTURN_RIGHT |
กลับรถทางขวา |
TURN_RIGHT |
เลี้ยวขวา |
STRAIGHT |
ตรงเข้า |
RAMP_LEFT |
ใช้ทางลาดด้านซ้าย |
RAMP_RIGHT |
ใช้ทางลาดด้านขวา |
MERGE |
รวมเป็นการเข้าชม |
FORK_LEFT |
ใช้แยกซ้าย |
FORK_RIGHT |
ใช้แยกขวา |
FERRY |
ขึ้นเรือข้ามฟาก |
FERRY_TRAIN |
ขึ้นรถไฟไปยังเรือข้ามฟาก |
ROUNDABOUT_LEFT |
เลี้ยวซ้ายที่วงเวียน |
ROUNDABOUT_RIGHT |
เลี้ยวขวาที่วงเวียน |
DEPART |
การดำเนินการเริ่มต้น |
NAME_CHANGE |
ใช้เพื่อระบุการเปลี่ยนชื่อถนน |
RouteLegStepTravelAdvisory
มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้ในขั้นตอนการฝึก
การแสดง JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
ช่อง | |
---|---|
speedReadingIntervals[] |
หมายเหตุ: ช่องนี้ไม่มีข้อมูลในขณะนี้ |
RouteLegStepLocalizedValues
การนำเสนอข้อความของคุณสมบัติบางอย่าง
การแสดง JSON |
---|
{ "distance": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางในการเดินทางซึ่งแสดงในรูปแบบข้อความ |
staticDuration |
ระยะเวลาโดยไม่คํานึงถึงสภาพการจราจร โดยแสดงในรูปแบบข้อความ |
RouteLegStepTransitDetails
ข้อมูลเพิ่มเติมสำหรับ RouteLegStep
ที่เกี่ยวข้องกับเส้นทาง TRANSIT
การแสดง JSON |
---|
{ "stopDetails": { object ( |
ช่อง | |
---|---|
stopDetails |
ข้อมูลเกี่ยวกับป้ายจอดรถเมื่อไปถึงและออกเดินทางสำหรับขั้นตอนนั้น |
localizedValues |
รูปแบบข้อความแสดงพร็อพเพอร์ตี้ของ |
headsign |
ระบุเส้นทางที่จะใช้ในการเดินทางตามสายนี้ซึ่งแสดงไว้ในยานพาหนะหรือที่ป้ายจอดรถ โดยทิศทางนั้นมักจะเป็นสถานีปลายทาง |
headway |
ระบุเวลาที่คาดไว้เป็นระยะเวลาระหว่างการออกเดินทางจากป้ายจอดรถเดียวกันในช่วงเวลานั้นๆ ตัวอย่างเช่น หากค่าวินาทีล่วงหน้าเท่ากับ 600 คุณจะต้องรอ 10 นาทีหากพลาดรถประจำทาง ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
transitLine |
ข้อมูลเกี่ยวกับเส้นทางขนส่งสาธารณะที่ใช้ในขั้นตอนนี้ |
stopCount |
จำนวนครั้งที่แวะพัก ตั้งแต่ป้ายจอดรถไปจนถึงป้ายที่จะมาถึง จำนวนนี้รวมป้ายหยุดรถ แต่ไม่รวมป้ายจอดรถ เช่น หากเส้นทางของคุณออกจากป้าย A ผ่านจุดแวะพัก B และ C และมาถึงจุดแวะพัก D จำนวน StopCount จะได้ผลลัพธ์ 3 |
tripShortText |
ข้อความที่ปรากฏในตารางเวลาและป้ายป้ายบอกทางระบุการเดินทางด้วยขนส่งสาธารณะให้แก่ผู้โดยสาร ข้อความควรระบุการเดินทางที่ไม่ซ้ำกันภายในวันให้บริการ ตัวอย่างเช่น "538" คือ |
TransitStopDetails
รายละเอียดเกี่ยวกับป้ายจอดรถของRouteLegStep
การแสดง JSON |
---|
{ "arrivalStop": { object ( |
ช่อง | |
---|---|
arrivalStop |
ข้อมูลเกี่ยวกับป้ายจอดรถเมื่อมาถึงขั้นตอน |
arrivalTime |
เวลาถึงโดยประมาณของขั้นตอน การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
departureStop |
ข้อมูลเกี่ยวกับป้ายจอดรถขาออกสำหรับขั้นตอน |
departureTime |
เวลาออกเดินทางโดยประมาณของขั้นตอน การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
TransitStop
ข้อมูลเกี่ยวกับป้ายจอดรถ
การแสดง JSON |
---|
{
"name": string,
"location": {
object ( |
ช่อง | |
---|---|
name |
ชื่อของป้ายจอดรถ |
location |
ตำแหน่งของป้ายจอดรถที่แสดงในพิกัดละติจูด/ลองจิจูด |
TransitDetailsLocalizedValues
คำอธิบายที่แปลแล้วของค่าสำหรับ RouteTransitDetails
การแสดง JSON |
---|
{ "arrivalTime": { object ( |
ช่อง | |
---|---|
arrivalTime |
เวลาในการนำเสนอข้อความที่มีการจัดรูปแบบพร้อมเขตเวลาที่สอดคล้องกัน |
departureTime |
เวลาในการนำเสนอข้อความที่มีการจัดรูปแบบพร้อมเขตเวลาที่สอดคล้องกัน |
LocalizedTime
คำอธิบายเวลาที่แปลแล้ว
การแสดง JSON |
---|
{
"time": {
object ( |
ช่อง | |
---|---|
time |
เวลาที่ระบุเป็นสตริงในเขตเวลาที่ระบุ |
timeZone |
มีเขตเวลา ค่านี้คือชื่อของเขตเวลาตามที่ระบุไว้ในฐานข้อมูลเขตเวลา IANA เช่น "America/New_York" |
TransitLine
มีข้อมูลเกี่ยวกับเส้นทางขนส่งสาธารณะที่ใช้ในขั้นตอนนี้
การแสดง JSON |
---|
{ "agencies": [ { object ( |
ช่อง | |
---|---|
agencies[] |
บริษัทขนส่ง (หรือตัวแทน) ที่ดำเนินการเส้นทางขนส่งสาธารณะนี้ |
name |
ชื่อเต็มของเส้นทางขนส่งสาธารณะนี้ เช่น "8 Avenue Local" |
uri |
URI สำหรับเส้นทางขนส่งสาธารณะนี้ตามที่บริษัทขนส่งระบุไว้ |
color |
สีที่ใช้กันโดยทั่วไปในป้ายของเส้นนี้ ซึ่งแสดงเป็นเลขฐานสิบหก |
iconUri |
URI สำหรับไอคอนที่เชื่อมโยงกับเส้นนี้ |
nameShort |
ชื่อย่อของเส้นทางขนส่งสาธารณะนี้ ปกติแล้วชื่อนี้จะเป็นหมายเลขบรรทัด เช่น "M7" หรือ "355" |
textColor |
สีที่ใช้กันโดยทั่วไปในข้อความบนป้ายสำหรับบรรทัดนี้ ซึ่งแสดงเป็นเลขฐานสิบหก |
vehicle |
ประเภทของยานพาหนะที่ทำงานในเส้นทางขนส่งสาธารณะนี้ |
TransitAgency
บริษัทขนส่งที่ดำเนินการเส้นทางขนส่งสาธารณะ
การแสดง JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
ช่อง | |
---|---|
name |
ชื่อของบริษัทขนส่งนี้ |
phoneNumber |
หมายเลขโทรศัพท์ที่จัดรูปแบบตามท้องถิ่นของบริษัทขนส่ง |
uri |
URI ของบริษัทขนส่ง |
TransitVehicle
ข้อมูลเกี่ยวกับยานพาหนะที่ใช้ในเส้นทางขนส่งสาธารณะ
การแสดง JSON |
---|
{ "name": { object ( |
ช่อง | |
---|---|
name |
ชื่อของยานพาหนะคันนี้ อักษรตัวพิมพ์ใหญ่ |
type |
ประเภทยานพาหนะที่ใช้ |
iconUri |
URI สำหรับไอคอนที่เชื่อมโยงกับยานพาหนะประเภทนี้ |
localIconUri |
URI สำหรับไอคอนที่เชื่อมโยงกับยานพาหนะประเภทนี้ โดยอิงตามป้ายการขนส่งในท้องถิ่น |
TransitVehicleType
ประเภทของยานพาหนะสำหรับเส้นทางขนส่งสาธารณะ
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
ไม่ได้ใช้ |
BUS |
รถประจำทาง |
CABLE_CAR |
ยานพาหนะที่ใช้สายเคเบิล ซึ่งโดยปกติอยู่บนพื้นดิน กระเช้าลอยฟ้าอาจเป็นประเภท GONDOLA_LIFT |
COMMUTER_TRAIN |
รถไฟโดยสาร |
FERRY |
เรือข้ามฟาก |
FUNICULAR |
ยานพาหนะที่ดึงขึ้นจากทางลาดชันโดยใช้สายเคเบิล โดยทั่วไปรถรางจะประกอบด้วยรถยนต์ 2 คัน โดยรถแต่ละคันจะทำหน้าที่เป็นตัวถ่วงน้ำหนักของรถอีกคันหนึ่ง |
GONDOLA_LIFT |
กระเช้าลอยฟ้า |
HEAVY_RAIL |
รถไฟหนัก |
HIGH_SPEED_TRAIN |
รถไฟความเร็วสูง |
INTERCITY_BUS |
รถโดยสารระหว่างเมือง |
LONG_DISTANCE_TRAIN |
รถไฟทางไกล |
METRO_RAIL |
การเดินทางด้วยรถไฟฟ้ารางเบา |
MONORAIL |
รถไฟรางเดี่ยว |
OTHER |
ยานพาหนะอื่นๆ ทั้งหมด |
RAIL |
รถไฟ |
SHARE_TAXI |
แท็กซี่โดยสารร่วม คือรถประจำทางประเภทหนึ่งที่มีความสามารถในการส่งคืนและรับผู้โดยสารได้จากทุกที่บนเส้นทาง |
SUBWAY |
รถไฟฟ้ารางเบาใต้ดิน |
TRAM |
รถไฟฟ้ารางเบาเหนือพื้น |
TROLLEYBUS |
รถรางไฟฟ้า |
RouteLegTravelAdvisory
มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบในขั้นตอนการดำเนินการ เช่น การจำกัดโซนการเข้าชมที่เป็นไปได้
การแสดง JSON |
---|
{ "tollInfo": { object ( |
ช่อง | |
---|---|
tollInfo |
มีข้อมูลเกี่ยวกับค่าผ่านทางใน |
speedReadingIntervals[] |
ช่วงการอ่านความเร็วซึ่งแสดงรายละเอียดความหนาแน่นของการจราจร ใช้ได้ในกรณีของค่ากำหนดการกำหนดเส้นทาง ตัวอย่าง
|
RouteLegLocalizedValues
การนำเสนอข้อความของคุณสมบัติบางอย่าง
การแสดง JSON |
---|
{ "distance": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางในการเดินทางซึ่งแสดงในรูปแบบข้อความ |
duration |
ระยะเวลาที่พิจารณาสภาพการจราจรซึ่งแสดงในรูปแบบข้อความ หมายเหตุ: หากคุณไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเป็นค่าเดียวกับ staticDuration |
staticDuration |
ระยะเวลาโดยไม่คํานึงถึงสภาพการจราจร โดยแสดงในรูปแบบข้อความ |
StepsOverview
ให้ข้อมูลภาพรวมเกี่ยวกับรายการ RouteLegStep
การแสดง JSON |
---|
{
"multiModalSegments": [
{
object ( |
ช่อง | |
---|---|
multiModalSegments[] |
สรุปเกี่ยวกับกลุ่มหลายรูปแบบของ |
MultiModalSegment
ให้ข้อมูลสรุปเกี่ยวกับกลุ่มหลายรูปแบบของ RouteLeg.steps
กลุ่มแบบหลายโมดัลหมายถึง RouteLegStep
ที่ต่อเนื่องกันอย่างน้อย 1 กลุ่มที่มี RouteTravelMode
เดียวกัน ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg
ไม่มีกลุ่มหลายโมดัลในขั้นตอนต่างๆ
การแสดง JSON |
---|
{ "navigationInstruction": { object ( |
ช่อง | |
---|---|
navigationInstruction |
NavigationInstruction สำหรับกลุ่มแบบหลายโมดัล |
travelMode |
รูปแบบการเดินทางของกลุ่มโมดัลหลายรูปแบบ |
stepStartIndex |
ดัชนี |
stepEndIndex |
ดัชนี |
วิวพอร์ต
วิวพอร์ตละติจูด-ลองจิจูด ซึ่งแสดงเป็นแนวทแยงมุม 2 จุดตรงข้ามกับจุด low
และจุด high
วิวพอร์ตถือเป็นพื้นที่แบบปิด กล่าวคือ รวมขอบเขตของวิวพอร์ตไว้ด้วย ขอบเขตละติจูดต้องอยู่ในช่วง -90 ถึง 90 องศา และขอบเขตลองจิจูดต้องอยู่ในช่วง -180 ถึง 180 องศา กรณีต่างๆ ได้แก่
หาก
low
=high
วิวพอร์ตจะประกอบด้วยจุดเดียวนั้นหาก
low.longitude
>high.longitude
ช่วงลองจิจูดจะกลับกัน (วิวพอร์ตข้ามเส้นลองจิจูด 180 องศา)หาก
low.longitude
= -180 องศาและhigh.longitude
= 180 องศา วิวพอร์ตจะรวมลองจิจูดทั้งหมดหาก
low.longitude
= 180 องศาและhigh.longitude
= -180 องศา ช่วงลองจิจูดจะว่างเปล่าหากเป็น
low.latitude
>high.latitude
ช่วงละติจูดจะว่างเปล่า
ต้องระบุทั้ง low
และ high
และช่องแทนต้องไม่ว่างเปล่า (ตามที่ระบุด้วยคำจำกัดความด้านบน) การมีวิวพอร์ตที่ว่างเปล่าจะทำให้เกิดข้อผิดพลาด
ตัวอย่างเช่น วิวพอร์ตนี้รวมนครนิวยอร์กทั้งหมดดังนี้
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
การแสดง JSON |
---|
{ "low": { object ( |
ช่อง | |
---|---|
low |
ต้องระบุ จุดต่ำของวิวพอร์ต |
high |
ต้องระบุ จุดสูงของวิวพอร์ต |
RouteLocalizedValues
การนำเสนอข้อความของคุณสมบัติบางอย่าง
การแสดง JSON |
---|
{ "distance": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางในการเดินทางซึ่งแสดงในรูปแบบข้อความ |
duration |
ระยะเวลาพิจารณาสภาพการจราจร โดยแสดงในรูปแบบข้อความ หมายเหตุ: หากคุณไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเป็นค่าเดียวกับ |
staticDuration |
ระยะเวลาโดยไม่คํานึงถึงสภาพการจราจร โดยแสดงในรูปแบบข้อความ |
transitFare |
ค่าโดยสารจะแสดงในรูปแบบข้อความ |
GeocodingResults
มี
สำหรับจุดอ้างอิงต้นทาง จุดหมาย และระดับกลาง จะมีการป้อนข้อมูลสำหรับจุดอ้างอิงตามจุดอ้างอิงเท่านั้นGeocodedWaypoints
การแสดง JSON |
---|
{ "origin": { object ( |
ช่อง | |
---|---|
origin |
จุดอ้างอิงต้นทางที่ระบุพิกัดภูมิศาสตร์ |
destination |
จุดอ้างอิงที่ระบุพิกัดภูมิศาสตร์ปลายทาง |
intermediates[] |
รายการจุดอ้างอิงที่ระบุพิกัดภูมิศาสตร์ระดับกลาง แต่ละจุดซึ่งมีฟิลด์ดัชนีที่ตรงกับตำแหน่งบนจุดฐาน 0 ของจุดอ้างอิงตามลำดับที่ระบุไว้ในคำขอ |
GeocodedWaypoint
รายละเอียดเกี่ยวกับสถานที่ที่ใช้เป็นจุดอ้างอิง จะมีการป้อนข้อมูลสำหรับจุดอ้างอิงตามจุดอ้างอิงเท่านั้น รวมถึงรายละเอียดเกี่ยวกับผลการระบุพิกัดทางภูมิศาสตร์เพื่อวัตถุประสงค์ในการระบุว่าที่อยู่ถูกระบุพิกัดทางภูมิศาสตร์ไว้ใด
การแสดง JSON |
---|
{
"geocoderStatus": {
object ( |
ช่อง | |
---|---|
geocoderStatus |
ระบุรหัสสถานะที่เกิดจากการดำเนินการเข้ารหัสพิกัดภูมิศาสตร์ |
type[] |
ประเภทของผลลัพธ์ในรูปแบบของแท็กประเภทศูนย์รายการหรือมากกว่า ประเภทที่รองรับ: ประเภทที่อยู่และประเภทคอมโพเนนต์ที่อยู่ |
partialMatch |
ระบุว่าโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ไม่ได้แสดงการจับคู่ที่ตรงกันทุกประการกับคำขอเดิม แม้ว่าจะสามารถจับคู่บางส่วนของที่อยู่ที่ขอได้ คุณอาจต้องตรวจสอบคําขอเดิมว่ามีการสะกดผิดและ/หรือที่อยู่ที่ไม่สมบูรณ์ |
placeId |
รหัสสถานที่สำหรับผลการค้นหานี้ |
intermediateWaypointRequestIndex |
ดัชนีของจุดอ้างอิงระดับกลางที่เกี่ยวข้องในคำขอ จะแสดงเมื่อจุดอ้างอิงที่เกี่ยวข้องเป็นจุดอ้างอิงระดับกลางเท่านั้น |