أقرب الطرق

تستغرق 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 ستكون القيمة المطابقة لخط العرض/خط الطول الخامس الذي تم تمريره إلى مَعلمة المسار. قد تحتوي نقاط Nearest Roads على عدة نقاط لإحداثيات فردية بموقع جغرافي أو معرّف مكان مختلف.

LatitudeLongitudeLiteral

كائن يصف موقعًا جغرافيًا محدّدًا باستخدام خطوط الطول والعرض بالدرجات العشرية.

الحقل مطلوب النوع الوصف
مطلوب الرقم

خط العرض بالدرجات العشرية
مطلوب الرقم

خط الطول بالدرجات العشرية