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 วันที่ผ่านมาหรือ 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 วันที่ผ่านมาหรือ 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 Locale Identifier โปรดดูรายการภาษาที่รองรับในการสนับสนุนภาษา หากไม่ระบุค่านี้ ภาษาที่แสดงจะอนุมานจากตำแหน่งของคำขอเส้นทาง

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 จะพิจารณาพารามิเตอร์ต่างๆ ที่จะสร้างเส้นทางที่ประหยัดเชื้อเพลิงที่เหมาะสมที่สุด

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.computeRoute จะส่งข้อความตอบกลับ

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

การแสดง 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 ระบุเส้นประกอบโดยใช้รูปแบบ 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)

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

localizedValues

object (RouteLocalizedValues)

ข้อความแสดงคุณสมบัติของ Route

routeToken

string

โทเค็นเส้นทางที่เข้ารหัสแบบ Base64 ที่ปลอดภัยสำหรับเว็บซึ่งส่งไปยัง SDK การนำทางได้ ซึ่งช่วยให้ 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)

วิธีการไปยังส่วนต่างๆ สำหรับกลุ่มแบบหลายโมดัล

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)

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

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

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