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

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

אם אתם עובדים עם נקודות GPS עוקבות, השתמשו ב-Snap to Roads.

בקשות

בקשה ל-Nearest 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 תואמים לקטעי כביש.

אופציונלי number

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

LatitudeLongitudeLiteral

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

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

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

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