أقرب الطرق

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

LatitudeLongitudeLiteral

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

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

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

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