سياسات واجهة برمجة تطبيقات مربعات الخرائط

يسرد هذا المستند متطلبات التطبيقات التي تم تطويرها باستخدام Map Tiles API. يُرجى العِلم أنّ استخدام واجهة برمجة التطبيقات Map Tiles API يخضع لـ "الاتفاقية" المبرمة مع Google.

تقديم بنود الاستخدام وسياسة الخصوصية

إذا طوّرت تطبيق واجهة برمجة التطبيقات Map Tiles API، عليك إتاحة بنود الاستخدام وسياسة الخصوصية في تطبيقك بما يتوافق مع الإرشادات الموضّحة في "الاتفاقية" المبرمة مع Google:

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

إنّ المكان الذي يُنصح بتوفيره بنود الاستخدام وسياسة الخصوصية يعتمد على النظام الأساسي لتطبيقك.

تطبيقات الأجهزة الجوّالة

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

تطبيقات الويب

في حال تطوير تطبيق ويب، ننصحك بتوفير رابط يؤدي إلى بنود الاستخدام وسياسة الخصوصية في تذييل موقعك الإلكتروني.

الجلب المسبق للمحتوى أو تخزينه مؤقتًا أو تخزينه

إنّ التطبيقات التي تستخدم واجهة برمجة التطبيقات Map Tiles API ملزمة بأحكام اتفاقيتك مع Google. ووفقًا لبنود الاتفاقية، لا يجوز لك جلب أي "محتوى" أو فهرسته أو تخزينه أو تخزينه مؤقتًا إلا في حالة الشروط المحدودة المنصوص عليها في البنود.

على وجه التحديد، يجب أن تستخدم التطبيقات واجهة برمجة التطبيقات Map Tiles API لمؤثرات عرض الخرائط. لا يجوز لك استخدام واجهة Maps Tiles API في أي حالات استخدام غير مرئية، مثل:

• تحليل الصور
• الترجمة الآلية
• رصد العناصر أو تحديدها
• استخراج البيانات الجغرافية أو إعادة بيعها
• الاستخدامات بلا إنترنت، بما في ذلك أي مما سبق

قد تتضمّن استجابات واجهة Map Tiles API عناوين Cache-Control التي يجب تنفيذها وفقًا لوثائق بروتوكول HTTP. على سبيل المثال، على العميل مراعاة القيمة max-age والقيمة stale-while-revalidate والتوجيه must-revalidate والتوجيه private عند تمرير هذه البيانات في الاستجابة.

قد تتضمّن استجابات واجهة Map Tiles API أيضًا عنوان ETag الذي يجب تنفيذه أيضًا وفقًا لوثائق بروتوكول HTTP عند الطلب بإعادة التحقق.

يُرجى العلم أنّ رقم تعريف المكان المستخدَم لتحديد مكان معيّن بشكل فريد معفى من قيود التخزين المؤقت. يتم عرض رقم تعريف المكان في الحقل "place_id" في ردود واجهة برمجة تطبيقات مربّعات الخرائط. اطّلِع على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.

يتم عرض شعار Google.

عند استخدام واجهة برمجة التطبيقات Maps Tiles API لعرض "خرائط Google"، عليك أيضًا عرض شعار Google على الخريطة، ولا يجوز لك تعديل الشعار بأي شكل من الأشكال. يجب وضع شعار Google في أسفل يمين الخريطة، ووضع معلومات تحديد المصدر في الزاوية اليسرى من الخريطة . لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات مركز موارد العلامة التجارية.

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

يوضح مثال الخريطة التالي شعار Google في أسفل يسار الخريطة، والإحالة في أسفل اليمين.

للاستخدام على خلفية فاتحة	للاستخدام على خلفية داكنة

يحتوي ملف ZIP التالي على شعار Google بالأحجام الصحيحة لتطبيقات الكمبيوتر المكتبي وAndroid وiOS. ولا يجوز لك تغيير حجم هذه الشعارات أو تعديلها بأي شكل من الأشكال.

تنزيل: google_logo.zip

لا تعدِّل الإحالة. لا تزِل معلومات تحديد المصدر أو تحجبها أو تقصّيها. لا يمكنك استخدام شعارات Google المضمّنة (على سبيل المثال، "هذه الخرائط من [Google_logo]").

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

تضمين مزوّدي البيانات التابعين لجهات خارجية: تأتي بعض البيانات والصور في منتجات الخرائط لدينا من مقدّمي خدمات آخرين غير Google. في حال استخدام مثل هذه الصور، يجب أن يذكر نص الإسناد اسم "Google" ومزوّدي البيانات المعنيين، مثل "بيانات الخريطة: Google, Maxar Technologies". إذا تم ذكر مزوّدي بيانات تابعين لجهة خارجية مع الصور، لا يُعدّ تضمين كلمة "Google" أو شعار Google فقط إحالة سليمة.

إذا كنت تستخدم "منصة خرائط Google" على جهاز لا يعرض عملية تحديد المصدر، يُرجى التواصل مع فريق مبيعات Google لمناقشة التراخيص المناسبة لحالة الاستخدام الخاصة بك.

عرض شعار Google باستخدام برامج عرض تابعة لجهات خارجية

عند استخدام واجهة Maps Tiles API لعرض "خرائط Google" باستخدام عارض تابع لجهة خارجية، يجب عدم تداخل شعار Google أو حجبه مع أي شعار آخر، مثل شعار العارض. يجب الحفاظ على مسافة فاصلة معقولة بين شعار Google وشعار الجهة الخارجية كي تظهر كشعارات مستقلة. لا يجوز أن يتداخل أي شعار أو يحجب إحالة البيانات التي تقدمها استجابة واجهة برمجة التطبيقات.

عرض إحالات البيانات من Google

تتطلب البيانات التي يتم عرضها من واجهة برمجة التطبيقات Map Tiles API عرض معلومات تحديد المصدر وحقوق الطبع والنشر من طلبات البيانات الوصفية أو معلومات إطار العرض المناسبة. عليك عرض هذه المعلومات بالكامل كما هو موضَّح في المكان المناسب، أو عادةً أسفل يمين مجموعة المربّعات المعروضة، أو في عرض العارض الثلاثي الأبعاد. تجدر الإشارة إلى أنّ سلاسل تحديد المصدر تتغيّر بناءً على بيانات الخريطة التي يطلبها إطار عرض العارض.

إذا لم يكن من الممكن عرض إحالات البيانات بالكامل بسبب قيود حجم إطار العرض، ننصحك بإضافة عنصر تمرير مؤشر الماوس أو عنصر في واجهة المستخدم قابل للنقر يحمل اسم "مصادر البيانات"، والذي يفتح في نافذة الخريطة لتوفير معلومات تحديد المصدر. اسعَ دائمًا إلى الحفاظ على ممارسات رسم الخرائط الجيدة.

عرض إحالات البيانات التابعة لأطراف ثالثة

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

عرض الإحالات الناجحة للشعار والبيانات في عروض مرئية مختلطة

عند استخدام بيانات "خرائط Google" كخريطة أساسية أثناء تركيب بيانات الخريطة الخاصة بك، عليك التأكّد من أنّ جمهورك يفهم تمامًا الجزء الذي يُنسب إلى Google من تصور الخريطة والأجزاء التي تُنسب إلى بيانات الخريطة. بالإضافة إلى ذلك، اتّبِع الإرشادات الواردة في عرض شعار Google أعلاه.

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

عناصر مركّبة على البيانات الجغرافية مع مربّعات واقعية ثلاثية الأبعاد

يمكنك تركيب العناصر الثلاثية الأبعاد على مربّعات واقعية ثلاثية الأبعاد ما دام لم يتم استخراج العناصر الثلاثية الأبعاد أو تتبُّعها أو اشتقاقها يدويًا أو باستخدام الآلة من الشاشات الثلاثية الأبعاد ذات الصور الواقعية.

أداة إنشاء فيديوهات تعرض ميزة Map Tiles API

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

استرداد معلومات الإسناد وحقوق الطبع والنشر

احصل على معلومات عن حقوق الطبع والنشر والإحالة من الحقل copyright في الردود على طلبات البيانات من واجهة برمجة التطبيقات التالية، بناءً على الخدمة التي تستخدمها:

• مربّعات الخرائط
• مربّعات "التجوّل الافتراضي"
• شاشات واقعية ثلاثية الأبعاد

مربّعات ثنائية الأبعاد

خارطة الطريق، ومربّعات الأقمار الصناعية والتضاريس

تتوفّر معلومات حقوق الطبع والنشر والإحالة من ردّ معلومات إطار العرض، كما هو موضّح في المثال التالي.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

مربّعات "التجوّل الافتراضي"

يمكن الحصول على معلومات حقوق الطبع والنشر والإحالة من ردّ البيانات الوصفية الخاصة بميزة "التجوّل الافتراضي". مثال:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  …
}

يتم إعفاء معرف البانوراما، الذي يستخدم لتحديد بانوراما في ميزة "التجوّل الافتراضي" بشكل فريد، من قيد التخزين المؤقت. لذلك، يمكنك تخزين قيم معرف البانوراما إلى أجل غير مسمى. يتم عرض قيم رقم تعريف البانوراما في الحقل panoId في استجابات واجهة برمجة التطبيقات الثابتة لعرض "التجوّل الافتراضي".

مربّعات ثلاثية الأبعاد لصور واقعية

بالنسبة إلى مربّعات الصور الواقعية ثلاثية الأبعاد، يتم عرض بيانات تحديد المصدر في كل طلب مربّع. يجب تجميع جميع عمليات تحديد المصدر للمربّعات المعروضة وترتيبها وعرضها في سطر، وعادةً ما يكون ذلك على طول الجزء السفلي من العرض. على سبيل المثال، يمكنك العثور على معلومات تحديد المصدر في مربّع 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,
    }));

مستوى سِزيوم Unreal

إذا كنت تستخدم العنصر Cesium for Unreal كعارض، يجب تفعيل حقل إظهار المساهمين على الشاشة في World Outliner "لعرض المساهمين في الفيديو".

السيزيوم للانسجام

إذا كنت تستخدم Cesium for Unity كعارض، يجب عليك تفعيل حقل إظهار المساهمين على الشاشة في وحدة تحكم أداة الفحص لعرض معلومات تحديد المصدر.

إرشادات النمط لإحالة Google

في ما يلي إرشادات حول أنماط تحديد المصدر من Google في CSS وHTML إذا لم تتمكّن من استخدام شعار Google القابل للتنزيل.

المساحة الخالية

يجب أن يكون مقدار المساحة الخالية حول الشعار الكامل مساويًا لارتفاع "G" في Google أو أكبر منه.

يجب أن تكون المسافة بين نسخة تحديد المصدر وشعار Google نصف عرض "G".

الوضوح

يجب أن يكون سطر الاسم دائمًا واضحًا ومقروءًا ويظهر بتنوع اللون الصحيح لخلفية معينة. احرص دائمًا على توفير تباين كافٍ لصيغة الشعار التي تختارها.

اللون

استخدِم نص Google Material Gray 700 على خلفية بيضاء أو فاتحة اللون تتراوح بين 0% و40% كحد أقصى من اللون الأسود.

Google

#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

على الخلفيات الداكنة وأثناء التصوير الفوتوغرافي أو الأنماط غير المزدحمة، استخدِم نصًا أبيض للسطر الاسمي والإحالة.

Google

#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

الخط

استخدِم الخط Roboto.

مثال على CSS

عند تطبيق لغة CSS التالية على النص "Google"، ستعرض "Google" بالخط واللون والتباعد المناسبَين على خلفية بيضاء أو فاتحة.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;