العمل مع عارض شاشة المعلومات الثلاثية الأبعاد

إذا لم تتمكّن من دمج منتج عرض تابع لجهة خارجية في فقد تضطر إلى إنشاء عارض المربعات ثلاثية الأبعاد الخاص بك. هذا النمط وضع العوامل المهمة التالية في الاعتبار:

عناوين URL للمحتوى

عند عرض مربّعات الصور الواقعية ثلاثية الأبعاد، تعرض واجهة برمجة التطبيقات Map Tiles API معرِّفات الموارد المنتظمة (URI) مجموعات شاشات الأطفال. معرّفات الموارد المنتظمة (URI) لمجموعة الفئات هذه ليست عناوين URL عادية. وهي تشمل فقط مكون المسار والمعلمات. ولا تحتوي هذه الطلبات على مفتاح واجهة برمجة التطبيقات، وهو خطوة ضرورية لمنح الإذن بطلبك. لمزيد من المعلومات، يُرجى الاطّلاع على مواصفات الشاشات الثلاثية الأبعاد

الطلبات والردود

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

نموذج طلب مجموعة أجزاء الجذر:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

نموذج معرّف الموارد المنتظم (URI) لاستجابة مجموعة المربّعات:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

نماذج عناوين URL لطلبات المربّعات التي تستخدمها العارضون:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

يجب إرفاق أي معلمات تظهر في عنوان URI لمجموعة الفئات، إلى جانب مفتاح واجهة برمجة التطبيقات، عند إنشاء طلبات التجانب اللاحقة. واجهة 3D Tiles API توفير المعلمتَين التاليتَين:

session
معرّف مضمّن لجلسة تحميل ثلاثي الأبعاد. يتم إنشاؤها تلقائيًا بواسطة واجهة برمجة التطبيقات. ويجب أن يتم إرفاقه بواسطة العارض عند إنشاء ملف طلبات المربّعات.
key
مفتاح واجهة برمجة التطبيقات الذي استخدمته للوصول إلى خدمة 3D Tiles يجب إرفاقه بـ جميع طلبات التجانب اللاحقة.

عمليات تحديد المصدر على الشبكة الإعلانية

يشير تحديد المصدر إلى الإقرار بمصدر مربّعات الخريطة، وهو شرط لاستخدام واجهة برمجة التطبيقات هذه، ويشمل ذلك تحديد مصدر العلامة التجارية لشركة Google (الشعار) بالإضافة إلى تحديد مصدر البيانات. يتوفر شعار Google لك على سياسات واجهة برمجة تطبيقات الخرائط (Map Tiles API). البيانات يتم عرض معلومات الإحالة في كل رد مقسّم. يمكنك البحث عنها في نص الاستجابة، في JSON ضمن asset.copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

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

  1. استخراج جميع معلومات حقوق الطبع والنشر من جميع المربّعات المعروضة

  2. افصل بين مصادر حقوق الطبع والنشر المتعددة باستخدام فاصلة منقوطة.

  3. رتِّب المعلومات استنادًا إلى عدد مرات الورود.

  4. اعرض مصادر حقوق الطبع والنشر على الشاشة، مرتَّبة من معظم مواضع الورود إلى على الأقل، على غرار الطريقة Google Earth تفعل ذلك.