يسرد هذا المستند متطلبات التطبيقات التي تم تطويرها باستخدام 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"، يُرجى اتّباع الإرشادات التالية.
- لا تعدِّل الشعار بأي شكل من الأشكال.
- يجب الحفاظ على نسبة العرض إلى الارتفاع للشعار لتجنُّب تشويهه.
- استخدِم الشعار المحدّد على خلفية مزدحمة، مثل خريطة أو صورة.
- استخدِم الشعار غير المحدّد على خلفية عادية، مثل لون واحد أو تدرج خفيف.
مواصفات حجم الشعار
اتّبِع مواصفات الحجم التالية لشعار "خرائط Google":
- الحدّ الأدنى لارتفاع الشعار: 16 بكسل مستقل الكثافة
- الحد الأقصى لارتفاع الشعار: 19 بكسل مستقل الكثافة
- الحد الأدنى للمساحة الخالية حول الشعار: 10 بكسل مستقل الكثافة على اليسار واليمين والأعلى، و5 بكسل مستقل الكثافة في الأسفل
لمزيد من المعلومات حول وحدات البكسل المستقلة عن الكثافة، يُرجى الاطّلاع على كثافة البكسل على موقع "التصميم المتعدد الأبعاد" الإلكتروني.
تسهيل استخدام الشعار
اتّبِع متطلبات تسهيل الاستخدام التالية لشعار "خرائط Google":
- الحفاظ على تباين مناسب بين الشعار والخلفية
- يجب تضمين تصنيف تسهيل الاستخدام مع النص خرائط Google.
عرض شعار "خرائط Google" مع أدوات عرض تابعة لجهات خارجية
عند استخدام Map Tiles API لعرض "خرائط 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",
…
}
يُستثنى رقم تعريف البانوراما، الذي يُستخدَم لتحديد بانوراما في "التجوّل الافتراضي" بشكل فريد، من قيود التخزين المؤقت. لذلك، يمكنك تخزين قيم معرّفات الصور البانورامية
إلى أجل غير مسمى. يتم عرض قيم معرّف البانوراما في الحقل 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 كأداة عرض، عليك تفعيل حقل عرض المساهمين على الشاشة في World Outliner لعرض معلومات المساهمين.
Cesium for Unity
إذا كنت تستخدم Cesium for Unity كأداة عرض، عليك تفعيل حقل عرض المساهمين على الشاشة في وحدة تحكّم "المفتّش" لعرض معلومات المساهمين.
