أقرب الطرق

تستغرق واجهة برمجة التطبيقات 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

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

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

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

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