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

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

السياسات

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

تخزين البيانات والتخزين المؤقت واستخراج البيانات

عند استخدام محتوى "خرائط Google" في تطبيقك، يجب اتّباع متطلبات معالجة البيانات الواردة في الفقرة 3.2.3 من بنود خدمة "منصة خرائط Google" والبنود الخاصة بخدمة "منصة خرائط Google":

  • القيود المفروضة على التخزين المؤقت واستخراج البيانات (الفقرتان 3.2.3(أ) و(ب)): لا يجوز لك تخزين محتوى "خرائط Google" مؤقتًا أو حفظه إلا على النحو المسموح به صراحةً بموجب الأحكام الخاصة بخدمة "منصة خرائط Google". لا يجوز لك تصدير "محتوى خرائط Google" أو استخراجه أو استخلاصه لاستخدامه خارج "الخدمات". على سبيل المثال، لا يُسمح لك بالجلب المُسبق لمحتوى "خرائط Google" أو فهرسته أو تخزينه أو إعادة توزيعه خارج "الخدمات"، أو تنزيل مربّعات الخرائط أو صور "التجوّل الافتراضي" أو الرموز الجغرافية أو الاتجاهات أو نتائج مصفوفة المسافات أو معلومات الطرق أو معلومات الأماكن أو قيم الارتفاع أو تفاصيل المنطقة الزمنية بشكل مجمّع، أو نسخ أسماء الأنشطة التجارية أو عناوينها أو مراجعات المستخدمين وحفظها.
  • القيود المفروضة على المحتوى المشتق (الفقرة 3.2.3(ج)): يمكنك استخدام محتوى "خرائط Google" في تطبيقك على النحو المسموح به في بنود خدمة "منصة خرائط 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 عند إرسال طلبات تتضمّن إعادة التحقّق.

طباعة

لا يجوز استخدام صور "التجوّل الافتراضي" لأغراض الطباعة، كما هو موضّح في سياسات "التجوّل الافتراضي".

بلدان المنطقة الاقتصادية الأوروبية وأقاليمها

يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان إرسال فواتير في المنطقة الاقتصادية الأوروبية (EEA)، وقد يتضمّن أيضًا وظائف مختلفة. قبل إنشاء التطبيقات باستخدام "منصة خرائط Google"، يُرجى مراجعة البنود والمعلومات التالية الخاصة بالمنطقة الاقتصادية الأوروبية:

إذا لم يكن عنوان إرسال الفواتير في المنطقة الاقتصادية الأوروبية، تسري عليك بنود الخدمة التالية:

صورة معروضة تبيّن "خرائط Google" ومصادر بيانات المستخدم على Google
نسب المحتوى إلى "خرائط Google" في خريطة تستخدم Map Tiles API

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

مصدر الشعار

الاختلافات المقبولة في نسب شعار "خرائط Google"
الاختلافات المقبولة في نسب شعار "خرائط Google"

شعار "خرائط Google"

استخدِم شعارات "خرائط Google" الرسمية الواردة أدناه.

تنزيل مواد عرض الإحالة في "خرائط Google"

عند استخدام شعار "خرائط Google"، اتّبِع الإرشادات التالية.

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

مواصفات حجم الشعار

اتّبِع مواصفات الحجم التالية لشعار "خرائط Google":

  • الحدّ الأدنى لارتفاع الشعار: 16 بكسل مستقل الكثافة
  • الحد الأقصى لارتفاع الشعار: 19 بكسل مستقل الكثافة
  • الحد الأدنى للمساحة الخالية حول الشعار: 10 بكسل مستقل الكثافة على اليسار واليمين والأعلى، و5 بكسل مستقل الكثافة في الأسفل

للتعرّف على وحدات البكسل المستقلة عن الكثافة، يُرجى الاطّلاع على كثافة البكسل على موقع "التصميم المتعدد الأبعاد" الإلكتروني.

شعار "خرائط Google" يعرض الحد الأدنى للمساحة الفارغة ونطاق الحجم المقبول
تمثيل لشعار "خرائط Google" يعرض الحد الأدنى للمساحة الفارغة ونطاق الحجم المقبول

تسهيل استخدام الشعار

يُرجى اتّباع متطلبات تسهيل الاستخدام التالية لشعار "خرائط Google":

  • الحفاظ على تباين مناسب بين الشعار والخلفية
  • أدرِج تصنيفًا يسهّل الوصول إلى المحتوى يتضمّن النص خرائط Google.

عرض شعار "خرائط Google" مع أدوات عرض تابعة لجهات خارجية

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

صورة معروضة تظهر شعارَي Google وCesium

عرض مصادر بيانات Google

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

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

تذييل يحتوي على شعار Google ومصدر البيانات

عرض مصادر بيانات الجهات الخارجية

بعض البيانات والصور في منتجات الخرائط لدينا تأتي من مقدّمي خدمات غير 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 Unreal

Cesium for Unity

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

كيفية تفعيل الإحالات في Cesium for Unity