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 ได้ แต่ไม่ใช่ทั้ง 2 อย่าง การเดินทางด้วยขนส่งสาธารณะจะมีระยะเวลาให้บริการสูงสุด 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

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

คอลเล็กชันของขา (ส่วนของเส้นทางระหว่างจุดอ้างอิง) ที่ประกอบกันเป็นเส้นทาง แต่ละขาตรงกับการเดินทางระหว่าง 2 แถวที่ไม่ใช่via Waypoints เช่น เส้นทางที่ไม่มีจุดอ้างอิงระหว่างกลางจะมีขาเพียงด้านเดียว เส้นทางที่มีจุดอ้างอิงระหว่างกลางที่ไม่ใช่ via หนึ่งมี 2 ขา เส้นทางที่มีจุดอ้างอิงระหว่างกลาง 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 เป็น "จริง" ช่องนี้จะมีการเรียงลำดับจุดอ้างอิงระดับกลางที่มีการเพิ่มประสิทธิภาพ ไม่เช่นนั้น ช่องนี้จะว่างเปล่า เช่น หากป้อนข้อมูลของต้นทาง: LA; จุดอ้างอิงระดับกลาง: ดัลลัส, บังกอร์, ฟีนิกซ์; ปลายทาง: นิวยอร์ก และลำดับจุดอ้างอิงระดับกลางที่เพิ่มประสิทธิภาพคือ ฟีนิกซ์ ดัลลัส บังกอร์ ช่องนี้จะมีค่า [2, 0, 1] ดัชนีขึ้นต้นด้วย 0 สำหรับจุดอ้างอิงระดับกลางแรกที่ระบุไว้ในอินพุต
localizedValues

object (RouteLocalizedValues)

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

string

โทเค็นเส้นทางที่เข้ารหัสแบบ Base64 สำหรับเว็บซึ่งสามารถส่งผ่านไปยัง Navigation SDK ทำให้ Navigation SDK สามารถปรับโครงสร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่เปลี่ยนเส้นทาง ให้ยึดตามความตั้งใจเดิมเมื่อคุณสร้างเส้นทางด้วยการเรียกใช้ v2.computeRoutes ลูกค้าควรถือว่าโทเค็นนี้เป็น Blob ทึบ ไม่ได้มีไว้เพื่ออ่านหรือเปลี่ยนแปลง หมายเหตุ: Route.route_token จะใช้ได้กับคำขอที่ตั้งค่า ComputeRoutesRequest.routing_preference เป็น TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL เท่านั้น ไม่รองรับ Route.route_token สำหรับคำขอที่มีจุดอ้างอิง Via

RouteLabel

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

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

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 นี้ ช่องนี้จะมีการป้อนข้อมูลสำหรับเส้นทาง TRANSIT เท่านั้น

เส้นประกอบ

ห่อหุ้มโพลีไลน์ที่เข้ารหัส

การแสดง 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 ห่อหุ้มประเภทของโพลีไลน์ ค่าเริ่มต้นเป็น encrypted_polyline polyline_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
encodedPolyline

string

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

object (Struct format)

ระบุโพลีไลน์โดยใช้รูปแบบ GeoJSON LineString

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

วิวพอร์ต

วิวพอร์ตละติจูด-ลองจิจูด ซึ่งแสดงเป็นแนวทแยงมุม 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 (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

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

boolean

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

string

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

integer

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