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 วัน

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

arrivalTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

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

regionCode

string

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

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 และมีเพียงเส้นทางเดียวเมื่อคุณไม่ได้ระบุ เมื่ออาร์เรย์นี้มีรายการหลายรายการ รายการแรกจะเป็นเส้นทางที่แนะนำมากที่สุด หากอาร์เรย์ว่าง แสดงว่าไม่พบเส้นทาง

fallbackInfo

object (FallbackInfo)

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

geocodingResults

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

เส้นทาง

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

การแสดง 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
}
ช่อง
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

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

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

การเคลื่อนไหว

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

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)

ระบุเวลาโดยประมาณเป็นระยะเวลาระหว่างการออกเดินทางจากป้ายจอดรถเดียวกันในเวลานี้ เช่น เมื่อค่าความถี่ของรถเป็น 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)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

departureStop

object (TransitStop)

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

departureTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

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 หากตั้งค่าช่องนี้ไว้แต่ไม่ได้ป้อนข้อมูลในช่องย่อย estimatedPrice แสดงว่าถนนนั้นอาจมีค่าผ่านทาง แต่เราไม่ทราบว่าราคาโดยประมาณเท่าใด หากไม่มีช่องนี้ แสดงว่าRouteLegไม่มีค่าผ่านทาง

speedReadingIntervals[]

object (SpeedReadingInterval)

ช่วงเวลาการอ่านความเร็วที่แสดงรายละเอียดความหนาแน่นของการเข้าชม ใช้ในกรณีที่มีการกำหนดค่าการกำหนดเส้นทาง TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ช่วงเวลาครอบคลุมรูปหลายเส้นทั้งหมดของ 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 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 (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)

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

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)

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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