أقرب الطرق

يمكن أن تتضمّن السمة 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>

مصفوفة من النقاط المحاذية في بعض الأحيان، يحتوي على عدة نقاط محاذية لنفس النقطة مع اختلاف في رقم تعريف المكان أو الموقع الجغرافي.

راجِع SnappedPoint لمزيد من المعلومات.

SnappedPoint

الحقل مطلوب النوع الوصف
مطلوب LatitudeLongitudeLiteral يُرجى الاطّلاع على LatitudeLongitudeLiteral لمزيد من المعلومات.
مطلوب سلسلة

تمثّل هذه السمة معرّفًا فريدًا للمكان. تتطابق جميع أرقام تعريف الأماكن التي تعرضها Roads API مع أجزاء الطرق.

اختياري الرقم

عدد صحيح يشير إلى القيمة المقابلة في الطلب الأصلي. يجب أن تكون كل قيمة في الطلب مرتبطة بقيمة محددة في الرد. ومع ذلك، إذا ضبطت interpolate=true أو كنت تستخدم أقرب الطرق، من المحتمل أن يتضمّن الردّ إحداثيات أكثر من الطلب. لن تحتوي القيم التي تم إدخالها على originalIndex. يتم فهرسة هذه القيم بدءًا من 0، لذا ستكون النقطة التي تحمل originalIndex بقيمة 4 هي القيمة المحاذية لخط العرض/الطول الخامس الذي تم تمريره إلى مَعلمة المسار. قد تحتوي نقاط Nearest Roads على عدة نقاط لإحداثيات فردية مع اختلاف في الموقع الجغرافي أو رقم تعريف المكان.

LatitudeLongitudeLiteral

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

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

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

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