سياسات Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عرض شعار Google ومصادرها

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

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

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

للاستخدام على خلفية فاتحة	للاستخدام على خلفية داكنة

يحتوي الملف المضغوط التالي على شعار Google بالأحجام الصحيحة تطبيقات الكمبيوتر المكتبي وAndroid وiOS. لا يجوز لك تغيير حجم هذه العناصر أو تعديلها الشعارات بأي شكل من الأشكال.

تنزيل: google_logo.zip

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

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

تضمين مزوِّدي البيانات التابعين لجهات خارجية: بعض البيانات والصور في تصميمنا منتجات تأتي من مقدّمي خدمات غير Google. في حالة استخدام مثل هذه الصور، فإن نص يجب أن يذكر الإسناد الاسم "Google" ومزود(مقدمي البيانات) المعنيين، مثل "بيانات الخريطة: Google، تقنيات Maxar". عند ذكر موفري بيانات من أطراف ثالثة مع الصور، بما في ذلك "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 من النوع AuthorAttribution. تتيح حقول الكائن AuthorAttribution عبارة عن سلاسل تحتوي على displayName، uri وphotoUri للإحالة، أو سلسلة فارغة إذا لم تكن هناك والإسناد المراد عرضها.

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