السياسات وبيانات المصدر الخاصة بـ Maps JavaScript API

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

السياسات

يصف هذا القسم السياسات ذات الصلة بـ Maps JavaScript API. توفر السياسات إرشادات ومتطلبات عملية للتنفيذ لمساعدتك في استخدام الخدمة بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".

استثناءات من قيود التخزين المؤقت

يُرجى العِلم أنّ رقم تعريف المكان، الذي يُستخدم لتحديد مكان بشكلٍ فريد، مستثنى من قيود التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى. ويتم عرض رقم تعريف المكان في الح0/} الحقل في الردود من واجهة برمجة التطبيقات.place_id تعرَّف على كيفية حفظ أرقام تعريف الأماكن وتحديثها وإدارتها في دليل أرقام تعريف الأماكن.

جمع المحتوى

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

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

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

• بنود خدمة "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية
• بنود الخدمة المحدّدة في "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية
• الأسئلة الشائعة في المنطقة الاقتصادية الأوروبية
• متطلبات السلامة على الطرق في "منصة خرائط Google"

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

• بنود خدمة "منصة خرائط Google"
• بنود الخدمة المحدّدة في "منصة خرائط Google"

متطلبات تحديد المصدر في "خرائط Google"

يقدّم هذا القسم متطلبات وإرشادات تحديد المصدر لعرض "خرائط Google" والمحتوى من خلال تطبيقاتك.

مثال على تحديد المصدر

في ما يلي مثال على تحديد المصدر لحزمة أدوات "خرائط Google" الجاهزة للأماكن.

عرض سمة تحديد المصدر "خرائط Google"

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

سمة تحديد المصدر "خرائط Google" المضمّنة

بالنسبة إلى سمة تحديد المصدر "خرائط Google" التي توفّرها "منصة خرائط Google" في واجهة المستخدم، مثل حزمة أدوات "خرائط Google" الجاهزة للأماكن:

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

شعار "خرائط Google" وسمة تحديد المصدر النصية

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

سمة تحديد المصدر للشعار

تنزيل شعارات "خرائط Google"

استخدِم ملفات شعار "خرائط Google" الرسمية. نزِّل الشعارات أدناه واتّبِع الإرشادات الواردة في هذا القسم.

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

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

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

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

للتعرّف على وحدات البكسل المستقلة الكثافة، اطّلِع على كثافة البكسل على موقع Material Design الإلكتروني.

إمكانية الوصول إلى الشعار

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

سمة تحديد المصدر النصية

إذا كان حجم واجهتك لا يسمح باستخدام شعار "خرائط Google"، يمكنك كتابة خرائط Google نصيًا. اتّبِع هذه الإرشادات:

• لا تعدِّل النص خرائط Google بأي طريقة:
  
  • لا تغيِّر حالة الأحرف في خرائط Google
  • لا تنقل خرائط Google إلى أسطر متعددة
  • لا تُترجِم خرائط Google إلى لغة أخرى.
  • امنع المتصفحات من ترجمة خرائط Google باستخدام سمة HTML‏ translate="no".

• نسِّق النص "خرائط Google" كما هو موضّح في الجدول التالي:

  متطلبات تنسيق النص "خرائط Google"
  السمة	الشكل
  مجموعة الخطوط	Roboto. تحميل الخط اختياري.
  مجموعة الخطوط الاحتياطية	أي خط أساسي من نوع sans serif مستخدَم حاليًا في منتجك أو "Sans-Serif" لاستخدام خط النظام التلقائي
  شكل الخطّ	عادي
  سُمك الخط	400
  لون الخط	أبيض أو أسود (#1F1F1F) أو رمادي (#5E5E5E) حافظ على تباين مناسب (4.5:1) مع الخلفية.
  حجم الخط	الحد الأدنى لحجم الخط: 12 وحدة قياس مستقلة الحجم الحد الأقصى لحجم الخط: 16 وحدة قياس مستقلة الحجم للتعرّف على وحدات القياس المستقلة الحجم، اطّلِع على وحدات قياس حجم الخط على موقع Material Design الإلكتروني.
  تباعُد الأحرف	عادي

مثال على نمط CSS

يعرض نمط CSS التالي "خرائط Google" بالشكل واللون المناسبَين للطباعة على خلفية بيضاء أو فاتحة.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

المتطلبات المرئية

• ضَع سمة تحديد المصدر بالقرب من أعلى المحتوى أو أسفله، وضمن الحاوية المرئية نفسها. بالنسبة إلى سطر واحد من المحتوى، يمكن وضع سمة تحديد المصدر على اليمين أو اليسار.

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

• لا تحرِّف "خرائط Google" من خلال تحديد مصدرها بمحتوى غير تابع لـ "منصة خرائط Google".
• تأكَّد من ظهور سمة تحديد المصدر دائمًا بشكلٍ واضح ومقروء. لا تُزِلها أو تخفِها أو تحجبها أو تعدِّلها أبدًا.

تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.

مزودو بيانات الجهات الخارجية

تأتي بعض البيانات والصور في منتجات الخرائط من مزوّدين آخرين غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نزوّدك بسمة تحديد المصدر المطلوبة لمزوّد بيانات الجهة الخارجية. عندما نفعل ذلك، يجب أن يتضمّن نص سمة تحديد المصدر الاسم "خرائط Google" ومزوّدي البيانات ذوي الصلة، مثل "بيانات الخريطة: Google وMaxar Technologies". عندما تقدّم 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". لا ينطبق هذا الاستثناء إلا على عنوان الشارع الذي اختاره المستخدم النهائي ولـ المعاملة المحدّدة لهذا المستخدم النهائي فقط، ولا ينطبق على قائمة العناوين المقترَحة التي توفّرها وظيفة "الإكمال التلقائي" أو على محتوى "خرائط Google" الآخر. لا ينطبق هذا الاستثناء على أي وظيفة بحث عن نقاط الاهتمام أو العناوين تقدّمها خدمات أخرى على "منصة خرائط Google".

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

ملخّصات من إنشاء الذكاء الاصطناعي

عند عرض ملخّصات من إنشاء الذكاء الاصطناعي في تطبيقك، بما في ذلك ملخّصات الأماكن والمناطق والمراجعات، عليك إجراء ما يلي:

• عرض سمات تحديد المصدر وروابط الإبلاغ والروابط المرجعية المطلوبة كما هو محدّد أدناه
• يجب أن يتمكّن المستخدمون النهائيون من قراءة نص الملخّص الكامل كما هو مقدَّم من "خرائط Google".

عرض نص الإفصاح عن الملخّصات من إنشاء الذكاء الاصطناعي

عند عرض ملخّص من إنشاء الذكاء الاصطناعي من أي نوع، عليك دائمًا تضمين نص الإفصاح المترجَم (المقدَّم في الحقل disclosureText من نص الرد) أسفل الملخّص مباشرةً. لا تغيِّر أو تُضِف إلى نص الإفصاح الذي تقدّمه واجهة برمجة التطبيقات أبدًا.

متطلبات إضافية لملخّصات الأماكن والمناطق

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

متطلبات ملخّص المراجعات

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

إرشادات العرض لحالات الاستخدام في السيارات

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

• 3 أسطر كحدّ أقصى
• 120 حرفًا أو 24 كلمة أو أقل
• الحد الأدنى لحجم الخط: 24 وحدة بكسل مستقلة الكثافة

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