- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Viewport
- 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 จุด |
travel |
ไม่บังคับ ระบุรูปแบบการเดินทาง |
routing |
ไม่บังคับ ระบุวิธีคํานวณเส้นทาง เซิร์ฟเวอร์พยายามใช้ค่ากำหนดการกำหนดเส้นทางที่เลือกเพื่อคํานวณเส้นทาง หากค่ากำหนดการกำหนดเส้นทางส่งผลให้เกิดข้อผิดพลาดหรือเวลาในการตอบสนองนานเกินไป ระบบจะแสดงข้อผิดพลาด คุณจะระบุตัวเลือกนี้ได้ก็ต่อเมื่อ |
polyline |
ไม่บังคับ ระบุค่ากําหนดสำหรับคุณภาพของเส้นประกอบ |
polyline |
ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับเส้นประกอบ |
departure |
ไม่บังคับ เวลาออกเดินทาง หากไม่ได้ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่ส่งคำขอ หมายเหตุ: คุณจะระบุ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
arrival |
ไม่บังคับ เวลาถึง หมายเหตุ: ตั้งค่าได้เมื่อตั้งค่า การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
compute |
ไม่บังคับ ระบุว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางหรือไม่ ระบบจะไม่แสดงเส้นทางอื่นสำหรับคำขอที่มีจุดแวะพักกลางทาง |
route |
ไม่บังคับ ชุดเงื่อนไขที่ต้องเป็นไปตามที่ส่งผลต่อวิธีคำนวณเส้นทาง |
language |
ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตัวระบุภาษา Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากคุณไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากสถานที่ตั้งของคำขอเส้นทาง |
region |
ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ |
units |
ไม่บังคับ ระบุหน่วยวัดสำหรับช่องแสดงผล ช่องเหล่านี้รวมถึงช่อง |
optimize |
ไม่บังคับ หากตั้งค่าเป็น "จริง" บริการจะพยายามลดต้นทุนโดยรวมของเส้นทางโดยจัดลำดับจุดแวะพักกลางที่ระบุใหม่ คำขอจะดำเนินการไม่สำเร็จหากจุดแวะพักระหว่างทางเป็นจุดแวะพัก |
requested |
ไม่บังคับ ระบุเส้นทางอ้างอิงที่จะคำนวณเป็นส่วนหนึ่งของคำขอนอกเหนือจากเส้นทางเริ่มต้น เส้นทางอ้างอิงคือเส้นทางที่มีวัตถุประสงค์ในการคํานวณเส้นทางแตกต่างจากเส้นทางเริ่มต้น เช่น |
extra |
ไม่บังคับ รายการการคํานวณเพิ่มเติมที่อาจใช้เพื่อดําเนินการตามคําขอ หมายเหตุ: การคํานวณเพิ่มเติมเหล่านี้อาจแสดงผลลัพธ์ในช่องเพิ่มเติมในการตอบกลับ นอกจากนี้ คุณต้องระบุฟิลด์เพิ่มเติมเหล่านี้ในฟิลด์มาสก์เพื่อให้ระบบแสดงผลในคำตอบด้วย |
traffic |
ไม่บังคับ ระบุสมมติฐานที่จะใช้เมื่อคํานวณเวลาในการเข้าชม การตั้งค่านี้มีผลต่อค่าที่แสดงในช่องระยะเวลาใน |
transit |
ไม่บังคับ ระบุค่ากําหนดที่ส่งผลต่อเส้นทางที่แสดงสําหรับเส้นทาง |
เนื้อหาการตอบกลับ
v2.computeRoutes ข้อความตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "routes": [ { object ( |
ช่อง | |
---|---|
routes[] |
มีอาร์เรย์ของเส้นทางที่คำนวณแล้ว (สูงสุด 3 เส้นทาง) เมื่อคุณระบุ |
fallback |
ในบางกรณีเมื่อเซิร์ฟเวอร์ไม่สามารถคํานวณผลลัพธ์เส้นทางด้วยค่ากําหนดอินพุตทั้งหมดได้ ระบบอาจเปลี่ยนไปใช้วิธีคํานวณอื่น เมื่อใช้โหมดสำรอง ช่องนี้จะมีข้อมูลโดยละเอียดเกี่ยวกับการตอบกลับสำรอง มิฉะนั้น ระบบจะไม่ตั้งค่าช่องนี้ |
geocoding |
มีข้อมูลการตอบกลับการแปลงพิกัดภูมิศาสตร์สําหรับจุดแวะพักที่ระบุเป็นที่อยู่ |
PolylineQuality
ชุดค่าที่ระบุคุณภาพของเส้นประกอบ
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
ไม่ได้ระบุค่ากำหนดคุณภาพของเส้นประกอบ ค่าเริ่มต้นคือ OVERVIEW |
HIGH_QUALITY |
ระบุเส้นประกอบคุณภาพสูง ซึ่งประกอบด้วยจุดมากกว่า OVERVIEW แต่จะทำให้ขนาดคำตอบเพิ่มขึ้น ใช้ค่านี้เมื่อต้องการความแม่นยำมากขึ้น |
OVERVIEW |
ระบุเส้นประกอบภาพรวม ซึ่งประกอบด้วยจุดจำนวนน้อย ใช้ค่านี้เมื่อแสดงภาพรวมของเส้นทาง การใช้ตัวเลือกนี้จะทำให้เวลาในการตอบสนองของคำขอต่ำลงเมื่อเทียบกับการใช้ตัวเลือก HIGH_QUALITY |
PolylineEncoding
ระบุประเภทของเส้นประกอบที่ต้องการให้แสดงผล
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
ไม่ได้ระบุค่ากําหนดประเภทเส้นประกอบ ค่าเริ่มต้นคือ ENCODED_POLYLINE |
ENCODED_POLYLINE |
ระบุเส้นประกอบที่เข้ารหัสโดยใช้อัลกอริทึมการเข้ารหัสเส้นประกอบ |
GEO_JSON_LINESTRING |
ระบุเส้นประกอบโดยใช้รูปแบบ LineString ของ GeoJSON |
ReferenceRoute
เส้นทางอ้างอิงที่รองรับใน ComputeRoutesRequest
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
ไม่ใช้ คำขอที่มีค่านี้จะดำเนินการไม่สำเร็จ |
FUEL_EFFICIENT |
เส้นทางที่ประหยัดเชื้อเพลิง |
SHORTER_DISTANCE |
เส้นทางที่มีระยะทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้ สำหรับคำขอ สำหรับคำขอ ฟีเจอร์นี้ใช้งานไม่ได้กับโหมดการเดินทางอื่นๆ ผ่านจุดแวะพักกลางทาง หรือ |
ExtraComputation
การคํานวณเพิ่มเติมที่จะทําขณะดําเนินการตามคําขอ
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
ไม่ใช้ คำขอที่มีค่านี้จะดำเนินการไม่สำเร็จ |
TOLLS |
ข้อมูลค่าผ่านทางของเส้นทาง |
FUEL_CONSUMPTION |
การบริโภคเชื้อเพลิงโดยประมาณของเส้นทาง |
TRAFFIC_ON_POLYLINE |
เส้นประกอบที่คำนึงถึงการจราจรสำหรับเส้นทาง |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions ที่แสดงเป็นสตริงข้อความ HTML ที่มีการจัดรูปแบบ เนื้อหานี้มีไว้เพื่ออ่านตามที่เป็นอยู่ เนื้อหานี้มีไว้เพื่อแสดงเท่านั้น อย่าแยกวิเคราะห์โดยใช้โปรแกรม |
เส้นทาง
มีเส้นทางซึ่งประกอบด้วยชุดส่วนของถนนที่เชื่อมต่อกันซึ่งเชื่อมต่อจุดเริ่มต้น จุดสิ้นสุด และจุดแวะพักกลางทาง
การแสดง JSON |
---|
{ "routeLabels": [ enum ( |
ช่อง | |
---|---|
route |
ป้ายกํากับสําหรับ |
legs[] |
ชุดของช่วง (ส่วนของเส้นทางระหว่างจุดแวะพัก) ที่เป็นเส้นทาง แต่ละเที่ยวจะสอดคล้องกับการเดินทางระหว่าง |
distance |
ระยะทางของเส้นทางเป็นเมตร |
duration |
ระยะเวลาที่ใช้ในการไปยังจุดหมาย หากคุณตั้งค่า ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
static |
ระยะเวลาการเดินทางผ่านเส้นทางโดยไม่คำนึงถึงสภาพการจราจร ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
polyline |
เส้นประกอบของเส้นทางโดยรวม เส้นประกอบนี้เป็นเส้นประกอบที่รวม |
description |
คำอธิบายเส้นทาง |
warnings[] |
อาร์เรย์คำเตือนที่จะแสดงเมื่อแสดงเส้นทาง |
viewport |
กรอบขอบเขตวิวพอร์ตของเส้นประกอบ |
travel |
ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง |
optimized |
หากคุณตั้งค่า |
localized |
การนําเสนอข้อความของพร็อพเพอร์ตี้ |
route |
โทเค็นแบบทึบที่สามารถส่งไปยัง Navigation SDK เพื่อสร้างเส้นทางใหม่ในระหว่างการนําทาง และในกรณีที่มีการเปลี่ยนเส้นทาง ให้ยึดตามเจตนาเดิมเมื่อสร้างเส้นทาง ถือว่าโทเค็นนี้เป็น Blob แบบทึบ อย่าเปรียบเทียบค่าของเส้นทางนี้ในคำขอต่างๆ เนื่องจากค่าอาจเปลี่ยนแปลงได้แม้ว่าบริการจะแสดงผลเส้นทางเดียวกันทุกประการก็ตาม หมายเหตุ: |
RouteLabel
ป้ายกํากับสําหรับ
ที่มีประโยชน์ในการระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจงของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นๆRoute
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
ค่าเริ่มต้น - ไม่ได้ใช้ |
DEFAULT_ROUTE |
เส้นทาง "ที่ดีที่สุด" เริ่มต้นที่แสดงผลสําหรับการคํานวณเส้นทาง |
DEFAULT_ROUTE_ALTERNATE |
เส้นทางทางเลือกสำหรับเส้นทาง "ที่ดีที่สุด" เริ่มต้น ระบบจะแสดงเส้นทางลักษณะนี้เมื่อระบุ
|
FUEL_EFFICIENT |
เส้นทางที่ประหยัดเชื้อเพลิง ระบบจะกำหนดเส้นทางที่ติดป้ายกำกับด้วยค่านี้ให้เพิ่มประสิทธิภาพสำหรับพารามิเตอร์เชิงอนุรักษ์ เช่น การบริโภคเชื้อเพลิง |
SHORTER_DISTANCE |
เส้นทางที่เดินทางได้ระยะทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้ |
RouteLeg
มีส่วนของจุดแวะพักที่ไม่ใช่via
การแสดง JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางที่เดินทางของส่วนของเส้นทางเป็นเมตร |
duration |
ระยะเวลาที่ใช้ในการไปยังจุดหมาย หากตั้งค่า ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
static |
ระยะเวลาการเดินทางผ่านเส้นทาง ซึ่งคำนวณโดยไม่คำนึงถึงสภาพการจราจร ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
polyline |
เส้นประกอบโดยรวมของช่วงนี้ซึ่งมีเส้นประกอบของ |
start |
สถานที่เริ่มต้นของช่วงนี้ ตำแหน่งนี้อาจแตกต่างจาก |
end |
สถานที่สิ้นสุดของช่วงนี้ ตำแหน่งนี้อาจแตกต่างจาก |
steps[] |
อาร์เรย์ของขั้นตอนที่ระบุส่วนของเส้นทางนี้ แต่ละขั้นตอนแสดงวิธีการไปยังส่วนต่างๆ 1 รายการ |
travel |
มีข้อมูลเพิ่มเติมที่ควรแจ้งให้ผู้ใช้ทราบ เช่น ข้อจำกัดของโซนจราจรที่อาจเกิดขึ้นในเส้นทาง |
localized |
การนําเสนอข้อความของพร็อพเพอร์ตี้ |
steps |
ข้อมูลภาพรวมเกี่ยวกับขั้นตอนใน |
เส้นประกอบ
บรรจุเส้นประกอบที่เข้ารหัส
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ polyline_type บรรจุประเภทของเส้นประกอบ ค่าเริ่มต้นคือ encoded_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
encoded |
การเข้ารหัสสตริงของเส้นประกอบโดยใช้อัลกอริทึมการเข้ารหัสเส้นประกอบ |
geo |
ระบุเส้นประกอบโดยใช้รูปแบบ LineString ของ GeoJSON |
RouteLegStep
มีส่วนของ
ขั้นตอนหนึ่งๆ สอดคล้องกับวิธีการไปยังส่วนต่างๆ รายการเดียว ส่วนของเส้นทางประกอบด้วยขั้นตอนต่างๆRouteLeg
การแสดง JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางที่เดินทางของขั้นตอนนี้ เป็นหน่วยเมตร ในบางกรณี ช่องนี้อาจไม่มีค่า |
static |
ระยะเวลาการเดินทางผ่านขั้นตอนนี้โดยไม่คำนึงถึงสภาพการจราจร ในบางสถานการณ์ ช่องนี้อาจไม่มีค่า ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
polyline |
เส้นประกอบที่เชื่อมโยงกับขั้นตอนนี้ |
start |
ตำแหน่งเริ่มต้นของขั้นตอนนี้ |
end |
ตำแหน่งสิ้นสุดของขั้นตอนนี้ |
navigation |
คำแนะนำการนำทาง |
travel |
มีข้อมูลเพิ่มเติมที่ควรแจ้งให้ผู้ใช้ทราบ เช่น ข้อจำกัดของโซนจราจรที่อาจเกิดขึ้น ในขั้นตอนของช่วง |
localized |
การนําเสนอข้อความของพร็อพเพอร์ตี้ |
transit |
รายละเอียดที่เกี่ยวข้องกับขั้นตอนนี้หากโหมดการเดินทางคือ |
travel |
โหมดการเดินทางที่ใช้สำหรับขั้นตอนนี้ |
การเคลื่อนไหว
ชุดค่าที่กำหนดการดำเนินการนำทางที่จะทำในขั้นตอนปัจจุบัน (เช่น เลี้ยวซ้าย ผสาน หรือตรงไป)
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 ( |
ช่อง | |
---|---|
speed |
หมายเหตุ: ช่องนี้ไม่มีข้อมูลในขณะนี้ |
RouteLegStepLocalizedValues
การนําเสนอข้อความของพร็อพเพอร์ตี้บางอย่าง
การแสดง JSON |
---|
{ "distance": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางที่เดินทางซึ่งแสดงในรูปแบบข้อความ |
static |
ระยะเวลาที่ไม่พิจารณาสภาพการเข้าชม ซึ่งแสดงในรูปแบบข้อความ |
RouteLegStepTransitDetails
ข้อมูลเพิ่มเติมสำหรับ RouteLegStep
ที่เกี่ยวข้องกับเส้นทาง TRANSIT
การแสดง JSON |
---|
{ "stopDetails": { object ( |
ช่อง | |
---|---|
stop |
ข้อมูลเกี่ยวกับป้ายจอดรถขาเข้าและขาออกของขั้นตอน |
localized |
การนําเสนอข้อความของพร็อพเพอร์ตี้ |
headsign |
ระบุทิศทางการเดินทางบนสายนี้ตามที่ระบุไว้บนยานพาหนะหรือที่ป้ายจอดรถ โดยมักเป็นสถานีปลายทาง |
headway |
ระบุเวลาโดยประมาณเป็นระยะเวลาระหว่างการออกเดินทางจากป้ายจอดรถเดียวกันในเวลานี้ เช่น เมื่อค่าความถี่ของรถเป็น 600 วินาที คุณจะต้องรอรถนาน 10 นาทีหากพลาดรถเมล์ ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
transit |
ข้อมูลเกี่ยวกับสายขนส่งสาธารณะที่ใช้ในขั้นตอนนี้ |
stop |
จำนวนป้ายจอดรถจากจุดต้นทางถึงจุดหมาย จำนวนนี้รวมป้ายจอดรถปลายทางแต่ไม่รวมป้ายจอดรถต้นทาง ตัวอย่างเช่น หากเส้นทางของคุณออกเดินทางจากป้ายจอดรถ A ผ่านป้ายจอดรถ B และ C และมาถึงป้ายจอดรถ D
แสดงผลลัพธ์ 3 |
trip |
ข้อความที่ปรากฏในตารางเวลาและป้ายบอกทางเพื่อระบุการเดินทางด้วยระบบขนส่งสาธารณะแก่ผู้โดยสาร ข้อความควรระบุการเดินทางภายในวันทำการหนึ่งๆ โดยไม่ซ้ำกัน เช่น "538" คือ |
TransitStopDetails
รายละเอียดเกี่ยวกับป้ายจอดรถประจำทางของ RouteLegStep
การแสดง JSON |
---|
{ "arrivalStop": { object ( |
ช่อง | |
---|---|
arrival |
ข้อมูลเกี่ยวกับป้ายจอดรถของจุดจอด |
arrival |
เวลาถึงโดยประมาณของขั้นตอน การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
departure |
ข้อมูลเกี่ยวกับป้ายจอดรถต้นทางของขั้นตอน |
departure |
เวลาออกเดินทางโดยประมาณของขั้นตอน การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น |
TransitStop
ข้อมูลเกี่ยวกับป้ายจอดรถประจำทาง
การแสดง JSON |
---|
{
"name": string,
"location": {
object ( |
ช่อง | |
---|---|
name |
ชื่อป้ายจอดรถ |
location |
ตำแหน่งของป้ายจอดรถที่แสดงเป็นพิกัดละติจูด/ลองจิจูด |
TransitDetailsLocalizedValues
คำอธิบายที่แปลแล้วสำหรับค่าของ RouteTransitDetails
การแสดง JSON |
---|
{ "arrivalTime": { object ( |
ช่อง | |
---|---|
arrival |
เวลาในการแสดงข้อความที่จัดรูปแบบแล้วพร้อมเขตเวลาที่สอดคล้องกัน |
departure |
เวลาในการแสดงข้อความที่จัดรูปแบบแล้วพร้อมเขตเวลาที่สอดคล้องกัน |
LocalizedTime
คำอธิบายเวลาที่แปลแล้ว
การแสดง JSON |
---|
{
"time": {
object ( |
ช่อง | |
---|---|
time |
เวลาที่ระบุเป็นสตริงในเขตเวลาหนึ่งๆ |
time |
มีเขตเวลา ค่าคือชื่อเขตเวลาตามที่ระบุไว้ในฐานข้อมูลเขตเวลาของ IANA เช่น "America/New_York" |
TransitLine
มีข้อมูลเกี่ยวกับสายขนส่งสาธารณะที่ใช้ในขั้นตอนนี้
การแสดง JSON |
---|
{ "agencies": [ { object ( |
ช่อง | |
---|---|
agencies[] |
บริษัทขนส่ง (หรือบริษัท) ที่ดำเนินการสายขนส่งสาธารณะนี้ |
name |
ชื่อเต็มของเส้นทางขนส่งสาธารณะ เช่น "8 Avenue Local" |
uri |
URI สำหรับเส้นทางขนส่งสาธารณะนี้ตามที่บริษัทขนส่งระบุ |
color |
สีที่ใช้กันโดยทั่วไปในป้ายบอกทางสำหรับสายนี้ แสดงเป็นเลขฐานสิบหก |
icon |
URI ของไอคอนที่เชื่อมโยงกับบรรทัดนี้ |
name |
ชื่อย่อของสายขนส่งสาธารณะนี้ โดยปกติแล้วชื่อนี้จะเป็นตัวเลขที่แสดงถึงหมายเลขบรรทัด เช่น "M7" หรือ "355" |
text |
สีที่ใช้กันโดยทั่วไปในข้อความบนป้ายของสายนี้ แสดงเป็นเลขฐานสิบหก |
vehicle |
ประเภทยานพาหนะที่ให้บริการในเส้นทางขนส่งสาธารณะนี้ |
TransitAgency
บริษัทขนส่งที่ดำเนินการเส้นทางขนส่งสาธารณะ
การแสดง JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
ช่อง | |
---|---|
name |
ชื่อบริษัทขนส่งนี้ |
phone |
หมายเลขโทรศัพท์ที่จัดรูปแบบตามภาษาท้องถิ่นของผู้ให้บริการขนส่งสาธารณะ |
uri |
URI ของบริษัทขนส่ง |
TransitVehicle
ข้อมูลเกี่ยวกับยานพาหนะที่ใช้ในเส้นทางขนส่งสาธารณะ
การแสดง JSON |
---|
{ "name": { object ( |
ช่อง | |
---|---|
name |
ชื่อของยานพาหนะนี้เป็นตัวพิมพ์ใหญ่ |
type |
ประเภทยานพาหนะที่ใช้งาน |
icon |
URI ของไอคอนที่เชื่อมโยงกับประเภทยานพาหนะนี้ |
local |
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 ( |
ช่อง | |
---|---|
toll |
มีข้อมูลเกี่ยวกับค่าผ่านทางใน |
speed |
ช่วงเวลาการอ่านความเร็วที่แสดงรายละเอียดความหนาแน่นของการเข้าชม ใช้ในกรณีที่มีการกำหนดค่าการกำหนดเส้นทาง ตัวอย่าง
|
RouteLegLocalizedValues
การนําเสนอข้อความของพร็อพเพอร์ตี้บางอย่าง
การแสดง JSON |
---|
{ "distance": { object ( |
ช่อง | |
---|---|
distance |
ระยะทางที่เดินทางซึ่งแสดงในรูปแบบข้อความ |
duration |
ระยะเวลาที่แสดงในรูปแบบข้อความและแปลเป็นภาษาท้องถิ่นของภูมิภาคการค้นหา คำนึงถึงสภาพการจราจร หมายเหตุ: หากคุณไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเหมือนกับ staticDuration |
static |
ระยะเวลาที่ไม่พิจารณาสภาพการเข้าชม ซึ่งแสดงในรูปแบบข้อความ |
StepsOverview
ให้ข้อมูลภาพรวมเกี่ยวกับรายการ RouteLegStep
การแสดง JSON |
---|
{
"multiModalSegments": [
{
object ( |
ช่อง | |
---|---|
multi |
ข้อมูลสรุปเกี่ยวกับกลุ่มสื่อหลายรูปแบบต่างๆ ของ |
MultiModalSegment
ให้ข้อมูลสรุปเกี่ยวกับกลุ่มแบบมัลติโมดัลต่างๆ ของ RouteLeg.steps
ส่วนที่เป็นหลายรูปแบบหมายถึง RouteLegStep
ที่อยู่ติดกันอย่างน้อย 1 รายการที่มี RouteTravelMode
เดียวกัน ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg
ไม่มีกลุ่มสื่อหลายรูปแบบในขั้นตอน
การแสดง JSON |
---|
{ "navigationInstruction": { object ( |
ช่อง | |
---|---|
navigation |
NavigationInstruction สำหรับกลุ่มสื่อหลายประเภท |
travel |
โหมดการเดินทางของกลุ่มการเดินทางแบบหลายรูปแบบ |
step |
ดัชนี |
step |
ดัชนี |
วิวพอร์ต
วิวพอร์ตละติจูด-ลองจิจูดที่แสดงเป็นจุด low
และ high
2 จุดที่ตรงข้ามกันตามแนวทแยงมุม วิวพอร์ตถือเป็นภูมิภาคแบบปิด กล่าวคือ วิวพอร์ตจะมีขอบเขตของตัวเอง ขอบเขตละติจูดต้องอยู่ในช่วง -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 |
ระยะเวลาที่แสดงในรูปแบบข้อความและแปลเป็นภาษาท้องถิ่นของภูมิภาคการค้นหา คำนึงถึงสภาพการจราจร หมายเหตุ: หากคุณไม่ได้ขอข้อมูลการเข้าชม ค่านี้จะเหมือนกับ |
static |
ระยะเวลาที่ไม่พิจารณาสภาพการเข้าชม ซึ่งแสดงในรูปแบบข้อความ |
transit |
ค่าโดยสารขนส่งสาธารณะที่แสดงในรูปแบบข้อความ |
GeocodingResults
มี
สำหรับจุดเริ่มต้น จุดหมาย และจุดแวะพักกลางทาง มีการป้อนข้อมูลสำหรับจุดแวะพักของที่อยู่เท่านั้นGeocodedWaypoints
การแสดง JSON |
---|
{ "origin": { object ( |
ช่อง | |
---|---|
origin |
จุดแวะพักที่ผ่านการเข้ารหัสพิกัดภูมิศาสตร์ของต้นทาง |
destination |
จุดสังเกตปลายทางที่ผ่านการเข้ารหัสพิกัดภูมิศาสตร์ |
intermediates[] |
รายการจุดแวะพักที่กําหนดพิกัดภูมิศาสตร์กลางแต่ละรายการจะมีช่องดัชนีที่สอดคล้องกับตําแหน่งฐาน 0 ของจุดแวะพักตามลําดับที่ระบุไว้ในคําขอ |
GeocodedWaypoint
รายละเอียดเกี่ยวกับสถานที่ที่ใช้เป็นจุดแวะพัก มีการป้อนข้อมูลสำหรับจุดแวะพักของที่อยู่เท่านั้น มีรายละเอียดเกี่ยวกับผลลัพธ์การจับคู่พิกัดภูมิศาสตร์เพื่อระบุสิ่งที่จับคู่พิกัดภูมิศาสตร์กับที่อยู่
การแสดง JSON |
---|
{
"geocoderStatus": {
object ( |
ช่อง | |
---|---|
geocoder |
ระบุรหัสสถานะที่เป็นผลมาจากการดำเนินการเปลี่ยนที่อยู่เป็นพิกัดภูมิศาสตร์ |
type[] |
ประเภทของผลการค้นหาในรูปแบบแท็กประเภทตั้งแต่ 0 รายการขึ้นไป ประเภทที่รองรับ: ประเภทที่อยู่และประเภทองค์ประกอบที่อยู่ |
partial |
บ่งชี้ว่าตัวแปลงพิกัดภูมิศาสตร์ไม่ได้แสดงผลลัพธ์ที่ตรงกันทั้งหมดสำหรับคำขอต้นฉบับ แต่จับคู่กับที่อยู่บางส่วนที่ขอได้ คุณอาจต้องตรวจสอบคำขอฉบับแรกเพื่อหาคำที่สะกดผิดและ/หรือที่อยู่ที่ไม่สมบูรณ์ |
place |
รหัสสถานที่สำหรับผลการค้นหานี้ |
intermediate |
ดัชนีของจุดแวะพักกลางที่เกี่ยวข้องในคำขอ ระบบจะป้อนข้อมูลก็ต่อเมื่อจุดสังเกตที่เกี่ยวข้องเป็นจุดสังเกตกลาง |