Method: computeRoutes

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

หมายเหตุ: วิธีนี้กำหนดให้คุณต้องระบุมาสก์ช่องการตอบกลับในอินพุต คุณระบุมาสก์ฟิลด์การตอบกลับได้โดยใช้พารามิเตอร์ 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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
ฟิลด์
origin

object (Waypoint)

ต้องระบุ จุดอ้างอิงต้นทาง
destination

object (Waypoint)

ต้องระบุ จุดอ้างอิงปลายทาง
intermediates[]

object (Waypoint)

ไม่บังคับ ชุดจุดอ้างอิงตามเส้นทาง (ไม่รวมจุดสิ้นสุด) สำหรับการหยุดหรือผ่าน รองรับจุดแวะพักระหว่างทางสูงสุด 25 จุด
travelMode

enum (RouteTravelMode)

ไม่บังคับ ระบุรูปแบบการเดินทาง
routingPreference

enum (RoutingPreference)

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

enum (PolylineQuality)

ไม่บังคับ ระบุค่ากำหนดสำหรับคุณภาพของเส้นหลายเส้น
polylineEncoding

enum (PolylineEncoding)

ไม่บังคับ ระบุการเข้ารหัสที่ต้องการสำหรับเส้นหลายเส้น
departureTime

string (Timestamp format)

ไม่บังคับ เวลาออกเดินทาง หากไม่ได้ตั้งค่านี้ ค่าเริ่มต้นจะเป็นเวลาที่คุณส่งคำขอ หมายเหตุ: คุณระบุ departureTime ในอดีตได้เมื่อตั้งค่า RouteTravelMode เป็น TRANSIT เท่านั้น คุณดูการเดินทางด้วยระบบขนส่งสาธารณะได้ย้อนหลัง 7 วันหรือล่วงหน้า 100 วัน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
arrivalTime

string (Timestamp format)

ไม่บังคับ เวลาถึง หมายเหตุ: ระบบจะละเว้นฟิลด์นี้เมื่อคำขอระบุ RouteTravelMode อื่นที่ไม่ใช่ TRANSIT คุณระบุ departureTime หรือ arrivalTime ได้อย่างใดอย่างหนึ่ง แต่จะระบุทั้ง 2 อย่างไม่ได้ คุณดูการเดินทางด้วยระบบขนส่งสาธารณะได้ย้อนหลัง 7 วันหรือล่วงหน้า 100 วัน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
computeAlternativeRoutes

boolean

ไม่บังคับ ระบุว่าจะคำนวณเส้นทางอื่นนอกเหนือจากเส้นทางหรือไม่ ระบบจะไม่แสดงเส้นทางอื่นสำหรับคำขอที่มีจุดแวะพักกลาง
routeModifiers

object (RouteModifiers)

ไม่บังคับ ชุดเงื่อนไขที่ต้องปฏิบัติตามซึ่งส่งผลต่อวิธีคำนวณเส้นทาง
languageCode

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ดูข้อมูลเพิ่มเติมได้ที่ตัวระบุภาษาของ Unicode ดูรายการภาษาที่รองรับได้ที่การรองรับภาษา หากไม่ได้ระบุค่านี้ ระบบจะอนุมานภาษาที่แสดงจากตำแหน่งของคำขอเส้นทาง
regionCode

string

ไม่บังคับ รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ ดูข้อมูลเพิ่มเติมได้ที่โดเมนระดับบนสุดแบบรหัสประเทศ
units

enum (Units)

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

boolean

ไม่บังคับ หากตั้งค่าเป็นจริง บริการจะพยายามลดต้นทุนโดยรวมของเส้นทางด้วยการเรียงลำดับจุดแวะพักกลางที่ระบุใหม่ คำขอจะล้มเหลวหากจุดแวะพักใดๆ เป็นจุดแวะพัก via ใช้ ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index เพื่อค้นหาการจัดเรียงใหม่ หากไม่ได้ขอ ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index ในส่วนหัว X-Goog-FieldMask คำขอจะไม่สำเร็จ หากตั้งค่า optimizeWaypointOrder เป็น "เท็จ" ComputeRoutesResponse.optimized_intermediate_waypoint_index จะว่างเปล่า
requestedReferenceRoutes[]

enum (ReferenceRoute)

ไม่บังคับ ระบุเส้นทางอ้างอิงที่จะคำนวณเป็นส่วนหนึ่งของคำขอนอกเหนือจากเส้นทางเริ่มต้น เส้นทางอ้างอิงคือเส้นทางที่มีวัตถุประสงค์ในการคำนวณเส้นทางแตกต่างจากเส้นทางเริ่มต้น เช่น FUEL_EFFICIENTการคำนวณเส้นทางอ้างอิงจะพิจารณาพารามิเตอร์ต่างๆ ที่จะสร้างเส้นทางที่ประหยัดน้ำมันได้ดีที่สุด เมื่อใช้ฟีเจอร์นี้ ให้มองหา routeLabels ในเส้นทางที่ได้
extraComputations[]

enum (ExtraComputation)

ไม่บังคับ รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ นอกจากนี้ คุณต้องระบุช่องเพิ่มเติมเหล่านี้ในฟิลด์มาสก์ด้วยเพื่อให้แสดงในคำตอบ
trafficModel

enum (TrafficModel)

ไม่บังคับ ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม การตั้งค่านี้จะส่งผลต่อค่าที่แสดงในช่องระยะเวลาใน Route และ RouteLeg ซึ่งมีเวลาที่คาดการณ์ในการเข้าชมตามค่าเฉลี่ยที่ผ่านมา TrafficModel ใช้ได้กับคำขอที่ตั้งค่า RoutingPreference เป็น TRAFFIC_AWARE_OPTIMAL และ RouteTravelMode เป็น DRIVE เท่านั้น ค่าเริ่มต้นจะเป็น BEST_GUESS หากมีการขอการเข้าชมและไม่ได้ระบุ TrafficModel
transitPreferences

object (TransitPreferences)

ไม่บังคับ ระบุค่ากำหนดที่มีผลต่อเส้นทางที่แสดงสำหรับTRANSITเส้นทาง หมายเหตุ: คุณระบุ transitPreferences ได้ก็ต่อเมื่อตั้งค่า RouteTravelMode เป็น TRANSIT

เนื้อหาการตอบกลับ

v2.computeRoutes ข้อความตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
ช่อง
routes[]

object (Route)

มีอาร์เรย์ของเส้นทางที่คำนวณแล้ว (สูงสุด 3 เส้นทาง) เมื่อคุณระบุ compute_alternatives_routes และมีเพียง 1 เส้นทางเมื่อคุณไม่ได้ระบุ เมื่ออาร์เรย์นี้มีหลายรายการ รายการแรกคือเส้นทางที่แนะนำมากที่สุด หากอาร์เรย์ว่างเปล่า แสดงว่าไม่พบเส้นทาง
fallbackInfo

object (FallbackInfo)

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

object (GeocodingResults)

มีข้อมูลการตอบกลับการแปลงพิกัดภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่

PolylineQuality

ชุดค่าที่ระบุคุณภาพของเส้นหลายเส้น

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

PolylineEncoding

ระบุประเภทของเส้นหลายเส้นที่ต้องการให้แสดง

Enum
POLYLINE_ENCODING_UNSPECIFIED ไม่ได้ระบุค่ากำหนดประเภท Polyline ค่าเริ่มต้นคือ ENCODED_POLYLINE
ENCODED_POLYLINE ระบุเส้นหลายเส้นที่เข้ารหัสโดยใช้อัลกอริทึมการเข้ารหัสเส้นหลายเส้น
GEO_JSON_LINESTRING ระบุเส้นหลายเส้นโดยใช้รูปแบบ LineString ของ GeoJSON

ReferenceRoute

เส้นทางอ้างอิงที่รองรับใน ComputeRoutesRequest

Enum
REFERENCE_ROUTE_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะล้มเหลว
FUEL_EFFICIENT เส้นทางที่ประหยัดเชื้อเพลิง
SHORTER_DISTANCE

เส้นทางที่มีระยะทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้

สำหรับDRIVE คำขอ ฟีเจอร์นี้จะจัดลำดับความสำคัญของระยะทางที่สั้นกว่าเหนือความสะดวกสบายในการขับขี่ เช่น อาจเลือกใช้ถนนในพื้นที่แทนทางหลวง ใช้ถนนลูกรัง ตัดผ่านลานจอดรถ ฯลฯ ฟีเจอร์นี้จะไม่แสดงการเลี้ยวที่ Google Maps ทราบว่าผิดกฎหมาย

สำหรับคำขอ BICYCLE และ TWO_WHEELER ฟีเจอร์นี้จะแสดงเส้นทางที่คล้ายกับเส้นทางที่แสดงเมื่อคุณไม่ได้ระบุ requestedReferenceRoutes

ฟีเจอร์นี้ใช้ร่วมกับโหมดการเดินทางอื่นๆ ผ่านจุดแวะพักกลางทาง หรือ optimizeWaypointOrder ไม่ได้ คำขอดังกล่าวจะล้มเหลว แต่คุณใช้ฟีเจอร์นี้กับ routingPreference ใดก็ได้

ExtraComputation

การคำนวณเพิ่มเติมที่จะดำเนินการขณะประมวลผลคำขอ

Enum
EXTRA_COMPUTATION_UNSPECIFIED ไม่ได้ใช้ คำขอที่มีค่านี้จะล้มเหลว
TOLLS ข้อมูลค่าผ่านทางสำหรับเส้นทาง
FUEL_CONSUMPTION การใช้น้ำมันเชื้อเพลิงโดยประมาณสำหรับเส้นทาง
TRAFFIC_ON_POLYLINE Polyline ที่รับรู้การจราจรสำหรับเส้นทาง
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions แสดงเป็นสตริงข้อความ HTML ที่จัดรูปแบบแล้ว เนื้อหานี้มีไว้ให้อ่านตามที่แสดงเท่านั้น อย่าแยกวิเคราะห์โดยใช้โปรแกรม
FLYOVER_INFO_ON_POLYLINE ข้อมูลฟลายโอเวอร์สำหรับเส้นทาง ต้องระบุ routes.polyline_details.flyover_info fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเขตปริมณฑลบางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง SKU/ค่าใช้จ่าย
NARROW_ROAD_INFO_ON_POLYLINE ข้อมูลถนนแคบสำหรับเส้นทาง ต้องระบุ routes.polyline_details.narrow_road_info fieldmask เพื่อแสดงข้อมูลนี้ ปัจจุบันระบบจะป้อนข้อมูลนี้สำหรับเขตปริมณฑลบางแห่งในอินเดียเท่านั้น ฟีเจอร์นี้ยังอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง SKU/ค่าใช้จ่าย

เส้นทาง

มีเส้นทางซึ่งประกอบด้วยชุดของส่วนถนนที่เชื่อมต่อกันซึ่งรวมจุดอ้างอิงเริ่มต้น สิ้นสุด และจุดอ้างอิงกลาง

การแสดง JSON 
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
ช่อง
routeLabels[]

enum (RouteLabel)

ป้ายกำกับสำหรับ Route ที่มีประโยชน์ในการระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจงของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นๆ
legs[]

object (RouteLeg)

ชุดของขา (กลุ่มเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละขาจะสอดคล้องกับการเดินทางระหว่าง via Waypoints 2 แห่ง เช่น เส้นทางที่ไม่มีจุดแวะพักระหว่างทางจะมีเพียง 1 ขา เส้นทางที่มีจุดแวะพักที่ไม่ใช่via 1 จุดจะมี 2 ขา เส้นทางที่มีจุดแวะพักกลาง 1 จุดviaจะมี 1 ขา ลำดับของขาตรงกับลำดับของจุดอ้างอิงจาก origin ไปยัง intermediates ไปยัง destination
distanceMeters

integer

ระยะทางการเดินทางของเส้นทางเป็นเมตร
duration

string (Duration format)

ระยะเวลาที่ใช้ในการนำทางตามเส้นทาง หากตั้งค่า routingPreference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ staticDuration หากคุณตั้งค่า routingPreference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
staticDuration

string (Duration format)

ระยะเวลาในการเดินทางผ่านเส้นทางโดยไม่คำนึงถึงสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
polyline

object (Polyline)

เส้นประกอบของเส้นทางโดยรวม เส้นหลายเส้นนี้คือเส้นหลายเส้นรวมของ legs ทั้งหมด
description

string

คำอธิบายเส้นทาง
warnings[]

string

อาร์เรย์ของคำเตือนที่จะแสดงเมื่อแสดงเส้นทาง
viewport

object (Viewport)

กรอบล้อมรอบวิวพอร์ตของเส้นประกอบ
travelAdvisory

object (RouteTravelAdvisory)

ข้อมูลเพิ่มเติมเกี่ยวกับเส้นทาง
optimizedIntermediateWaypointIndex[]

integer

หากตั้งค่า optimizeWaypointOrder เป็นจริง ช่องนี้จะมีลำดับจุดแวะพักกลางที่เพิ่มประสิทธิภาพแล้ว ไม่เช่นนั้น ช่องนี้จะว่างเปล่า เช่น หากคุณป้อนต้นทาง: ลอสแอนเจลิส จุดแวะพักกลางทาง: แดลลัส แบงกอร์ ฟีนิกซ์ ปลายทาง: นิวยอร์ก และลำดับจุดแวะพักกลางทางที่เพิ่มประสิทธิภาพแล้วคือ ฟีนิกซ์ แดลลัส แบงกอร์ ฟิลด์นี้จะมีค่า [2, 0, 1] ดัชนีเริ่มต้นด้วย 0 สำหรับจุดอ้างอิงกลางแรกที่ระบุในอินพุต
localizedValues

object (RouteLocalizedValues)

การแสดงข้อความของพร็อพเพอร์ตี้ของ Route
routeToken

string

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

หมายเหตุ: Route.route_token ใช้ได้กับคำขอที่ตั้งค่า ComputeRoutesRequest.routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL เท่านั้น Route.route_token ไม่รองรับคำขอที่มีจุดแวะพัก
polylineDetails

object (PolylineDetails)

มีข้อมูลเกี่ยวกับรายละเอียดตามแนวเส้น

RouteLabel

ป้ายกำกับสำหรับ Route ที่มีประโยชน์ในการระบุพร็อพเพอร์ตี้ที่เฉพาะเจาะจงของเส้นทางเพื่อเปรียบเทียบกับเส้นทางอื่นๆ

Enum
ROUTE_LABEL_UNSPECIFIED ค่าเริ่มต้น - ไม่ได้ใช้
DEFAULT_ROUTE เส้นทาง "ดีที่สุด" เริ่มต้นที่แสดงผลสำหรับการคำนวณเส้นทาง
DEFAULT_ROUTE_ALTERNATE เส้นทางอื่นแทนเส้นทาง "ดีที่สุด" ตามค่าเริ่มต้น ระบบจะแสดงเส้นทางเช่นนี้เมื่อระบุ computeAlternativeRoutes
FUEL_EFFICIENT เส้นทางที่ประหยัดเชื้อเพลิง เส้นทางที่มีป้ายกำกับเป็นค่านี้จะได้รับการพิจารณาว่าได้รับการเพิ่มประสิทธิภาพสำหรับพารามิเตอร์ที่เป็นมิตรต่อสิ่งแวดล้อม เช่น การสิ้นเปลืองเชื้อเพลิง
SHORTER_DISTANCE เส้นทางที่มีระยะทางสั้นกว่า นี่เป็นฟีเจอร์ทดลองใช้

RouteLeg

มีส่วนระหว่างจุดอ้างอิงที่ไม่ใช่ via

การแสดง JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
ช่อง
distanceMeters

integer

ระยะการเดินทางของขาเส้นทางเป็นเมตร
duration

string (Duration format)

ระยะเวลาที่ต้องใช้ในการไปยังขา หากตั้งค่า route_preference เป็น TRAFFIC_UNAWARE ค่านี้จะเหมือนกับ staticDuration หาก route_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ระบบจะคำนวณค่านี้โดยพิจารณาจากสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
staticDuration

string (Duration format)

ระยะเวลาการเดินทางผ่านช่วงนั้นๆ โดยคำนวณโดยไม่พิจารณาสภาพการจราจร

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
polyline

object (Polyline)

เส้นประกอบโดยรวมของช่วงนี้ซึ่งรวมเส้นประกอบของแต่ละ step
startLocation

object (Location)

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

object (Location)

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

object (RouteLegStep)

อาร์เรย์ของขั้นตอนที่ระบุกลุ่มภายในช่วงนี้ แต่ละขั้นตอนแสดงคำสั่งการนำทาง 1 รายการ
travelAdvisory

object (RouteLegTravelAdvisory)

มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น ข้อจำกัดของเขตการจราจรที่เป็นไปได้ในเส้นทาง
localizedValues

object (RouteLegLocalizedValues)

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLeg
stepsOverview

object (StepsOverview)

ข้อมูลภาพรวมเกี่ยวกับขั้นตอนในRouteLegนี้ ระบบจะป้อนข้อมูลในช่องนี้สำหรับเส้นทางขนส่งสาธารณะเท่านั้น

เส้นประกอบ

ห่อหุ้มเส้นประกอบที่เข้ารหัส

การแสดง JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
ช่อง
ฟิลด์ Union polyline_type แคปซูลประเภทของเส้นประกอบ ค่าเริ่มต้นคือ encoded_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
encodedPolyline

string

การเข้ารหัสสตริงของเส้นหลายเส้นโดยใช้อัลกอริทึมการเข้ารหัสเส้นหลายเส้น
geoJsonLinestring

object (Struct format)

ระบุเส้นหลายเส้นโดยใช้รูปแบบ LineString ของ GeoJSON

RouteLegStep

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

การแสดง JSON 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
ช่อง
distanceMeters

integer

ระยะทางการเดินทางของขั้นตอนนี้เป็นเมตร ในบางกรณี ช่องนี้อาจไม่มีค่า
staticDuration

string (Duration format)

ระยะเวลาการเดินทางผ่านขั้นตอนนี้โดยไม่พิจารณาสภาพการจราจร ในบางกรณี ช่องนี้อาจไม่มีค่า

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
polyline

object (Polyline)

เส้นหลายเหลี่ยมที่เชื่อมโยงกับขั้นตอนนี้
startLocation

object (Location)

ตำแหน่งเริ่มต้นของขั้นตอนนี้
endLocation

object (Location)

ตำแหน่งสิ้นสุดของขั้นตอนนี้
navigationInstruction

object (NavigationInstruction)

คำแนะนำการนำทาง
travelAdvisory

object (RouteLegStepTravelAdvisory)

มีข้อมูลเพิ่มเติมที่ผู้ใช้ควรทราบ เช่น ข้อจำกัดของเขตการจราจรที่เป็นไปได้ในขั้นตอนย่อย
localizedValues

object (RouteLegStepLocalizedValues)

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLegStep
transitDetails

object (RouteLegStepTransitDetails)

รายละเอียดที่เกี่ยวข้องกับขั้นตอนนี้หากโหมดการเดินทางเป็น TRANSIT
travelMode

enum (RouteTravelMode)

โหมดการเดินทางที่ใช้สำหรับขั้นตอนนี้

Maneuver

ชุดค่าที่ระบุการดำเนินการนำทางที่จะใช้สำหรับขั้นตอนปัจจุบัน (เช่น เลี้ยวซ้าย ผสาน หรือตรง)

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 (SpeedReadingInterval)
    }
  ]
}
ช่อง
speedReadingIntervals[]

object (SpeedReadingInterval)

หมายเหตุ: ขณะนี้ช่องนี้ไม่มีข้อมูล

RouteLegStepLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

การแสดง JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
staticDuration

object (LocalizedText)

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ

RouteLegStepTransitDetails

ข้อมูลเพิ่มเติมสำหรับ RouteLegStep ที่เกี่ยวข้องกับเส้นทาง TRANSIT

การแสดง JSON 
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
ช่อง
stopDetails

object (TransitStopDetails)

ข้อมูลเกี่ยวกับป้ายรถประจำทางขาเข้าและขาออกสำหรับขั้นตอน
localizedValues

object (TransitDetailsLocalizedValues)

การแสดงข้อความของพร็อพเพอร์ตี้ของ RouteLegStepTransitDetails
headsign

string

ระบุทิศทางที่จะเดินทางในเส้นทางนี้ตามที่ระบุไว้ในยานพาหนะหรือที่ป้ายหยุดรถต้นทาง โดยมักจะเป็นสถานีปลายทาง
headway

string (Duration format)

ระบุเวลาที่คาดไว้เป็นระยะเวลาระหว่างการออกเดินทางจากป้ายเดียวกันในเวลานี้ เช่น หากมีค่า headway seconds เป็น 600 คุณก็คาดได้ว่าจะต้องรอ 10 นาทีหากขึ้นรถประจำทางไม่ทัน

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
transitLine

object (TransitLine)

ข้อมูลเกี่ยวกับสายรถประจำทางที่ใช้ในขั้นตอนนี้
stopCount

integer

จำนวนป้ายจอดรถตั้งแต่ป้ายต้นทางจนถึงป้ายปลายทาง จำนวนนี้รวมป้ายจอดรถขาเข้า แต่ไม่รวมป้ายจอดรถขาออก เช่น หากเส้นทางของคุณออกจากป้าย A ผ่านป้าย B และ C แล้วไปถึงป้าย D

stopCount

ผลตอบแทน 3
tripShortText

string

ข้อความที่ปรากฏในตารางเวลาและป้ายบอกทางเพื่อระบุการเดินทางด้วยระบบขนส่งสาธารณะให้ผู้โดยสาร ข้อความควรระบุการเดินทางภายในวันให้บริการได้อย่างไม่ซ้ำกัน เช่น "538" คือtripShortTextของรถไฟ Amtrak ที่ออกจากซานโฮเซ รัฐแคลิฟอร์เนีย เวลา 15:10 น. ในวันธรรมดาไปยังแซคราเมนโต รัฐแคลิฟอร์เนีย

TransitStopDetails

รายละเอียดเกี่ยวกับป้ายจอดรถประจำทางสำหรับ RouteLegStep

การแสดง JSON 
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
ช่อง
arrivalStop

object (TransitStop)

ข้อมูลเกี่ยวกับป้ายจอดรถขาเข้าสำหรับขั้นตอน
arrivalTime

string (Timestamp format)

เวลาถึงโดยประมาณของขั้นตอน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
departureStop

object (TransitStop)

ข้อมูลเกี่ยวกับป้ายรถประจำทางต้นทางสำหรับขั้นตอน
departureTime

string (Timestamp format)

เวลาออกเดินทางโดยประมาณของขั้นตอน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

TransitStop

ข้อมูลเกี่ยวกับป้ายหยุดรถประจำทาง

การแสดง JSON 
{
  "name": string,
  "location": {
    object (Location)
  }
}
ช่อง
name

string

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

object (Location)

ตำแหน่งของป้ายจอดรถที่แสดงในพิกัดละติจูด/ลองจิจูด

TransitDetailsLocalizedValues

คำอธิบายค่าที่แปลแล้วสำหรับ RouteTransitDetails

การแสดง JSON 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
ช่อง
arrivalTime

object (LocalizedTime)

เวลาในรูปแบบข้อความที่จัดรูปแบบพร้อมเขตเวลาที่เกี่ยวข้อง
departureTime

object (LocalizedTime)

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

LocalizedTime

คำอธิบายเวลาที่แปลแล้ว

การแสดง JSON 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
ช่อง
time

object (LocalizedText)

เวลาที่ระบุเป็นสตริงในเขตเวลาที่กำหนด
timeZone

string

มีเขตเวลา ค่าคือชื่อของเขตเวลาตามที่กำหนดไว้ในฐานข้อมูลเขตเวลาของ IANA เช่น "America/New_York"

TransitLine

มีข้อมูลเกี่ยวกับเส้นทางการขนส่งสาธารณะที่ใช้ในขั้นตอนนี้

การแสดง JSON 
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
ช่อง
agencies[]

object (TransitAgency)

บริษัทขนส่งที่ให้บริการเส้นทางขนส่งสาธารณะนี้
name

string

ชื่อเต็มของเส้นทางขนส่งนี้ เช่น "8 Avenue Local"
uri

string

URI สำหรับเส้นทางขนส่งสาธารณะนี้ตามที่บริษัทขนส่งระบุ
color

string

สีที่มักใช้ในป้ายสำหรับสายนี้ แสดงในรูปแบบเลขฐานสิบหก
iconUri

string

URI ของไอคอนที่เชื่อมโยงกับบรรทัดนี้
nameShort

string

ชื่อย่อของเส้นทางขนส่งสาธารณะนี้ โดยปกติแล้วชื่อนี้จะเป็นหมายเลขสาย เช่น "M7" หรือ "355"
textColor

string

สีที่ใช้กันโดยทั่วไปในข้อความบนป้ายสำหรับสายนี้ แสดงในรูปแบบเลขฐานสิบหก
vehicle

object (TransitVehicle)

ประเภทของยานพาหนะที่วิ่งในเส้นทางขนส่งสาธารณะนี้

TransitAgency

บริษัทขนส่งที่ให้บริการเส้นทางขนส่งสาธารณะ

การแสดง JSON 
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
ช่อง
name

string

ชื่อของบริษัทขนส่งนี้
phoneNumber

string

หมายเลขโทรศัพท์ที่จัดรูปแบบเฉพาะภาษาของหน่วยงานขนส่ง
uri

string

URI ของบริษัทขนส่ง

TransitVehicle

ข้อมูลเกี่ยวกับยานพาหนะที่ใช้ในเส้นทางการขนส่ง

การแสดง JSON 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
ช่อง
name

object (LocalizedText)

ชื่อของยานพาหนะนี้ (ตัวพิมพ์ใหญ่)
type

enum (TransitVehicleType)

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

string

URI ของไอคอนที่เชื่อมโยงกับยานพาหนะประเภทนี้
localIconUri

string

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": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
ช่อง
tollInfo

object (TollInfo)

มีข้อมูลเกี่ยวกับค่าผ่านทางบน RouteLeg ที่เฉพาะเจาะจง ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อเราคาดว่าจะมีค่าผ่านทางใน RouteLeg และ TOLLS รวมอยู่ใน ComputeRoutesRequest.extra_computations ของคำขอ หากตั้งค่าช่องนี้ไว้แต่ไม่ได้กรอกข้อมูลในช่องย่อย estimatedPrice เราคาดว่าถนนมีค่าผ่านทางแต่ไม่ทราบราคาโดยประมาณ หาก tollInfo ไม่มีอยู่ แสดงว่าไม่มีค่าผ่านทางบน RouteLeg
speedReadingIntervals[]

object (SpeedReadingInterval)

ช่วงการอ่านความเร็วที่แสดงความหนาแน่นของการจราจร ระบบจะป้อนข้อมูลในช่องนี้สำหรับคำขอเท่านั้นเมื่อคำขอมีค่า TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference และรวม TRAFFIC_ON_POLYLINE ไว้ใน ComputeRoutesRequest.extra_computations ช่วงเวลาจะครอบคลุมเส้นหลายเส้นทั้งหมดของ RouteLeg โดยไม่มีการทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุจะเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า

ตัวอย่าง

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

การแสดง JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
duration

object (LocalizedText)

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

object (LocalizedText)

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ

StepsOverview

ให้ข้อมูลภาพรวมเกี่ยวกับรายการของ RouteLegStep

การแสดง JSON 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
ช่อง
multiModalSegments[]

object (MultiModalSegment)

ข้อมูลสรุปเกี่ยวกับกลุ่มมัลติโมดัลต่างๆ ของ RouteLeg.steps ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg ไม่มีส่วนแบบมัลติโมดัลในขั้นตอน

MultiModalSegment

ให้ข้อมูลสรุปเกี่ยวกับกลุ่มมัลติโมดัลต่างๆ ของ RouteLeg.steps กลุ่มมัลติโมดัลหมายถึง RouteLegStep ที่ต่อเนื่องกันอย่างน้อย 1 รายการซึ่งมี RouteTravelMode เดียวกัน ระบบจะไม่ป้อนข้อมูลในช่องนี้หาก RouteLeg ไม่มีส่วนแบบมัลติโมดัลในขั้นตอน

การแสดง JSON 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
ช่อง
navigationInstruction

object (NavigationInstruction)

NavigationInstruction สำหรับกลุ่มมัลติโมดัล
travelMode

enum (RouteTravelMode)

รูปแบบการเดินทางของส่วนหลายรูปแบบ
stepStartIndex

integer

RouteLegStepดัชนีที่เกี่ยวข้องซึ่งเป็นจุดเริ่มต้นของกลุ่มมัลติโมดัล
stepEndIndex

integer

RouteLegStep ดัชนีที่เกี่ยวข้องซึ่งเป็นจุดสิ้นสุดของกลุ่มมัลติโมดัล

วิวพอร์ต

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

ตัวอย่างเช่น Viewport นี้ครอบคลุมนิวยอร์กซิตี้ทั้งหมด

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

การแสดง JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ฟิลด์
low

object (LatLng)

ต้องระบุ จุดต่ำสุดของวิวพอร์ต
high

object (LatLng)

ต้องระบุ จุดสูงสุดของวิวพอร์ต

RouteLocalizedValues

การแสดงข้อความของพร็อพเพอร์ตี้บางอย่าง

การแสดง JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
ช่อง
distance

object (LocalizedText)

ระยะทางในการเดินทางที่แสดงในรูปแบบข้อความ
duration

object (LocalizedText)

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

object (LocalizedText)

ระยะเวลาโดยไม่พิจารณาถึงสภาพการจราจร ซึ่งแสดงในรูปแบบข้อความ
transitFare

object (LocalizedText)

ค่าโดยสารขนส่งที่แสดงในรูปแบบข้อความ

PolylineDetails

รายละเอียดที่สอดคล้องกับดัชนีหรือกลุ่มที่อยู่ติดกันของเส้นหลายเส้น เมื่อกำหนดเส้นหลายเส้นที่มีจุด P_0, P_1, ... , P_N (ดัชนีที่อิงตาม 0) PolylineDetails จะกำหนดช่วงและข้อมูลเมตาที่เชื่อมโยง

การแสดง JSON 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
ช่อง
flyoverInfo[]

object (FlyoverInfo)

รายละเอียดการบินผ่านตามแนวเส้น
narrowRoadInfo[]

object (NarrowRoadInfo)

รายละเอียดถนนแคบตามแนวเส้นประกอบ

FlyoverInfo

แคปซูลข้อมูลเกี่ยวกับภาพมุมสูงตามแนวเส้นประกอบ

การแสดง JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
flyoverPresence

enum (RoadFeatureState)

เอาต์พุตเท่านั้น ระบุว่ามีฟลายโอเวอร์สำหรับช่วงของเส้นหลายเส้นที่กำหนดหรือไม่
polylinePointIndex

object (PolylinePointIndex)

ตำแหน่งของข้อมูลที่เกี่ยวข้องกับฟลายโอเวอร์ตามแนวเส้นประกอบ

RoadFeatureState

แคปซูลสถานะขององค์ประกอบถนนตามแนวเส้นประกอบ

Enum
ROAD_FEATURE_STATE_UNSPECIFIED ไม่ได้คำนวณสถานะของฟีเจอร์ถนน (ค่าเริ่มต้น)
EXISTS มีฟีเจอร์ถนน
DOES_NOT_EXIST ไม่มีฟีเจอร์ถนน

PolylinePointIndex

แคปซูลดัชนีเริ่มต้นและสิ้นสุดสำหรับรายละเอียดของเส้นหลายเส้น สำหรับอินสแตนซ์ที่ข้อมูลสอดคล้องกับจุดเดียว startIndex และ endIndex จะเท่ากัน

การแสดง JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
ช่อง
startIndex

integer

ดัชนีเริ่มต้นของรายละเอียดนี้ในเส้นหลายเส้น
endIndex

integer

ดัชนีสิ้นสุดของรายละเอียดนี้ในเส้นหลายเส้น

NarrowRoadInfo

แคปซูลข้อมูลเกี่ยวกับถนนแคบตามแนวเส้นประกอบ

การแสดง JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
ช่อง
narrowRoadPresence

enum (RoadFeatureState)

เอาต์พุตเท่านั้น ระบุว่ามีถนนแคบสำหรับช่วงของเส้นประกอบที่ระบุหรือไม่
polylinePointIndex

object (PolylinePointIndex)

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

GeocodingResults

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

การแสดง JSON 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
ช่อง
origin

object (GeocodedWaypoint)

จุดอ้างอิงต้นทางที่เข้ารหัสพิกัดภูมิศาสตร์
destination

object (GeocodedWaypoint)

จุดอ้างอิงที่เข้ารหัสพิกัดภูมิศาสตร์ของปลายทาง
intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

การแสดง JSON 
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
ช่อง
geocoderStatus

object (Status)

ระบุรหัสสถานะที่เกิดจากการดำเนินการ Geocoding
type[]

string

ประเภทของผลลัพธ์ในรูปแบบของแท็กประเภทตั้งแต่ 0 รายการขึ้นไป ประเภทที่รองรับ: ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่
partialMatch

boolean

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

string

รหัสสถานที่สำหรับผลการค้นหานี้
intermediateWaypointRequestIndex

integer

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