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

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

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

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

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

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

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

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

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

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

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

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

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

يجب الآن تفعيل الميزات التالية بوضوح في "إحصاءات 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 لتضمين قيمة واحدة أو أكثر من القيم التالية: