Routes API สำหรับยานยนต์

Routes API for Automotive มีคุณลักษณะเฉพาะสำหรับพาร์ทเนอร์ยานยนต์ที่กำลังพัฒนาฟีเจอร์ระบบการนำทางในรถ โดยขยาย Routes API มาตรฐาน ด้วยแอตทริบิวต์ที่ปรับให้เหมาะกับอุตสาหกรรมยานยนต์

Routes API for Automotive รวมอะไรไว้บ้าง

นอกเหนือจากเอกสารประกอบสำหรับ Routes API มาตรฐานแล้ว Routes API สำหรับยานยนต์ยังมีเนื้อหาต่อไปนี้ด้วย

ให้สิทธิ์คำขอ

หากต้องการให้สิทธิ์คำขอที่ส่งไปยัง annotatePaths คุณต้องใช้วิธีการ OAuth ตามที่อธิบายไว้ในใช้ OAuth (Automotive) คำขอกำหนดให้คุณต้องใช้การแอบอ้างเป็นบุคคลอื่นกับ OAuth ซึ่งคล้ายกับวิธีที่คุณใช้เรียก Automotive Maps API (แต่มีขอบเขตอื่น)

แต่หากคุณเรียกใช้เมธอด computeRoutes หรือ computeRoutesMatrix คุณจะใช้การให้สิทธิ์ประเภทใดก็ได้ที่อธิบายไว้ในเอกสาร Routes API ปกติ ซึ่งได้แก่ คีย์ API หรือ OAuth

แชร์เอกสารกับ Standard Routes API

Routes API for Automotive แชร์เอกสารกับ Routes API มาตรฐาน เช่น บทแนะนำในแท็บคำแนะนำ

โปรดทราบว่าเมื่อใช้บทแนะนำ Routes API แบบมาตรฐาน ลิงก์จะชี้ไปยังข้อมูลอ้างอิงมาตรฐาน คุณต้องไปที่ลิงก์ที่เทียบเท่าใน Routes API สำหรับการอ้างอิงยานยนต์ ซึ่งทำได้โดยการเพิ่ม automotive/ หลัง routes/ ใน URL ของเบราว์เซอร์ เช่น routes/automotive/

การขอความช่วยเหลือ

เนื่องจาก Routes API สำหรับยานยนต์ไม่ได้เผยแพร่ต่อสาธารณะ เราจึงขอให้คุณหลีกเลี่ยงการส่งข้อบกพร่องไปยังเครื่องมือติดตามปัญหาสาธารณะ เราได้จัดเตรียมคอมโพเนนต์เครื่องมือติดตามปัญหาเฉพาะของบริษัทให้แก่ทีมของคุณเพื่อรายงานข้อบกพร่อง หากมีข้อกังวลอื่นๆ โปรดติดต่อผู้ติดต่อของ Google

รูปแบบและคำศัพท์ที่ใช้ตัวพิมพ์แบบอูฐ

เอกสารประกอบส่วนใหญ่จะใช้แบบโครงข่ายติดตั้งของอูฐ REST (เช่น annotatePaths) แทนที่จะใช้แบบโครงของ RPC (AnnotatePaths) อย่างไรก็ตาม ทั้ง 2 แบบใช้ตัวพิมพ์เล็ก/ใหญ่ได้เหมือนกัน

นอกจากนี้ ถึงแม้เราจะเรียก annotatePaths, computeRoutes หรือ computeRoutesMatrix ว่า "API" ทั่วไป แต่ที่จริงแล้วเป็นเมธอดที่กำหนดเอง แต่คุณอาจเห็นว่าเมธอดหรือ API อย่างใดอย่างหนึ่ง

GA (เวอร์ชันสำหรับผู้ใช้ทั่วไป) และฟีเจอร์ทดลอง

ส่วนนี้จะอธิบายแอตทริบิวต์ที่ไม่ซ้ำกันใน Routes API สำหรับยานยนต์ ฟีเจอร์ต่อไปนี้พร้อมให้บริการสำหรับผู้ใช้ทั่วไป

แสดงแอตทริบิวต์พื้นฐานผ่าน Routes API

เส้นประกอบ E7 (เส้นประกอบมาตรฐานที่เข้ารหัสซึ่งอธิบายด้วยพิกัด E7 แทน E5)

ฟีเจอร์ทดลอง

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

แสดงแอตทริบิวต์พื้นฐานผ่าน Routes API

  • มีการใช้โทเค็นเส้นทางเป็นอินพุตที่ไม่บังคับ ดู routeToken ใน Route

ข้อมูลที่แสดงในเส้นประกอบได้

  • ความล่าช้าของการจราจรซึ่งวัดเป็นนาทีของการจราจร โปรดดู IncidentType
  • เหตุการณ์ enum โดยไม่มีรายละเอียดเหตุการณ์แบบข้อความ โปรดดู IncidentInfo

โปรดดู PolylineDetails

ฟีเจอร์อื่นๆ

  • ระดับความสูงระหว่างเส้นทาง โปรดดู AltitudeInfo
  • ที่เก็บข้อมูลความเร็วที่คาดการณ์ไว้ระหว่างเส้นทาง (8 ที่เก็บข้อมูล แต่ละที่เก็บข้อมูลกว้าง 10-20 กม./ชม.) โปรดดู PredictedSpeedInfo

ตัวปรับเส้นทาง

คุณทริกเกอร์ RouteModifiers ต่อไปนี้จาก API ได้ อย่างไรก็ตาม เส้นทางเหล่านั้นอาจไม่ดำเนินการตามวัตถุประสงค์ของตัวแก้ไขเนื่องจากยังอยู่ระหว่างการพัฒนาและการทดสอบ โปรดติดต่อตัวแทนของ Google

  • หลีกเลี่ยงวิกเน็ตต์ (avoidVignettes[]) รองรับ 6 ประเทศ ได้แก่ ออสเตรีย สวิตเซอร์แลนด์ ฮังการี สโลวีเนีย สโลวาเกีย และสาธารณรัฐเช็ก
  • อนุญาตถนนสำหรับยานพาหนะที่มีผู้โดยสารจำนวนมาก (HOV) (hovPreference) รองรับในสหรัฐอเมริกาและแคนาดา
  • เลี่ยงอุโมงค์ (avoidTunnels)
  • เส้นทางเฉพาะรถพ่วง (totalAxleCount, totalHeightMm, totalLengthMm, totalWidthMm, totalWeightKg)