يسرد هذا المستند متطلبات التطبيقات التي تم تطويرها باستخدام Map Tiles API. يُرجى العِلم أنّ استخدام Map Tiles API يخضع لاتفاقيتك مع Google.
السياسات
يوضّح هذا القسم السياسات ذات الصلة بواجهة Map Tiles API. توفّر السياسات إرشادات ومتطلبات عملية للتنفيذ لمساعدتك في استخدام الخدمة بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".
الجلب المسبق للمحتوى أو تخزينه مؤقتًا أو تخزينه
تلتزم التطبيقات التي تستخدم Map Tiles API ببنود اتفاقيتك مع Google. بموجب بنود "الاتفاقية"، يجب عدم إجراء أي عملية جلب مسبق أو فهرسة أو تخزين أو تخزين مؤقت لأي "محتوى" إلا بموجب الشروط المحدودة الواردة في البنود.
على وجه التحديد، يجب أن تستخدم التطبيقات واجهة برمجة التطبيقات Map Tiles API لعرض الخرائط بشكل مرئي. لا يجوز لك استخدام Map Tiles API لأي حالات استخدام غير مرئية، مثل:
- تحليل الصور
- التفسير الآلي
- رصد الأجسام أو التعرّف عليها
- استخراج البيانات الجغرافية أو إعادة بيعها
- الاستخدامات بلا إنترنت، بما في ذلك أي من الحالات المذكورة أعلاه
قد تتضمّن استجابات Map Tiles API عناوين Cache-Control يجب تنفيذها وفقًا لمستندات بروتوكول HTTP. على سبيل المثال، يجب أن يلتزم العميل بالقيمة max-age والقيمة stale-while-revalidate والتوجيه must-revalidate والتوجيه private عند تمريرها في الردّ.
قد تتضمّن استجابات Map Tiles API أيضًا عنوان ETag، والذي يجب تنفيذه أيضًا وفقًا لمستندات بروتوكول HTTP عند طلب إعادة التحقّق.
طباعة
لا يجوز استخدام صور "التجوّل الافتراضي" لأغراض الطباعة، كما هو موضّح في سياسات "التجوّل الافتراضي".
بلدان ومناطق المنطقة الاقتصادية الأوروبية
يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان فوترة في المنطقة الاقتصادية الأوروبية، وقد يتضمّن أيضًا وظائف مختلفة. قبل البدء في إنشاء تطبيقات باستخدام "منصة خرائط Google"، راجِع البنود والمعلومات التالية الخاصة بالمنطقة الاقتصادية الأوروبية:
- بنود خدمة "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية
- البنود الخاصة بالخدمة في المنطقة الاقتصادية الأوروبية في "منصة خرائط Google"
- الأسئلة الشائعة حول المنطقة الاقتصادية الأوروبية
- متطلبات السلامة على الطرق في "منصة خرائط Google"
إذا لم يكن عنوان إرسال الفواتير في المنطقة الاقتصادية الأوروبية، تسري عليك بنود الخدمة التالية:
عرض مصدر البيانات في "خرائط Google"
يجب تضمين إشارة واضحة إلى مصدر المحتوى من "منصة خرائط Google" عند عرض المحتوى من واجهات برمجة التطبيقات الخاصة بالمنصة في تطبيقك أو موقعك الإلكتروني. يجب أن يكون مصدر المحتوى على شكل شعار "خرائط Google" كلما أمكن ذلك. في الحالات التي تكون فيها المساحة محدودة، يمكن استخدام النص خرائط Google.
تحديد مصدر الشعار
شعار "خرائط Google"
استخدِم شعارات "خرائط Google" الرسمية المتوفّرة أدناه.
تنزيل مواد العرض الخاصة بالإحالة إلى المصدر في "خرائط Google"
عند استخدام شعار "خرائط Google"، يُرجى اتّباع الإرشادات التالية.
- لا تعدّل الشعار بأي شكل من الأشكال.
- يجب الحفاظ على نسبة العرض إلى الارتفاع للشعار لتجنُّب تشوّهه.
- استخدِم الشعار المخطّط على خلفية متعددة التفاصيل، مثل خريطة أو صورة.
- استخدِم الشعار غير المحدّد بخطوط على خلفية بسيطة، مثل لون واحد أو تدرّج لوني خفيف.
مواصفات حجم الشعار
اتّبِع مواصفات الحجم التالية لشعار "خرائط Google":
- الحدّ الأدنى لارتفاع الشعار: 16dp
- الحد الأقصى لارتفاع الشعار: 19dp
- الحد الأدنى للمساحة الخالية حول الشعار: 10 وحدات بكسل مستقلة عن الكثافة على اليمين واليسار والأعلى، و5 وحدات بكسل مستقلة عن الكثافة في الأسفل
لمعرفة المزيد عن وحدات البكسل المستقلة الكثافة، يمكنك الاطّلاع على كثافة البكسل على موقع Material Design الإلكتروني.
إمكانية الوصول إلى الشعار
اتّبِع متطلبات تسهيل الاستخدام التالية لشعار "خرائط Google":
- الحفاظ على تباين يسهل الوصول إليه بين الشعار والخلفية
- أدرِج تصنيفًا مناسبًا لذوي الاحتياجات الخاصة مع النص خرائط Google.
عرض شعار "خرائط Google" مع أدوات العرض التابعة لجهات خارجية
عند استخدام Map Tiles API لعرض "خرائط Google" باستخدام أداة عرض تابعة لجهة خارجية، يجب عدم تداخل شعار Google مع أي شعار آخر، مثل شعار أداة العرض، أو حجب شعار Google بأي شعار آخر. الحفاظ على مسافة فاصلة معقولة بين شعار Google وشعار الجهة الخارجية لكي يظهران كشعارين مستقلين لا يجوز أن يتداخل أي شعار مع بيانات تحديد المصدر المقدَّمة من خلال استجابة واجهة برمجة التطبيقات أو أن يحجبها.
عرض إحالات بيانات Google
تتطلّب البيانات التي يتم عرضها من Map Tiles API عرض معلومات المصدر وحقوق الطبع والنشر من البيانات الوصفية المناسبة أو طلبات معلومات إطار العرض. يجب عرض هذه المعلومات كاملةً في المكان المناسب، وعادةً ما يكون ذلك في الزاوية السفلية اليسرى من مجموعة المربّعات المعروضة أو في عرض أداة العرض ثلاثية الأبعاد. يُرجى العِلم أنّ سلاسل تحديد المصدر متغيرة، وذلك حسب بيانات الخريطة التي يطلبها إطار عرض أداة العرض.
إذا كان من غير العملي عرض بيانات تحديد المصدر بالكامل بسبب قيود حجم إطار العرض، ننصحك بإضافة عنصر واجهة مستخدم يمكن النقر عليه أو تمرير مؤشر الماوس فوقه، ويحمل التصنيف "مصادر البيانات"، ويتم فتحه ضمن نافذة الخريطة لتوفير معلومات تحديد المصدر. احرص دائمًا على اتّباع أفضل الممارسات المتعلقة برسم الخرائط.
عرض بيانات الإحالة الخاصة بالجهات الخارجية
تأتي بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات تحديد المصدر المطلوبة لمزوّد بيانات تابع لجهة خارجية. وفي هذه الحالة، يجب أن يتضمّن نص الإشارة إلى المصدر الاسم "خرائط Google" ومزوّدي البيانات المعنيين، مثل "بيانات الخرائط: Google وMaxar Technologies". عندما تقدّم Google إسنادًا إلى جهة خارجية، لا يكفي تضمين "خرائط Google" أو شعار Google فقط.
عند استخدام Map Tiles API لعرض بيانات "خرائط Google" كخريطة أساسية وتراكب بيانات جغرافية مكانية تابعة لجهة خارجية (غير تابعة لـ Google)، يجب عدم تداخل أو حجب بيانات تحديد المصدر الخاصة بـ Google بأي شكل من الأشكال مع بيانات تحديد المصدر الخاصة بالبيانات التابعة لجهة خارجية. يجب أن يتم الفصل بوضوح بين تحديد المصدر الخاص ببيانات الجهات الخارجية وتحديد المصدر الخاص ببيانات Google. بالإضافة إلى ذلك، يجب أن يكون من الواضح أنّ شعار "خرائط Google" وبيانات تحديد المصدر من Google مرتبطان بالخريطة الأساسية وببعضهما البعض.
عرض الشعار وإحالات البيانات في العروض المرئية المختلطة
عند استخدام بيانات "خرائط Google" كخريطة أساسية أثناء إضافة بيانات الخريطة الخاصة بك، عليك التأكّد من أنّ جمهورك يفهم تمامًا الجزء الذي يعود مصدره إلى Google والجزء الذي يعود مصدره إلى بيانات الخريطة الخاصة بك. بالإضافة إلى ذلك، اتّبِع الإرشادات الواردة في القسم عرض معلومات المصدر في "خرائط Google" أعلاه.
على سبيل المثال، يمكنك دمج "مربّعات ثلاثية الأبعاد لصور واقعية" (كعناصر خلفية) مع نماذجك الخاصة التي تتضمّن صورًا واقعية (في المقدّمة). قد يشعر المستخدمون بالارتباك بشأن المكوّنات التي تم استخلاصها من بيانات "خرائط Google". في مثل هذه الحالات، يجب أن توضّح في سلسلة تحديد المصدر في واجهة المستخدم أو مسار المستخدم الجزء من المشهد الذي مصدره بيانات "خرائط Google". تتحمّل أنت مسؤولية الامتثال لأي متطلبات تحديد مصدر تابعة لجهات خارجية قد تنطبق على مصادر البيانات التي تستخدمها مع بيانات "خرائط Google".
تراكبات البيانات الجغرافية مع مربّعات ثلاثية الأبعاد لصور واقعية
يمكنك إضافة عناصر ثلاثية الأبعاد خاصة بك إلى "مربّعات ثلاثية الأبعاد لصور واقعية"، شرط ألا يتم استخراج العناصر الثلاثية الأبعاد أو تتبُّعها أو اشتقاقها بأي طريقة أخرى يدويًا أو آليًا من "مربّعات ثلاثية الأبعاد لصور واقعية".
إنشاء فيديوهات باستخدام Map Tiles API
- الفيديوهات الترويجية: يمكنك إنشاء فيديوهات ترويجية وفقًا لبنود الاتفاقية والشروط التالية:
- يجب ألا يتضمّن الفيديو الترويجي صور "التجوّل الافتراضي".
- يجب ألا تزيد مدة الفيديو الترويجي عن 30 ثانية.
- يجب أن يتناول الفيديو الترويجي إمكانات تطبيقاتك.
- يجب أن يكون الفيديو الترويجي مصنّفًا بوضوح على أنّه "لأغراض ترويجية فقط"، وأن يلتزم بإرشادات إحالة المصدر في "شبكة Google الإعلانية".
- لا يجوز إعادة بيع الفيديو الترويجي بشكل منفصل أو كجزء من البرنامج أو التطبيق أو تجربة المستخدم.
- إزالة المحتوى: أنت المسؤول عن الامتثال لجميع طلبات إزالة الفيديو الترويجي، بما في ذلك الطلبات الواردة من جهات خارجية.
استرداد معلومات المصدر وحقوق الطبع والنشر
يمكنك الحصول على معلومات تحديد المصدر وحقوق الطبع والنشر من الحقل copyright في ردود طلبات البيانات من واجهات برمجة التطبيقات التالية، وذلك حسب الخدمة التي تستخدمها:
مربّعات ثنائية الأبعاد
مربّعات "خريطة الطريق" و"القمر الصناعي" و"التضاريس"
تتوفّر معلومات حقوق الطبع والنشر ومعلومات تحديد المصدر من خلال الردّ على طلب معلومات حول نافذة العرض، كما هو موضّح في المثال التالي.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
مربّعات في "التجوّل الافتراضي"
تتوفّر معلومات حقوق الطبع والنشر ومعلومات تحديد المصدر من خلال ردّ البيانات الوصفية في "التجوّل الافتراضي". على سبيل المثال:
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
…
}
يُستثنى معرّف الصورة البانورامية، الذي يُستخدَم لتحديد صورة بانورامية في "التجوّل الافتراضي" بشكلٍ فريد، من قيود التخزين المؤقت. لذلك، يمكنك تخزين قيم أرقام تعريف الصور البانورامية إلى أجل غير مسمى. يتم عرض قيم معرّف Panorama في الحقل panoId ضمن ردود Street View Static API.
يجب عرض الرابط التشعّبي reportProblemLink في الركن السفلي الأيسر من الصورة، ويجب أن يتضمّن نص الرابط عبارة مثل "الإبلاغ عن مشكلة متعلّقة بهذه الصورة".
مربّعات ثلاثية الأبعاد لصور واقعية
بالنسبة إلى "مربّعات ثلاثية الأبعاد لصور واقعية"، يتم عرض بيانات تحديد المصدر في كل طلب مربّع.
يجب تجميع جميع بيانات المصدر الخاصة بالمربّعات المعروضة وترتيبها وعرضها في سطر واحد، ويكون ذلك عادةً في أسفل عملية العرض. على سبيل المثال، يمكنك العثور على بيانات تحديد المصدر في لوحة
glTF من خلال البحث ضمن
asset وcopyright.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
إذا كنت تستخدم CesiumJS كبرنامج عرض، عليك تفعيل showCreditsOnScreen في رمز HTML الخاص بالعرض لعرض بيانات تحديد المصدر.
// Add Photorealistic 3D Tiles tileset.
const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
// This property is needed to appropriately display attributions
// as required.
showCreditsOnScreen: true,
}));
Cesium for Unreal
إذا كنت تستخدم Cesium for Unreal كبرنامج عرض، عليك تفعيل الحقل عرض بيانات الاعتماد على الشاشة في مخطط العالم لعرض بيانات الاعتماد.
Cesium for Unity
إذا كنت تستخدم Cesium for Unity كأداة عرض، عليك تفعيل الحقل عرض بيانات الاعتماد على الشاشة في وحدة تحكّم Inspector لعرض بيانات الاعتماد.