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

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

אופציונלי number

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

LatitudeLongitudeLiteral

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

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

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

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