سياسات Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

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

عرض نتائج واجهة برمجة تطبيقات 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: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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 من النوع Author Attribution. والحقول في العنصر AuthorAttribution هي سلاسل تحتوي على displayName وuri وphotoUri من مصدر الإحالة، أو سلسلة فارغة في حال عدم توفّر أي عمليات تحديد مصدر لعرضها.

إرشادات النمط لإحالة 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;