يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات التي تم تطويرها باستخدام Places API، بما في ذلك خدمة "الإكمال التلقائي للأماكن" التي تشكّل جزءًا من واجهة برمجة التطبيقات هذه. يمكن العثور على مزيد من المعلومات العامة لمطوّري "خرائط Google" في بنود خدمة Google Maps Platform.
تقديم بنود الاستخدام وسياسة الخصوصية
إذا كنت تطوّر تطبيقًا يستخدم Places API، يجب توفير بنود الاستخدام و سياسة الخصوصية مع تطبيقك بما يتوافق مع الإرشادات الموضّحة في الاتفاقية المبرمة بينك وبين Google:
- يجب أن تكون بنود الاستخدام وسياسة الخصوصية متاحة للجميع.
- يجب أن تشير صراحةً في بنود الاستخدام لتطبيقك إلى أنّه عند استخدام تطبيقك، يلتزم المستخدمون بتطبيق بنود خدمة Google.
- يجب إعلام المستخدمين في سياسة الخصوصية بأنّك تستخدِم واجهات برمجة تطبيقات "خرائط Google"، وإدراج سياسة خصوصية Google بالإشارة إليها.
يعتمد المكان المُقترَح لتوفير بنود الاستخدام و سياسة الخصوصية على منصة تطبيقك.
تطبيقات الأجهزة الجوّالة
في حال تطوير تطبيق متوافق مع الأجهزة الجوّالة، ننصحك بتوفير رابط يؤدي إلى بنود الاستخدام وسياسة الخصوصية على صفحة تنزيل تطبيقك في متجر التطبيقات ذي الصلة وفي قائمة إعدادات التطبيق.
تطبيقات الويب
في حال تطوير تطبيق ويب، ننصحك بتوفير رابط يؤدي إلى بنود الاستخدام وسياسة الخصوصية في تذييل موقعك الإلكتروني.
جلب المحتوى مسبقًا أو تخزينه أو الاحتفاظ به مؤقتًا في ذاكرة التخزين المؤقت
تخضع التطبيقات التي تستخدم Places API لبنود الاتّفاقية المبرمة بينك وبين Google. بموجب بنود "الاتّفاقية"، يجب عدم جلب أيّ "محتوى" مسبقًا أو فهرسته أو تخزينه أو الاحتفاظ به مؤقتًا في ذاكرة التخزين المؤقت إلا بموجب الشروط محدودة الأجل المُوضّحة في البنود.
يُرجى العِلم أنّ معرّف المكان المستخدَم لتحديد مكان بشكل فريد هو
مُستثنى من قيود التخزين المؤقت. يتم عرض رقم تعريف المكان في حقل place_id في
ردود Places API. اطّلِع على كيفية حفظ أرقام تعريف الأماكن وتعديلها وإدارتها في دليل أرقام تعريف الأماكن.
عرض نتائج Places API
يمكنك عرض نتائج Places API على خريطة من "خرائط Google" أو بدون خريطة. إذا كنت تريد عرض نتائج Places API على خريطة، يجب عرض هذه النتائج على خريطة Google. يُحظر استخدام بيانات Places API على خريطة ليست خريطة 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
الاستجابة من خلال عنصر
Attribution. لإضافة Attribution إلى الردّ، أدرِج
places.attributions (البحث في الأماكن القريبة والبحث النصي) أو attributions
(تفاصيل الأماكن) في
قناع الحقل للطلب.
حقول عنصر Attribution هي سلاسل تحتوي على provider
وproviderUri للإحالة، أو سلسلة فارغة إذا لم تكن هناك إحالات
لعرضها.
عرض معلومات الإسناد لصورة
إذا كان تطبيقك يعرض صورًا، يجب عرض الإسنادات الخاصة بالمؤلفين لكل صورة تتضمّن هذه الإسنادات.
تتضمّن مصفوفة photos تفاصيل حول الصورة في عنصر
Place
الوارد في الاستجابة. لإضافة صفيف photos
إلى الردّ، أدرِج places.photos (البحث في الأماكن القريبة والبحث النصي) أو
photos (تفاصيل الأماكن) في
قناع الحقل للطلب.
كل عنصر من مصفوفة photos هو مثيل من
Photo،
التي تحتوي على مصفوفة authorAttributions من النوع
AuthorAttribution.
حقول عنصر AuthorAttribution هي سلاسل تحتوي على
displayName وuri وphotoUri للسمة، أو
سلسلة فارغة إذا لم تكن هناك أيّ سمات لعرضها.
عرض مراجعة
يمكن أن يحتوي عنصر Place
في ردّ على خمس مراجعات كحدّ أقصى. يمكنك اختياريًا عرض هذه المراجعات في
تطبيقك.
عند عرض المراجعات التي ساهم بها مستخدمو Google، يجب وضع اسم
المؤلف بالقرب منها. ننصحك بتضمين صورة المؤلف
وربط ملفه الشخصي أيضًا، إذا كان ذلك متاحًا في حقل تحديد مصدر المؤلف
لعنصر Review. تعرض الصورة التالية مثالاً على
مراجعة لحديقة:
تنصح Google أيضًا بعرض طريقة ترتيب المراجعات للمستخدم النهائي.
يتم تمثيل كل مراجعة في عنصر
Place
الخاص بالاستجابة باستخدام عنصر
Review. لإضافة عنصر Review إلى الاستجابة، أدرِج places.reviews
(البحث في الأماكن القريبة والبحث النصي) أو reviews (تفاصيل الأماكن) في
قناع الحقل للطلب.
تحتوي حقول عنصر Review على الإسناد، أو تكون فارغة إذا لم يكن هناك
إسناد لعرضه.
مصادر الإحالات الناجحة لنتائج البحث
في أوروبا، عند استخدام ترتيب 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;