إذا لم تتمكن من دمج منتج عرض تابع لجهة خارجية في الحل، قد تضطر إلى إنشاء عارض "المربّعات الثلاثية الأبعاد" الخاص بك. يتطلب هذا النهج مراعاة العوامل المهمة التالية:
عناوين 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 لك على صفحة
سياسات واجهة برمجة التطبيقات لمربّعات الخرائط. يتم عرض معلومات إحالة
البيانات في كل استجابة مربّعة. ابحث عنه في نص الاستجابة، في JSON ضمن asset.copyright.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
ويجب تجميع هذه المعلومات وفرزها وعرضها في سطر من النص، عادةً ما يكون في أسفل العرض. يستلزم ذلك اتخاذ الخطوات التالية:
يمكنك استخراج كل معلومات حقوق الطبع والنشر من كل المربّعات التي تظهر في العرض.
افصل بين مصادر حقوق الطبع والنشر المتعددة باستخدام فاصلة منقوطة.
رتِّب المعلومات استنادًا إلى عدد مرات الورود.
اعرض مصادر حقوق الطبع والنشر على الشاشة، مرتّبةً من الأكثر حدوثًا إلى الأقل، على نحو يشبه طريقة عرض Google Earth لها.