الانتقال

الانتقال من تكامل الارتفاع في Bing Maps

تقدّم Bing Maps بيانات الارتفاع عبر Elevations API الخاصة بها، وتُرجع قيم ارتفاع سطح الأرض لنقطة إحداثيات واحدة أو أكثر، بالأمتار عادةً، كجزء من حساب Bing Maps Dev Center الأوسع نفسه المستخدم للترميز الجغرافي وخدمات الموقع الأخرى. وكمعظم الاعتماديات المتعلقة بالارتفاع، تُستدعى عادةً من جزء ضيق من التطبيق: مخطط مقطع مسار، أو طبقة تضاريس، أو أداة لتخطيط الرحلات الجوية، وليست شيئًا منسوجًا في أنحاء قاعدة الكود.

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

الاستعلام عن الارتفاع في My Geocode نقطة نهاية مستقلة تعمل بالكامل، موثقة في /docs/elevation-lookup/، ومستقلة عن أي مضيف متوافق للترميز الجغرافي. يُرجع الطلب لإحداثية ما ارتفاع سطح الأرض مباشرة، ولأن هذا من الاستعلامات التي يمكن فيها وصف النتائج الحقيقية واختبارها بشكل ملموس، فإن التحقق من الترحيل مقابل عدد قليل من نقاط الارتفاع المرجعية المعروفة طريقة عملية وسريعة لبناء الثقة.

أمور تستحق التحقق تحديدًا عند الانتقال من خدمة الارتفاع في Bing:

  • ما إذا كان تطبيقك يطلب الارتفاع على دفعات (عدة إحداثيات في كل استدعاء)، وإن كان كذلك، فاختبر نقطة النهاية الجديدة بحجم الدفعة المعتاد لديك قبل افتراض إنتاجية مطابقة
  • ما إذا كانت اصطلاحات الوحدات مهمة في أي مكان لاحق، لأن قيم الارتفاع بالأمتار هي المعيار، لكن أي كود يحوّلها إلى أقدام للعرض يجب التحقق منه مقابل المخرجات الخام لنقطة النهاية الجديدة
  • ما إذا كانت استدعاءات الارتفاع تحدث بشكل متزامن كجزء من طلب يواجه المستخدم أو بشكل غير متزامن كجزء من معالجة في الخلفية، لأن ذلك يؤثر على مدى تحمّل زمن الاستجابة الذي تحتاج فعلًا إلى اختباره

تقبل المصادقة في نقطة النهاية الجديدة مفتاحًا في X-API-Key، أو Authorization: Bearer، أو عبر مصادقة HTTP Basic، أو كمعامل في الاستعلام. ويتبع التسعير البنية الثابتة نفسها لكل نقطة نهاية أخرى: 2,500 طلب مجاني يوميًا دون مفتاح، و2,500 طلب مجاني إضافي لكل مفتاح يوميًا يُحتسب لكل شبكة، ثم رصيد مسبق الدفع بسعر 0.0001 € لكل طلب أو مفتاح Unlimited بسعر 50 € شهريًا.

إذا كان الارتفاع مدمجًا في الأصل ضمن حساب Bing Maps أوسع للراحة غالبًا وليس للضرورة، فإن نقله أولًا، قبل ترحيل الترميز الجغرافي، يقلل مساحة ما لا يزال يعتمد على الحساب الأصلي ويمنحك تجربة منخفضة المخاطر لعملية الترحيل قبل التعامل مع أي شيء أكبر.