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

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

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

عند عرض "المربّعات الثلاثية الأبعاد لصور واقعية"، تُرجِع Map Tiles API معرّفات الموارد المنتظمة (URI) لمجموعات مربّعات السطح الفرعية. إنّ عناوين URL الخاصة بمجموعات الأشكال الأرضية هذه ليست عناوين 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

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

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

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

يشير تحديد المصدر إلى الإقرار بمصدر مربّعات الخريطة، وهو شرط لاستخدام واجهة برمجة التطبيقات هذه، ويشمل ذلك تحديد مصدر العلامة التجارية لشركة Google (الشعار) بالإضافة إلى تحديد مصدر البيانات. يمكنك العثور على شعار Google في صفحة سياسات Map Tiles API. يتم عرض معلومات تحديد مصدر البيانات في كل استجابة مربّع. ابحث عنه في شريحة glTF، ضمن 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