ขีดจำกัดความเร็ว

ประกาศ: บริการจำกัดความเร็วพร้อมให้บริการแก่ลูกค้าทุกรายที่มีใบอนุญาต การติดตาม ชิ้นงาน สำหรับลูกค้าที่ใช้ Google Maps Platform Premium Plan ซึ่งเปลี่ยนไปใช้ราคาแบบจ่ายเมื่อใช้ ฟีเจอร์จำกัดความเร็วจะยังคงใช้งานได้ในโปรเจ็กต์ที่มีความสามารถในการติดตามสินทรัพย์ (โปรเจ็กต์ที่มี รหัสโปรเจ็กต์ในรูปแบบ maps-asset-xxx)

Roads API จะแสดงขีดจำกัดความเร็วสำหรับส่วนของถนนที่ระบุ ในกรณีของช่วงถนนที่มีการจำกัดความเร็วที่เปลี่ยนแปลงได้ ระบบจะแสดงการจำกัดความเร็วสูงสุด สำหรับรถยนต์ในส่วนนั้น

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

คำขอ

ส่งคำขอขีดจำกัดความเร็วโดยใช้ HTTPS ในรูปแบบต่อไปนี้

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

การใช้พารามิเตอร์

พารามิเตอร์ที่จำเป็น

• พารามิเตอร์ path หรือ placeId

  • path — รายการคู่ละติจูด/ลองจิจูดสูงสุด 100 คู่ที่แสดงถึง เส้นทาง ค่าละติจูดและลองจิจูดต้องคั่นด้วยคอมมา คู่ละติจูด/ลองจิจูดต้องคั่นด้วยอักขระไปป์ "|" เมื่อระบุพารามิเตอร์ path API จะสแนปเส้นทางไปยัง ถนนที่ยานพาหนะน่าจะใช้มากที่สุดก่อน (เช่นเดียวกับคำขอ snapToRoads) จากนั้นจะกำหนดขีดจำกัดความเร็วสำหรับ ส่วนของถนนที่เกี่ยวข้อง หากไม่ต้องการให้ API ปรับเส้นทางให้เข้ากับถนน คุณต้องส่งพารามิเตอร์ placeId ตามที่อธิบายไว้ด้านล่าง ตัวอย่างต่อไปนี้ แสดงพารามิเตอร์ path ที่มีคู่ละติจูด/ลองจิจูด 3 คู่ path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796

  • placeId - รหัสสถานที่ซึ่งแสดงส่วนของถนนอย่างน้อย 1 ส่วน ตรวจสอบว่ารหัสสถานที่แต่ละรายการอ้างอิงถึงส่วนของถนน ไม่ใช่สถานที่ประเภทอื่น คุณสามารถส่งรหัสสถานที่ได้สูงสุด 100 รหัสในแต่ละคำขอ การตอบกลับจะมีขีดจำกัดความเร็วสำหรับรหัสสถานที่แต่ละรายการในคำขอ

    API จะไม่ทำการปักหมุดถนนในรหัสสถานที่ที่ระบุ คุณสามารถส่งคำขอ snapToRoads หรือ nearestRoads เพื่อค้นหารหัสสถานที่ที่เกี่ยวข้อง จากนั้นระบุรหัสเหล่านั้นเป็นอินพุตให้กับคำขอ speedLimits ตัวอย่างต่อไปนี้แสดงพารามิเตอร์ placeId ที่มีรหัสสถานที่ 2 รายการ placeId=ChIJs5ydyTiuEmsR0fRSlU0C7k0&placeId=ChIJW__r4ERXzpQRgkeRL6P0m3Y

ข้อควรระวัง: รายการจำกัดความเร็วแต่ละรายการในอาร์เรย์ speedLimits ของเนื้อหาการตอบกลับจะทริกเกอร์ SKU: ถนน - ขีดจำกัดความเร็ว ยิ่งมีอินพุต path และ placeID ในคำขอมากเท่าใด ระบบก็จะแสดงองค์ประกอบของขีดจำกัดความเร็วในการตอบกลับมากขึ้นเท่านั้น หากต้องการ เพิ่มประสิทธิภาพต้นทุน ให้ส่งพารามิเตอร์อินพุตตามจำนวนขั้นต่ำที่จำเป็น

• key — คีย์ API ของแอปพลิเคชัน แอปพลิเคชันของคุณต้องระบุตัวตนทุกครั้งที่ส่งคำขอไปยัง Roads API โดยใส่คีย์ API ไปกับคำขอแต่ละรายการ ดูวิธีรับคีย์

พารามิเตอร์ที่ไม่บังคับ

• units — จะแสดงขีดจำกัดความเร็วเป็นกิโลเมตรหรือไมล์ต่อชั่วโมงหรือไม่ โดยสามารถตั้งค่าเป็น KPH หรือ MPH ค่าเริ่มต้นคือ KPH

คำตอบ

องค์ประกอบต่อไปนี้อาจปรากฏในการตอบกลับของ speedLimits

• speedLimits — อาร์เรย์ของข้อมูลเมตาของถนน แต่ละองค์ประกอบประกอบด้วยฟิลด์ต่อไปนี้
  • placeId - ตัวระบุที่ไม่ซ้ำกันสำหรับสถานที่ รหัสสถานที่ทั้งหมดที่ Roads API แสดงผลจะสอดคล้องกับส่วนของถนน
  • speedLimit — ขีดจำกัดความเร็วสำหรับถนนช่วงนั้น
  • units — แสดงผล KPH หรือ MPH
• snappedPoints — อาร์เรย์ของจุดที่สแนป อาร์เรย์นี้จะแสดง ก็ต่อเมื่อคำขอมีพารามิเตอร์ path เท่านั้น แต่ละจุดประกอบด้วยฟิลด์ต่อไปนี้
  • location — มีค่า latitude และ longitude
  • originalIndex — จำนวนเต็มที่ระบุค่าที่เกี่ยวข้องในคำขอเดิม ค่าแต่ละค่าในคำขอควรจับคู่กับ ค่าที่สแนปในการตอบกลับ ค่าเหล่านี้จะได้รับการจัดทำดัชนีจาก 0 ดังนั้นจุดที่มี originalIndex เป็น 4 จะเป็นค่าที่สแนปของละติจูด/ลองจิจูดที่ 5 ที่ส่งไปยังพารามิเตอร์ path
  • placeId — ตัวระบุที่ไม่ซ้ำกันสำหรับสถานที่ รหัสสถานที่ทั้งหมดที่ Roads API แสดงผลจะสอดคล้องกับส่วนของถนน คุณสามารถส่ง placeId ในคำขอขีดจำกัดความเร็วเพื่อระบุขีดจำกัดความเร็วตลอดส่วนของถนนนั้นได้
• warning_message — สตริงที่มีคำเตือนที่ผู้ใช้มองเห็นได้

ตัวอย่างคำขอที่ใช้เส้นทาง

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

คำขอ

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

คำตอบ

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

โปรดสังเกตข้อความเตือนเกี่ยวกับความกระจัดกระจายของจุดในคำตอบด้านบน หากคุณ ขอจำกัดความเร็วสำหรับส่วนของถนนที่ใกล้ที่สุด ณ จุดใดก็ได้ คุณต้องเรียกใช้ speedLimits โดยใช้รหัสสถานที่ที่ดึงมาจาก ปลายทาง nearestRoads แทน

ตัวอย่างคำขอที่ใช้รหัสสถานที่

คุณสามารถส่งรหัสสถานที่ของส่วนถนนแทนการใช้คู่ละติจูด/ลองจิจูดได้ เราขอแนะนำให้คุณรับรหัสสถานที่สำหรับส่วนของถนนโดยใช้คำขอ snapToRoads หรือ nearestRoads เมื่อคุณส่งรหัสสถานที่ API จะแสดงขีดจำกัดความเร็วสำหรับส่วนของถนนที่แสดงโดยรหัสสถานที่แต่ละรหัส API จะไม่ใช้การปรับเส้นทางให้ตรงกับถนนกับรหัสสถานที่ที่ระบุ

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

คำขอ

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

คำตอบ

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

คำแนะนำในการใช้งาน

เพื่อลดปริมาณการโทรไปยังบริการจำกัดความเร็ว เราขอแนะนำให้ สุ่มตัวอย่างตำแหน่งของชิ้นงานทุกๆ 5-15 นาที (ค่าที่แน่นอน จะขึ้นอยู่กับความเร็วที่ชิ้นงานเคลื่อนที่) หากชิ้นงานอยู่กับที่ ตัวอย่างตำแหน่งเดียวก็เพียงพอ (ไม่จำเป็นต้องโทรหลายครั้ง)

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

ทำไมจึงไม่มีขีดจำกัดความเร็วบางส่วน/ทั้งหมด

สาเหตุที่พบบ่อยที่สุดที่ทำให้ไม่มี speedLimits คือการขอขีดจำกัดความเร็วของสถานที่ที่ไม่ใช่ส่วนของถนน

ตัวอย่างด้านบนใช้สะพาน Vasco da Gama เพื่อแสดงแนวคิด โดยสะพานนี้รองรับถนน E90 ที่ข้ามแม่น้ำ Rio Tejo สะพานมีรหัสสถานที่ ChIJUzt97ZEwGQ0RM1JzQfqoDtU ส่วนถนนแรก ในคำตอบข้างต้นเป็นส่วนหนึ่งของถนน E90 และมีรหัสสถานที่ ChIJX12duJAwGQ0Ra0d4Oi4jOGE ในคำขอตัวอย่าง หากคุณแทนที่รหัสสถานที่ของถนนด้วยรหัสสถานที่ของสะพาน การตอบกลับจะมีขีดจำกัดความเร็วเพียง 2 รายการในอาร์เรย์ speedLimits เนื่องจากรหัสสถานที่ของสะพานไม่ได้อ้างอิงถึงส่วนของถนนแต่ละส่วน นอกจากนี้ หากไม่มีรหัสสถานที่สำหรับส่วนของถนน คำตอบจะไม่มี ขีดจำกัดความเร็ว

เมื่อส่งคำขอจำกัดความเร็วโดยใช้รหัสสถานที่ โปรดตรวจสอบว่ารหัสสถานที่แต่ละรายการ อ้างอิงถึงส่วนของถนน ไม่ใช่สถานที่ประเภทอื่น การดึงรหัสสถานที่สำหรับ ส่วนถนนแต่ละส่วนทำได้ดีที่สุดโดยใช้คำขอ snapToRoads หรือ nearestRoads ซึ่งคำขอใดคำขอหนึ่งจะแสดงรหัสสถานที่หลายรายการจากการเรียกครั้งเดียวได้

จะเกิดอะไรขึ้นหากส่วนของถนนมีป้ายจำกัดความเร็วแยกกันสำหรับรถยนต์และรถบรรทุก

Roads API จะแสดงขีดจำกัดความเร็วสูงสุดที่ประกาศไว้สำหรับ รถยนต์เท่านั้น