سياسات Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك عرض نتائج واجهة برمجة تطبيقات 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% من الحد الأقصى للون الأسود.

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