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

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

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

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

• يجب أن تكون بنود الاستخدام وسياسة الخصوصية متاحة للجميع .
• يجب أن تشير صراحةً في بنود الاستخدام لتطبيقك إلى أنّه عند استخدام تطبيقك، يلتزم المستخدمون بتطبيق بنود خدمة Google.
• يجب إعلام المستخدمين في سياسة الخصوصية بأنّك تستخدِم واجهات برمجة تطبيقات "خرائط Google"، وإدراج سياسة خصوصية 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 عند الطلب باستخدام إعادة التحقّق.

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

عرض شعار Google

عند استخدام Map 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 مع أدوات عرض تابعة لجهات خارجية

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

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

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

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

عرض إحالات البيانات التابعة لجهات خارجية

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

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

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

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

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

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

إنشاء فيديو يعرض Map Tiles API

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

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

يمكنك الحصول على معلومات الإسناد وحقوق الطبع والنشر من الحقل 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,
    }));

Cesium لمحرك Unreal

إذا كنت تستخدم Cesium for Unreal كمعدّل عرض، عليك تفعيل الحقل عرض المساهمين على الشاشة في المخطّط التفصيلي للعالم لعرض الإسناد.

Cesium for Unity

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

إرشادات حول أسلوب تحديد المصدر في Google

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

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

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

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

سهولة القراءة

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

اللون

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

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

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

#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;