הכבישים הקרובים ביותר

הפונקציה Roads API מקבלת עד 100 קואורדינטות עצמאיות ומחזירה את קטע הכביש הקרוב ביותר לכל נקודה. הנקודות לא צריכות להיות חלק מנתיב רציף.

אם אתם עובדים עם נקודות GPS עוקבות, כדאי להשתמש באפשרות הצמדה לכבישים.

בקשות

בקשה לחיפוש הכבישים הקרובים ביותר צריכה להישלח באמצעות 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 מתייחסים לקטעי כביש.

אופציונלי number

מספר שלם שמציין את הערך התואם בבקשה המקורית. כל ערך בבקשה צריך להתמפות לערך מעוגל בתשובה. עם זאת, אם הגדרתם interpolate=true או אם אתם משתמשים ב-nearest roads, יכול להיות שהתגובה תכיל יותר קואורדינטות מהבקשה. לערכים שעברו אינטרפולציה לא יהיה originalIndex. הערכים האלה ממוספרים מ-0, כך שנקודה עם originalIndex של 4 תהיה הערך המוצמד של קו הרוחב או קו האורך החמישי שמועבר לפרמטר של הנתיב. הנקודות של Nearest Roads יכולות להכיל כמה נקודות לקואורדינטות יחידות עם מיקום או placeId שונים.

LatitudeLongitudeLiteral

אובייקט שמתאר מיקום ספציפי עם קו רוחב וקו אורך במעלות עשרוניות.

שדה חובה סוג תיאור
חובה number

קו רוחב במעלות עשרוניות
חובה number

קו אורך במעלות עשרוניות