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

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

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

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

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

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

    • سلاسل العناوين ("شيكاغو، إلينوي" أو "دارون، الإقليم الشمالي، أستراليا")

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

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

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

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

  • يحتوي الاستجابة لاحتساب المسارات الآن على المصفوفة 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، لتضمين واحدة أو أكثر من القيم التالية: