نقل البيانات من إصدار "معاينة"

تم إصدار Routes API كإصدار تجريبي متاح للجميع (قبل الإصدار العلني) في أيلول (سبتمبر) 2022. تخضع "عروض مرحلة ما قبل الإطلاق" لأحكام الخاصة بخدمة "منصّة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

يوضِّح هذا القسم كيفية نقل بيانات تطبيق من إصدار المعاينة إلى إصدار الإصدار العلني.

الميزات الجديدة التي تمت إضافتها إلى إصدار "إحصاءات Google"

يضيف الإصدار العلني الميزات الجديدة التالية التي لم يتم تضمينها في الإصدار المخصّص للاطّلاع:

  • بالإضافة إلى أرقام تعريف الأماكن وإحداثيات خطوط الطول والعرض، يمكنك الآن تحديد موقع جغرافي في إصدار "إحصاءات Google" باستخدام:

    • سلاسل العناوين ("القاهرة، مصر" أو "الإسكندرية، مصر")

      غالبًا ما تكون سلاسل العناوين هي الطريقة التي يُدخل بها المستخدم العنوان. ومع ذلك، يجب أن يُشفِّر {product_name} سلسلة العنوان داخليًا أولاً لتحويل ها إلى إحداثيات خط العرض/الطول قبل أن يتمكّن من احتساب مسار.

      بالإضافة إلى ذلك، تمت إضافة ميزة تتيح استخدام مَعلمة الطلب regionCode، ما يتيح لك تحديد عرض نتائج مُشفَّرة جغرافيًا لمنطقة جغرافية معيّنة.

    • رموز المواقع المفتوحة

      رموز المواقع المفتوحة هي بمثابة عناوين الشوارع، لكنها مخصّصة للأشخاص أو الأماكن التي ليس لها عنوان. وبدلاً من العناوين التي تحتوي على أسماء الشوارع وأرقامها، تستند رموز المواقع المفتوحة إلى خطوط الطول والعرض وتظهر كأرقام وحروف.

  • يحتوي ردّ احتساب المسارات الآن على صفيف geocodingResults. بالنسبة إلى كل موقع جغرافي في الطلب (المصدر أو الوجهة أو نقطة الطريق الوسيطة) الذي تم تحديده كـ سلسلة عنوان أو رمز موقع مفتوح، تُجري واجهة برمجة التطبيقات عملية بحث عن معرّف مكان. يحتوي كل عنصر من هذا الصفيف على معرّف المكان المرتبط بموقع جغرافي بالإضافة إلى بيانات وصفية إضافية عن الموقع الجغرافي. يتم تجاهل المواقع الجغرافية في الطلب التي تم تحديدها كمعرّف مكان أو كإحداثيات خطوط العرض/الطول.

التغييرات على ميزات "الإصدار التجريبي" الحالية

عليك الآن تفعيل الميزات التالية في "إحصاءات Google" صراحةً من خلال إضافة حقل الصفيف الجديد extraComputations إلى الطلب:

في الإصدار التجريبي، استخدمت قناع حقل لتحديد عرض معلومات عن هذه الميزات في الردّ. الآن، عليك إجراء ما يلي:

  • اضبط مَعلمة طلب صفيف extraComputations الجديدة لتفعيل هذه الميزات.
  • اضبط قناع حقل لتحديد عرض المعلومات في الاستجابة.

ما هي المعلومات التي يجب معرفتها؟

لن يتمّ تضمين الحقول التالية في ردود computeRouteMatrix ما لم يتمّ تفعيلها صراحةً من خلال ضبط extraComputations:

  • travelAdvisory.tollInfo (معلومات حول الرسوم)

لن يتم تضمين الحقول التالية في ردود computeRoutes ما لم يتم تفعيلها صراحةً من خلال الإعداد extraComputations:

  • routes.legs.travelAdvisory.tollInfo(معلومات حول الرسوم)
  • routes.travelAdvisory.tollInfo(معلومات حول الرسوم)
  • routes.travelAdvisory.fuelConsumptionMicroliters(استهلاك الوقود)
  • routes.travelAdvisory.speedReadingIntervals(حركة المرور على خط متعدد)
  • routes.legs.travelAdvisory.speedReadingIntervals(حركة المرور على خط متعدد)

ما هو الإجراء الواجب اتّخاذه؟

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