سياسات واجهة برمجة تطبيقات الأماكن

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

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

عند تطوير تطبيق 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 في أسفل يسار الخريطة، والإحالة في أسفل اليمين.

موضع تحديد المصدر المتعلّق بالسياسة

يحتوي ملف 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 من الإحالة، أو سلسلة فارغة إذا لم تكن هناك أي عمليات إحالة للعرض.

عرض عمليات تحديد المصدر لصورة

إذا كان تطبيقك يعرض صورًا، يجب عرض معلومات عن المؤلفين لكل صورة تحتوي على هذه الصور.

يتم تضمين تفاصيل حول الصورة في كائن Place من الردّ في مصفوفة photos. لإضافة مصفوفة 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 في 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;