أقرب الطرق

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

LatitudeLongitudeLiteral

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

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

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

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