يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات التي تم تطويرها باستخدام Places API (الجديدة)، بما في ذلك خدمة "الإكمال التلقائي" (الجديدة) التي تشكّل جزءًا من واجهة برمجة التطبيقات هذه. يمكن للمطوّرين الاطّلاع على المزيد من المعلومات العامة حول "خرائط Google" في بنود خدمة "منصة خرائط Google".
السياسات
يوضّح هذا القسم السياسات ذات الصلة بواجهة Places API. تقدّم السياسات إرشادات ومتطلبات عملية للتنفيذ لمساعدتك في استخدام الخدمة بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".
استثناءات من القيود المفروضة على التخزين المؤقت
يُرجى العِلم أنّ معرّف المكان، المستخدَم لتحديد مكان بشكلٍ فريد، معفى من قيود التخزين المؤقت.
وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمّى.
يتم عرض رقم تعريف المكان في الحقل place_id ضمن الردود من واجهة برمجة التطبيقات. تعرَّف على كيفية حفظ أرقام تعريف الأماكن وتحديثها وإدارتها في دليل أرقام تعريف الأماكن.
بلدان وأقاليم المنطقة الاقتصادية الأوروبية
يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان إرسال فواتير في المنطقة الاقتصادية الأوروبية، وقد يتضمّن أيضًا وظائف مختلفة. قبل البدء في استخدام "منصة خرائط 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":- الحدّ الأدنى لارتفاع الشعار: 16dp
- الحدّ الأقصى لارتفاع الشعار: 19dp
- الحدّ الأدنى للمساحة الخالية حول الشعار: 10 وحدات بكسل مستقلة عن الكثافة على اليمين واليسار والأعلى، و5 وحدات بكسل مستقلة عن الكثافة في الأسفل
لمعرفة المزيد عن dp، يمكنك الاطّلاع على كثافة البكسل على موقع التصميم المتعدد الأبعاد الإلكتروني.
تسهيل استخدام الشعار
اتّبِع متطلبات تسهيل الاستخدام التالية لشعار "خرائط Google":- يجب الحفاظ على تباين يسهل الوصول إليه بين الشعار والخلفية.
- أدرِج تصنيفًا مناسبًا لذوي الاحتياجات الخاصة مع النص خرائط Google.
تحديد مصدر النص
إذا كان حجم واجهتك لا يتيح استخدام شعار "خرائط Google"، يمكنك كتابة خرائط Google كنص. اتبع الإرشادات التالية:
- لا تعدّل النص خرائط Google بأي شكل من الأشكال:
- لا تغيِّر طريقة كتابة خرائط Google
- لا تلتف خرائط Google على أسطر متعددة
- عدم ترجمة خرائط Google إلى لغة أخرى
- يمكنك منع المتصفّحات من ترجمة خرائط Google باستخدام سمة HTML
translate="no".
يمكنك تنسيق نص "خرائط Google" كما هو موضّح في الجدول التالي:
متطلبات تنسيق النصوص في "خرائط Google" الموقع النمط مجموعة الخطوط Roboto تحميل الخط اختياري. مجموعة الخطوط الاحتياطية أي خط sans serif مستخدَم حاليًا في منتجك أو "Sans-Serif" لاستدعاء خط النظام التلقائي شكل الخطّ عادي سُمك الخط 400 لون الخط أبيض أو أسود (#1F1F1F) أو رمادي (#5E5E5E) الحفاظ على نسبة تباين (4.5:1) يسهل الوصول إليها مقارنةً بالخلفية حجم الخط الحد الأدنى لحجم الخط: 12sp
الحد الأقصى لحجم الخط: 16sp
لمزيد من المعلومات عن sp، يمكنك الاطّلاع على وحدات حجم الخط على موقع التصميم المتعدد الأبعاد الإلكتروني.تباعُد الأحرف عادي
مثال على 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".
- تأكَّد من أنّ معلومات تحديد المصدر ظاهرة دائمًا ويمكن قراءتها. يجب عدم إزالة أو إخفاء أو تعتيم أو تعديل هذا الإشعار.
تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.
مزودو بيانات الجهات الخارجية
تأتي بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات المصدر المطلوبة لمقدّم بيانات تابع لجهة خارجية. وفي هذه الحالة، يجب أن يتضمّن نص الإشارة إلى المصدر الاسم "خرائط Google" ومزوّدي البيانات المعنيين، مثل "بيانات الخرائط: Google وMaxar Technologies". عندما تقدّم Google تحديد مصدر تابعًا لجهة خارجية، لا يكفي تضمين "خرائط Google" أو شعار Google لتحديد المصدر بشكل صحيح.
متطلبات إضافية لواجهة Places API
المتطلبات التالية خاصة بواجهة Places API.
الإكمال التلقائي لعناوين المستخدمين النهائيين
عندما يستخدم مستخدم نهائي وظيفة "الإكمال التلقائي" في "تطبيق العميل" لكتابة عنوان شارع، وكان بإمكان المستخدم النهائي تقديم عنوان الشارع بشكل كامل ودقيق بدون استخدام "الإكمال التلقائي"، لا يخضع العنوان الذي اختاره المستخدم النهائي لقيود "محتوى خرائط Google" الواردة في "اتفاقية منصة خرائط Google". لا ينطبق هذا الاستثناء إلا على عنوان الشارع الذي يختاره المستخدم النهائي ولغرض المعاملة المحددة التي يجريها هذا المستخدم النهائي فقط، ولا ينطبق على قائمة العناوين المقترَحة التي توفّرها وظيفة "الإكمال التلقائي" أو على "محتوى خرائط Google" الآخر. ولا ينطبق هذا الاستثناء على أي وظيفة بحث عن نقاط اهتمام أو عناوين تقدّمها خدمات أخرى من Google Maps Platform.
تبقى قائمة العناوين على اليمين خاضعة للقيود المفروضة على محتوى "خرائط Google". بعد أن يختار المستخدم النهائي العنوان الذي يريده، لا يخضع هذا العنوان للقيود المفروضة على "محتوى خرائط Google" إلا لغرض المعاملة السارية التي يجريها المستخدم النهائي.
صور وآراء
نسبة كل المحتوى إلى مؤلفه
يجب دائمًا الإشارة إلى المؤلف عند عرض الصور أو المراجعات. تتضمّن كل صورة ومراجعة معلومات تحديد المصدر (صورة رمزية للمؤلف واسمه ورابط ملفه الشخصي).
المتطلبات المرئية لتحديد مصدر المحتوى:
- يجب الإشارة إلى المؤلف باستخدام جميع الموارد المتاحة (الأفاتار والاسم ورابط الملف الشخصي) عندما تسمح المساحة بذلك.
- بالنسبة إلى المراجعات، إذا كانت المساحة محدودة، الحدّ الأدنى المطلوب هو عرض أفاتار المؤلف.
- بالنسبة إلى الصور، إذا كانت المساحة محدودة (مثلما هو الحال في معرض الصور أو الصور المصغّرة)، يمكن حذف معلومات تحديد المصدر الخاصة بالمؤلف، شرط أن يتمكّن المستخدم من الوصول إلى نسخة أكبر من الصورة تتضمّن معلومات تحديد المصدر الكاملة الخاصة بالمؤلف.
- ضَع معلومات تحديد مصدر المحتوى بحيث تكون مرتبطة بوضوح بصورة المؤلف أو مراجعته.
توفير وصول مباشر إلى المحتوى المصدر على "خرائط Google"
يجب أن يتمكّن المستخدمون النهائيون دائمًا من عرض الصورة المصدر أو المراجعة الفردية على "خرائط Google" باستخدام googleMapsUri المقدَّم لكل صورة ومراجعة.
عرض تاريخ النشر النسبي (يُنصح به) *
يؤدي عرض تاريخ النشر النسبي (مثلاً "قبل يومَين") للصور والمراجعات باستخدام relativePublishTimeDescription المقدَّمة إلى زيادة ثقة المستخدمين في المحتوى.
تفعيل ميزة الإبلاغ عن المحتوى (إجراء يُنصح به) *
تخضع الصور والمراجعات المقدَّمة من خلال Places API (الإصدار الجديد) وPlaces API (الإصدار القديم) لسياسات المنتجات والمحتوى من Google في أي مكان في العالم. يمكنك أنت والمستخدمون النهائيون الإبلاغ عن المحتوى الذي تريدون إزالته من خدمات Google بموجب سياسات Google أو القوانين السارية باستخدام رمز flagContentUri لكل صورة ومراجعة. بدلاً من ذلك، يمكن الإبلاغ عن المحتوى من خلال اتّباع الرابط المباشر إلى المحتوى على "خرائط Google"، حيث تتوفّر أيضًا إمكانية الإبلاغ عن مشكلة.
المراجعات
وصف طريقة ترتيب المراجعات وفلترتها
تضمين إشعار واضح يوضّح كيفية ترتيب المراجعات وفلترتها، بما في ذلك أي معايير بحث يتم تطبيقها يتم ترتيب المراجعات تلقائيًا حسب مدى صلتها بالموضوع.
عرض الشهر والسنة اللذين زار فيهما المراجعون أماكن في فرنسا
عند عرض مراجعات للأماكن في فرنسا والمناطق الفرنسية، تعرض Places API
visitDate (الشهر والسنة اللذان زار فيهما المؤلّف المكان)، ويجب عرضها
بجانب المحتوى.
إعلام المستخدمين النهائيين عند ترجمة المراجعات (إجراء يُنصح به) *
يجب إعلام المستخدمين النهائيين عند ترجمة مراجعة من لغتها الأصلية. يمكنك السماح للمستخدمين النهائيين بعرض النص الأصلي غير المترجَم originalText. بدلاً من ذلك، يمكنهم اتّباع الرابط المباشر إلى المحتوى على "خرائط Google" حيث يتوفّر النص الأصلي غير المترجَم.
المراجعات ومتوسط التقييم
إعلام المستخدمين النهائيين بكيفية تحقّق Google من المراجعات (يُنصح بذلك) *
لا تتحقّق Google من المراجعات، ولكنّها تُجري عمليات فحص بحثًا عن المحتوى المزيّف وتزيله في حال رصده. إبلاغ المستخدمين النهائيين بسياسة المراجعات في Google عند عرض المراجعات ومتوسط التقييم مزيد من المعلومات عن سياسة المحتوى من إنشاء المستخدِمين على "خرائط Google"
الملخّصات المستندة إلى الذكاء الاصطناعي
عند عرض ملخّصات مستندة إلى الذكاء الاصطناعي في تطبيقك، بما في ذلك ملخّصات الأماكن والمناطق والمراجعات، عليك اتّباع ما يلي:
- اعرض بيانات المصدر المطلوبة وروابط الإبلاغ وروابط المراجع على النحو المحدّد أدناه.
- يجب أن يتمكّن المستخدمون النهائيون من قراءة نص الملخّص الكامل كما تقدّمه "خرائط Google".
عرض نص الإفصاح عن الملخّصات المستندة إلى الذكاء الاصطناعي
عند عرض ملخّص مستند إلى الذكاء الاصطناعي من أي نوع، يجب دائمًا تضمين نص الإفصاح المترجَم (المقدَّم في الحقل disclosureText من نص الرد) أسفل الملخّص مباشرةً. يجب عدم تعديل نص الإفصاح الذي توفّره واجهة برمجة التطبيقات أو إضافة أي محتوى إليه.
المتطلبات الإضافية لملخّص المكان والمنطقة
يجب أن تتضمّن ملخّصات الأماكن والمناطق المعروضة في تطبيقك النص التالي والروابط المطلوبة:
| نص | المتطلبات |
|---|---|
| لمحة عن هذا الملخّص | استخدِم الرابط التالي للاطّلاع على "كيفية حصول Google على المعلومات في البيانات المحلية واستخدامها لها": https://support.google.com/local-listings/answer/9851099. |
| الإبلاغ عن ملخّص |
استخدِم الرابط الوارد في الحقل ملاحظة: تخضع الملخّصات المستندة إلى الذكاء الاصطناعي والمقدَّمة من خلال Places API (الجديد) لسياسات المحتوى والمنتجات المتّبعة في Google في أي مكان في العالم. عليك إعلام المستخدمين النهائيين بأنّه إذا أرادوا الإبلاغ عن محتوى يجب إزالته من خدمات Google بموجب القوانين السارية، عليهم الإبلاغ عنه باستخدام عنوان URL الخاص بالإبلاغ عن المحتوى ( |
متطلبات ملخّص المراجعات
يجب أن يكون ملخّص المراجعات المعروض في تطبيقك مصحوبًا بعنوان يتضمّن النص "ملخّص المراجعات". بالإضافة إلى ذلك، يجب استخدام النص التالي والروابط المطلوبة:
| نص | المتطلبات |
|---|---|
| لمحة عن هذا الملخّص | استخدِم الرابط التالي للانتقال إلى مقالة "كيفية حصول Google على المعلومات في البيانات المحلية واستخدامها لها": https://support.google.com/local-listings/answer/9851099 |
| الإبلاغ عن ملخّص |
استخدِم الرابط الوارد في الحقل ملاحظة: تخضع الملخّصات المستندة إلى الذكاء الاصطناعي والمقدَّمة من خلال Places API (New) لسياسات المحتوى والمنتجات المتّبعة في Google في أي مكان في العالم. عليك إعلام المستخدمين النهائيين بأنّه إذا أرادوا الإبلاغ عن محتوى يجب إزالته من خدمات Google بموجب القوانين السارية، عليهم الإبلاغ عنه باستخدام عنوان URL الخاص بالإبلاغ عن المحتوى ( |
| الاطلاع على التعليقات | استخدِم الرابط الوارد في الحقل reviewSummary.reviewsUri من الردّ. |
عرض إرشادات لحالات الاستخدام في السيارات
للحفاظ على سلامة السائق، تنصح Google بعرض الملخّصات المستندة إلى الذكاء الاصطناعي في وضع الركن عند استخدام تجارب السيارات. في حال عرض الملخّصات في وضع القيادة، يجب أن تكون المعلومات الظاهرة على الشاشة واضحة وموجزة لضمان عودة انتباه السائق إلى الطريق بسرعة:
- 3 أسطر كحدّ أقصى
- 120 حرفًا أو 24 كلمة أو أقل
- الحد الأدنى لحجم الخط هو 24 وحدة بكسل مستقلة عن الكثافة
وعلى المطوّرين، خاصةً في سياقات السيارات، مسؤولية عرض الملخّصات المستندة إلى الذكاء الاصطناعي بطرق آمنة ومتوافقة مع جميع القوانين واللوائح المحلية.
نتائج البحث عن الأماكن
توضيح العوامل التي تؤثر في ترتيب نتائج البحث (يُنصح بذلك) *
يجب أن يكون المستخدمون النهائيون على دراية بالعوامل الرئيسية وتأثيرها في ترتيب نتائج البحث، وذلك ضمن تفاعل واحد مع المستخدم.
عند استخدام ترتيب Google غير المعدَّل، يمكنك عرض نص التفسير التالي:
عند البحث عن مؤسسات أو أماكن بالقرب من موقع جغرافي معيّن، ستعرض "خرائط Google" النتائج المحلية. تُستخدَم عدة عوامل معًا للعثور على أفضل النتائج لعملية البحث، لا سيما مدى الصلة بموضوع البحث والمسافة ومدى شهرة المكان. مزيد من المعلومات".
الامتثال للقوانين السارية
عليك الالتزام بجميع القوانين السارية في جميع الأوقات. يُرجى العِلم أنّ الممارسات المصنّفة (مقترَحة) في هذه السياسات قد تظل إلزامية بموجب القانون. بالإضافة إلى ذلك، لا يضمن اتّباع جميع المتطلبات المذكورة والممارسات المقترَحة الامتثال الكامل للقانون في جميع السلطات القضائية. إذا كانت لديك أسئلة حول حالة امتثالك، عليك طلب الإرشاد من مستشارك القانوني.