يتم استخدام واجهة مخزن البروتوكول المؤقت في semantictileapi.proto من قِبل حزمة تطوير البرامج (SDK) في Unity لاسترداد موارد مربّعات الميزات والتضاريس. يجب أن تنفذ الخدمة البديلة
واجهة برمجة التطبيقات هذه. تم تضمين مثال لخادم Python لتوضيح كيفية تمرير المعلمات عبر SDK وكيفية تكوين الاستجابة للتوافق مع SDK.
يحتوي الأرشيف على الملفات التالية:
semantictileapi.protoهو تعريف للمخزن المؤقت للبروتوكولات والذي تستخدمه حزمة Unity SDK لاسترداد موارد مربّعات الميزات والتضاريس.server.pyهو مثال على خادم يوضّح تسلسل مخزن البروتوكولات المؤقت والعرض المتوافق مع حزمة تطوير البرامج (SDK).يتكوّن
BUILD.bazelوWORKSPACE.bazelمعًا من مشروع Bazel الذي يمكنك استخدامه لإنشاء روابط المخزن المؤقت للبروتوكولات لـ Python. يمكنك الانتقال إلى https://bazel.build/ لمزيد من المعلومات حول كيفية تثبيت Bazel واستخدامه.يعرض
example_tiles.pyبعض الأمثلة حول كيفية إنشاءFeatureTilesوTerrainTilesباستخدام بايثون.
كيفية العرض
بعد تثبيت Bazel، يمكنك ببساطة تنفيذ الأمر التالي لإنشاء الخادم وتشغيله:
> bazel run server
إذا كنت لا ترغب في تثبيت Bazel، يمكنك أيضًا إنشاء مكتبة مخزن مؤقت لبروتوكول Python باستخدام ProOC. راجع أساسيات بروتوكول التخزين المؤقت: Python للحصول على معلومات حول كيفية استخدام أداة proوتو، علمًا أنّنا ننصح باستخدام Bazel لإنشاء هذا المثال.
يمكنك إرسال طلب إلى الخادم قيد التشغيل باستخدام cURL:
> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=proto' --output test_feature
> curl 'localhost:8000/terraintiles/@120588,78656,17z?alt=proto' --output test_terrain
إذا كنت تريد عرض تنسيق يمكن للمستخدمين قراءته، استخدِم alt=json.
> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=json'
يمكنك العثور على مزيد من المعلومات حول تنسيقات مربعات الميزة والتضاريس في تعليقات semantictileapi.proto.