سياسات Maps JavaScript API

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

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

في حال تطوير تطبيق يستخدِم واجهة برمجة التطبيقات JavaScript لخرائط Google، يجب توفير بنود الاستخدام و سياسة الخصوصية مع تطبيقك بما يتوافق مع الإرشادات الموضّحة في الاتفاقية المبرمَجة بينك وبين Google:

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

يعتمد المكان المُقترَح لتوفير بنود الاستخدام و سياسة الخصوصية على منصة تطبيقك.

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

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

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

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

جلب المحتوى مسبقًا أو تخزينه أو الاحتفاظ به مؤقتًا في ذاكرة التخزين المؤقت

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

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

عرض نتائج Maps JavaScript API

يمكنك عرض نتائج واجهة برمجة تطبيقات JavaScript لخرائط Google على خريطة Google أو بدون خريطة. إذا كنت تريد عرض نتائج واجهة برمجة تطبيقات JavaScript لخرائط Google على خريطة، يجب عرض هذه النتائج على خريطة Google. يُحظر استخدام بيانات واجهة برمجة تطبيقات JavaScript لخرائط Google على خريطة ليست خريطة Google.

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

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

متطلبات تحديد المصدر الأخرى

اتّبِع هذه التعليمات لاسترداد الإحالات الناجحة التابعة لجهات خارجية وعرض الإحالات الناجحة في تطبيقك.

.

استرداد الإسنادات من مكان

إذا كان تطبيقك يعرض معلومات المراجعات التي تم الحصول عليها من خلال الاتصال بموقع Place.fetchFields، يجب أن يعرض التطبيق أيضًا إحالات الجهات الخارجية لتفاصيل الأماكن التي تم الحصول عليها.

تعرِض واجهة برمجة التطبيقات عنصر Place. لاسترداد الإسنادات من عنصر Place، استخدِم السمة Place.attributions التي يتم عرضها مع كل طلب (ما مِن حاجة إلى تحديدها باستخدام الحقول). تعرض السمة List من String عنصر، أو null إذا لم يكن هناك أيّ مصدر لعرضه. يوضّح مثال الرمز البرمجي التالي الحصول على مكان وإدراج أي إحالات.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

عرض مراجعة

يمكن أن يحتوي عنصر Place على خمس مراجعات بحد أقصى، ويتم تمثيل كل مراجعة من خلال عنصر Review. يمكنك اختياريًا عرض هذه المراجعات في تطبيقك.

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

عرض معلومات إسناد المؤلف

يوضّح المثال التالي الحصول على مكان والتحقّق من المراجعات وعرض البيانات من المراجعة الأولى: 

  // Use place ID to create a new Place instance.
  const place = new Place({
    id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
  });

  // Call fetchFields, passing "reviews" and other needed fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }

الاطّلاع على مستندات مراجعات الأماكن

عرض معلومات الإسناد لصورة

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

كل عنصر من مصفوفة الصور هو مثيل من Photo، الذي يحتوي على مصفوفة authorAttributions من النوع AuthorAttribution. حقول كائن AuthorAttribution هي سلاسل تحتوي على displayName و uri وphotoUri للإحالة، أو سلسلة فارغة إذا لم تكن هناك إحالات لعرضها.

الاطّلاع على مستندات الصور المرتبطة بالأماكن

مصادر الإحالات الناجحة لنتائج البحث

في أوروبا، عند استخدام ترتيب Google غير المعدَّل، يجب أن تتضمّن منتجات البحث نصًا توضيحيًا لا يبعد عن النتيجة سوى نقرة واحدة، يصف العوامل الرئيسية وأهمية هذه العوامل التي تحدد ترتيب نتائج البحث. النص التوضيحي:

العنوان: لمحة عن هذه النتائج

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

الزر 1: مزيد من المعلومات
يجب أن ينقل نص"مزيد من المعلومات" إلى مقالة في مركز المساعدة.

الزر 2: حسنًا

إرشادات حول أسلوب تحديد المصدر في 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;