ถนนที่ใกล้ที่สุด

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

หากคุณใช้จุด GPS ที่ต่อเนื่องกัน ให้ใช้ Snap to Roads

คำขอ

ต้องส่งคำขอไปยังถนนที่ใกล้ที่สุดโดยใช้ HTTPS และมีรูปแบบดังนี้

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

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

  • คะแนน

    จุดที่จะ Snap พารามิเตอร์ points ยอมรับรายการของ ละติจูด/ลองจิจูด คั่นค่าละติจูดและลองจิจูดด้วย คอมมา คั่นพิกัดด้วยอักขระไปป์ "|" เช่น: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

ตัวอย่าง

คำขอต่อไปนี้จะแสดงผลชุดส่วนถนนตามรายการพิกัดที่ระบุ

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

คำตอบ

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

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

คำตอบใช้สคีมาต่อไปนี้

NearestRoadsResponse

ช่อง ต้องระบุ ประเภท คำอธิบาย
ไม่บังคับ Array<SnappedPoint>

อาร์เรย์ของจุดที่ Snap บางครั้งอาจมีจุดที่ Snap หลายจุดสำหรับจุดเดียวกันที่มี placeId หรือตำแหน่งต่างกัน

ดูข้อมูลเพิ่มเติมที่ SnappedPoint

SnappedPoint

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ LatitudeLongitudeLiteral ดูข้อมูลเพิ่มเติมที่ LatitudeLongitudeLiteral
ต้องระบุ สตริง

ตัวระบุที่ไม่ซ้ำกันสำหรับสถานที่ รหัสสถานที่ทั้งหมดที่แสดงผลโดย Roads API จะสอดคล้องกับส่วนถนน

ไม่บังคับ ตัวเลข

จำนวนเต็มที่ระบุค่าที่สอดคล้องกันในคำขอเดิม ค่าแต่ละค่าในคำขอควรจับคู่กับค่าที่ Snap ใน คำตอบ อย่างไรก็ตาม หากคุณตั้งค่า interpolate=true หรือใช้ถนนที่ใกล้ที่สุด คำตอบอาจมีพิกัดมากกว่าคำขอ ค่าที่ประมาณขึ้นจะ ไม่มี originalIndex ค่าเหล่านี้จะจัดทำดัชนี จาก 0 ดังนั้นจุดที่มี originalIndex เป็น 4 จะเป็นค่าที่ Snap ของละติจูด/ลองจิจูดที่ 5 ที่ส่งผ่านไปยังพารามิเตอร์ path จุดถนนที่ใกล้ที่สุด อาจมีหลายจุดสำหรับพิกัดเดียวที่มี ตำแหน่งหรือ placeId ต่างกัน

LatitudeLongitudeLiteral

ออบเจ็กต์ที่อธิบายตำแหน่งที่เฉพาะเจาะจงด้วยละติจูดและลองจิจูดเป็น องศาทศนิยม

ช่อง ต้องระบุ ประเภท คำอธิบาย
ต้องระบุ ตัวเลข

ละติจูดเป็นองศาทศนิยม
ต้องระบุ ตัวเลข

ลองจิจูดเป็นองศาทศนิยม