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

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

หากคุณกำลังทำงานกับจุด GPS ที่ต่อเนื่องกัน ให้ใช้สแนปกับถนน

คำขอ

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

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

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

  • คะแนน

    จุดที่จะสแนป พารามิเตอร์จุดจะยอมรับรายการคู่ละติจูด/ลองจิจูด คั่นค่าละติจูดและลองจิจูดด้วยเครื่องหมายคอมมา คั่นพิกัดด้วยอักขระไปป์ "|" เช่น 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 ซึ่งส่งไปยังพารามิเตอร์เส้นทาง ถนนที่ใกล้ที่สุด อาจมีหลายจุดสำหรับพิกัดเดียวที่มี สถานที่ตั้งหรือ placeId แตกต่างกัน

LatitudeLongitudeLiteral

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

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

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

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