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

หน่วย

ชุดค่าที่ระบุหน่วยวัดที่ใช้ในการแสดงผล

Enum
UNITS_UNSPECIFIED ไม่ได้ระบุหน่วยวัด ค่าเริ่มต้นจะเป็นหน่วยวัดที่อนุมานจากคำขอ
METRIC หน่วยวัดที่เป็นเมตริก
IMPERIAL หน่วยวัดอิมพีเรียล (อังกฤษ)

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 ขา เส้นทางที่มีจุดระหว่างทางระดับกลาง 1 จุดของ via มีขา 1 ขา ลำดับของขาตรงกับลำดับของจุดอ้างอิงจาก origin ไป intermediates ถึง destination

distanceMeters

integer

ระยะทางในการเดินทางของเส้นทางในหน่วยเมตร

duration

string (Duration format)

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

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย "s" เช่น "3.5s"

staticDuration

string (Duration format)

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

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย "s" เช่น "3.5s"

polyline

object (Polyline)

เส้นประกอบเส้นทางโดยรวม โพลีไลน์นี้เป็นโพลีไลน์รวมของ legs ทั้งหมด

description

string

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

warnings[]

string

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

viewport

object (Viewport)

กล่องขอบเขตวิวพอร์ตของโพลีไลน์

travelAdvisory

object (RouteTravelAdvisory)

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

optimizedIntermediateWaypointIndex[]

integer

หากคุณตั้งค่า optimizeWaypointOrder เป็น "จริง" ช่องนี้จะมีการจัดลำดับจุดอ้างอิงระดับกลางที่เพิ่มประสิทธิภาพแล้ว ไม่เช่นนั้นช่องนี้จะว่างเปล่า เช่น หากป้อน Origin: LA; จุดอ้างอิงระดับกลาง: Dallas, Bangor, Phoenix; ปลายทาง: New York และลำดับจุดอ้างอิงระหว่างกลางที่เพิ่มประสิทธิภาพแล้วคือ Phoenix, Dallas, Bangor ช่องนี้จะมีค่า [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 เช่น "อเมริกา/นิว_ยอร์ก"

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)

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

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

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