نقاط التنقّل

هذا المنتج أو الميزة تجريبية (قبل طرحها للجميع). قد يكون الدعم المقدَّم للمنتجات والميزات في مرحلة ما قبل الإصدار العلني محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات في مرحلة ما قبل الإصدار العلني متوافقة مع الإصدارات الأخرى من مرحلة ما قبل الإصدار العلني. تخضع "عروض مرحلة ما قبل الإطلاق" لالبنود الخاصة بخدمة "منصّة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

يحتوي الحقل navigation_points ضمن استجابة ترميز الموقع الجغرافي على قائمة بنقاط مفيدة للتنقّل إلى المكان. وعلى وجه التحديد، يجب استخدامها إما كنقاط بداية أو نقاط نهاية عند تحديد مسار على شبكة طرق من مكان إلى مكان آخر. تحتوي كل نقطة تنقّل على القيم التالية:

• يحتوي العمود location على قيم خط العرض وخط الطول لنقطة التنقّل. سيكون هذا الموقع الجغرافي قريبًا جدًا من شبكة الطرق في جميع الأوقات، ويمثّل نقطة توقف أو نقطة انطلاق مثالية للتنقّل من مكان إلى آخر. يتمّ وضع النقطة عمدًا بشكل مائل قليلاً عن خط مركز الطريق لتحديد جانب الطريق الذي يقع عليه المكان بوضوح.
• restricted_travel_modes هي قائمة بوسائل النقل التي لا يمكن الوصول إلى نقطة التنقّل منها:
• "DRIVE" هو وضع التنقّل المرتبط باتجاهات القيادة.
• "WALK" هو وضع التنقّل المرتبط باتجاهات المشي.
• يحتوي الحقل road_name على اسم الطريق التي تمّت إزاحة نقطة التنقّل منها.

يتم عرض نقاط التنقّل لمعظم الأماكن التي لها موقع جغرافي دقيق، مثل عناوين الشوارع والمباني والمنشآت. قد لا تعرض الأماكن التي تمثّل مناطق كبيرة، مثل المدن والمناطق، والتي قد يكون فيها الموقع الجغرافي الدقيق غامضًا، أي نقاط تنقّل.

إشعار بشأن نقل البيانات

اعتبارًا من 17 نيسان (أبريل)، يجب الآن تقديم المَعلمة NAVIGATION_POINTS extra computations في الطلب لتلقّي نقاط التنقّل. يمكن للعملاء اختبار ذلك من خلال التأكّد من عرض الحقل road_name ضمن بعض نقاط التنقّل ومن أنّ الحقل location ضمن كل نقطة تنقّل يحتوي على الحقول الفرعية الأربعة التالية (lat وlng وlatitude وlongitude).

بالإضافة إلى ذلك، عليك نقل البيانات إلى الحقلين location.lat وlocation.lng بدلاً من الحقلين location.latitude وlocation.longitude. في إحدى الإصدارات القادمة، لن تتضمّن الطلبات التي لا تحتوي على المَعلمة NAVIGATION_POINTS عمليات حسابية إضافية أي نقاط تنقّل في الردّ، ولن يتمّ عرض الحقلين location.latitude وlocation.longitude بعد ذلك.

تفاصيل الطلب

يمكنك الحصول على نقاط التنقّل في الأنواع التالية من الطلبات:

• طلب الترميز الجغرافي
• طلب عكس الترميز الجغرافي
• طلب ترميز الموقع الجغرافي للمكان

في أيّ من هذه الطلبات، يجب تقديم المَعلمة التالية: extra_computations=NAVIGATION_POINTS.

مثال على الطلب

يستخدم طلب البحث التالي ترميز الأماكن الجغرافي للحصول على نقاط التنقّل الخاصة بأحد المطاعم في ماونتن فيو، كاليفورنيا، الولايات المتحدة:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

مثال على إجابة

يعرض الردّ من طلب البحث أعلاه صفيفًا من نقاط التنقّل:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

الملاحظات

هذه ميزة تجريبية. نرحب بملاحظاتك على العنوان التالي: [e-mail].