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

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

หากคุณใช้จุด GPS ที่เรียงตามลำดับ ให้ใช้ Snap to Roads

คำขอ

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

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

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

  • points

    จุดที่จะ 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

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

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

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

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