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

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

หากคุณทำงานกับจุด GPS ตามลำดับ ให้ใช้ Snap to Roads

คำขอ

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

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

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

คะแนน

จุดที่จะสแนป พารามิเตอร์ 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>

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

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

SnappedPoint

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

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

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

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

LatitudeLongitudeLiteral

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

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

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

ลองจิจูดในหน่วยองศาทศนิยม