این سند الزامات مختص همه برنامه‌های توسعه‌یافته با Places API (جدید)، ازجمله سرویس «تکمیل خودکار» (جدید) را که بخشی از آن API است، فهرست می‌کند. اطلاعات عمومی بیشتر برای توسعه‌دهندگان Google Maps را می‌توانید در شرایط خدمات Google Maps Platform پیدا کنید.
خط‌مشی‌ها
این بخش خط‌مشی‌های مربوط به Places API را شرح می‌دهد. خط‌مشی‌ها دستورالعمل‌ها و الزامات اجرایی کاربردی را ارائه می‌دهند تا به شما کمک کنند از «سرویس» به‌درستی و مطابق با انتظارات «پلاتفرم Google Maps» استفاده کنید.
استثنائات محدودیت‌های ذخیره کردن در حافظه نهان
توجه داشته باشید که شناسه مکان، که برای شناسایی منحصربه‌فرد مکان استفاده می‌شود،
از محدودیت‌های ذخیره‌سازی موقت معاف است.
بنابراین می‌توانید مقادیر شناسه مکان را برای مدت نامحدود ذخیره کنید.
شناسه جا در فیلد place_id در پاسخ‌های میانای برنامه‌سازی کاربردی برگردانده می‌شود. در راهنمای «شناسه‌های مکان» با نحوه ذخیره، بازآوری، و مدیریت شناسه‌های مکان آشنا شوید.
کشورها و قلمروهای منطقه اقتصادی اروپا
این محصول برای مشتریانی که نشانی صورت‌حسابشان در منطقه اقتصادی اروپا (EEA) است، «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد آن نیز متفاوت باشد. قبل‌از ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:
- شرایط خدمات Google Maps Platform در منطقه اقتصادی اروپا
- شرایط خاص سرویس Google Maps Platform در منطقه اقتصادی اروپا
- پرسشگان منطقه اقتصادی اروپا
- الزامات ایمنی جاده‌ای پلاتفرم Google Maps
اگر نشانی صورت‌حساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال می‌شود:
الزامات ذکر منبع Google Maps
این بخش الزامات و دستورالعمل‌های ذکر منبع را برای نمایش Google Maps و محتوا ازطریق برنامه‌های شما ارائه می‌دهد.
نمایش ارجاع Google Maps
هنگام نمایش «محتوا» از میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» در برنامه یا وب‌سایتتان، باید الزامات ذکر منبع Google Maps را رعایت کنید. اگر «محتوا» در Google Map نشان داده می‌شود و ارجاع ازقبل نمایان است، نیازی به افزودن ارجاع اضافی ندارید.
ارجاع Google Maps اضافه شد
برای ارجاع Google Maps که قبلاً توسط «پلاتفرم Google Maps» در میانای کاربر ارائه شده است، مثلاً در «کیت میانای کاربر جاها»:
- ارجاع گنجانده‌شده را صرف‌نظر از جایی که نمایش داده می‌شود برندارید. اسناد را تغییر ندهید، پنهان نکنید، یا مبهم نکنید و مطمئن شوید که به‌وضوح در پس‌زمینه قابل‌مشاهده است.
- همیشه «محتوای Google Maps Platform» را بااستفاده از نشانه‌های میانای کاربری مانند حاشیه، رنگ پس‌زمینه، سایه، یا فضای خالی کافی به‌صورت بصری از محتوای دیگر متمایز کنید.
- هنگام ایجاد تغییرات بصری، باید از همه الزامات ذکر منبع Google Maps پیروی کنید.
نشان‌واره Google Maps و ارجاع نوشتاری
ارجاع باید هر زمان ممکن است به‌شکل نشان‌واره Google Maps باشد. در مواردی که فضا محدود است، نوشتار Google Maps قابل‌قبول است. همیشه باید برای کاربران نهایی مشخص باشد که کدام محتوا را Google Maps ارائه کرده است.
ارجاع نشان‌واره
برای استفاده از نشان‌واره Google Maps در برنامه یا وب‌سایتتان، این الزامات را دنبال کنید.
بارگیری نشان‌واره‌های Google Maps
از فایل‌های رسمی نشان‌واره Google Maps استفاده کنید. نشان‌واره‌های زیر را بارگیری کنید و دستورالعمل‌های این بخش را دنبال کنید.
بارگیری دارایی‌های ارجاع Google Mapsهنگام استفاده از نشان‌واره Google Maps، این دستورالعمل‌ها را دنبال کنید.
- به هیچ وجه نشان‌واره را تغییر ندهید.
- نسبت ابعادی نشان‌واره را حفظ کنید تا از اعوجاج جلوگیری شود.
- از نشان‌واره خطی روی پس‌زمینه شلوغ، مثل نقشه یا تصویر، استفاده کنید.
- از نشان‌واره بدون خط پیرامونی روی پس‌زمینه ساده، مثل رنگ یکدست یا گرادیان ملایم، استفاده کنید.
مشخصات اندازه نشان‌واره
برای نشان‌واره Google Maps، این مشخصات اندازه را دنبال کنید:- حداقل ارتفاع نشان‌واره: ۱۶ پیکسل مستقل از تراکم
- حداکثر ارتفاع نشان‌واره: ۱۹ پیکسل مستقل از تراکم
- حداقل فضای خالی نشان‌واره: ۱۰ پیکسل مستقل از تراکم در چپ، راست، و بالا، ۵ پیکسل مستقل از تراکم در پایین
برای آشنایی با dp، به تراکم پیکسل در وب‌سایت Material Design مراجعه کنید.
دسترس‌پذیری نشان‌واره
این الزامات دسترس‌پذیری را برای نشان‌واره Google Maps دنبال کنید:- کنتراست دسترس‌پذیری بین نشان‌واره و پس‌زمینه را حفظ کنید.
- برچسب دسترس‌پذیری با نوشتار Google Maps را اضافه کنید.
انتساب نوشتار
اگر اندازه میانای شما از استفاده از نشان‌واره Google Maps پشتیبانی نمی‌کند، می‌توانید Google Maps را به‌صورت نوشتاری بنویسید. این دستورالعمل‌ها را دنبال کنید:
- نوشتار Google Maps را به هیچ وجه تغییر ندهید:
- حروف بزرگ و کوچک Google Maps را تغییر ندهید
- Google Maps را در چند خط ننویسید
- Google Maps را به زبان دیگری بومی‌سازی نکنید.
- بااستفاده از مشخصه HTML
translate="no"، از ترجمه Google Maps توسط مرورگرها جلوگیری کنید.
نوشتار Google Maps را همان‌طور که در جدول زیر شرح داده شده است سبک‌بندی کنید:
الزامات سبک نوشتار Google Maps دارایی سبک خانواده قلم Roboto. بار کردن قلم اختیاری است. خانواده قلم جایگزین هر قلم سن‌سریف نوشتار اصلی که قبلاً در محصولتان استفاده شده است یا «سن‌سریف» برای فراخوانی قلم پیش‌فرض سیستم سبک قلم معمولی وزن قلم ۴۰۰ رنگ قلم سفید، سیاه (#1F1F1F)، یا خاکستری (#5E5E5E). کنتراست دسترس‌پذیر (۴.۵:۱) را درمقابل پس‌زمینه حفظ کنید. اندازه قلم حداقل اندازه قلم: ۱۲ اس‌پی
حداکثر اندازه قلم: ۱۶ اس‌پی
برای آشنایی با اس‌پی، به واحدهای اندازه قلم در وب‌سایت Material Design مراجعه کنید.فاصله حروف معمولی
نمونه CSS
CSS زیر Google Maps را با سبک و رنگ نوشتاری مناسب در پس‌زمینه سفید یا روشن ارائه می‌دهد.
@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 Maps دنبال کنید.نشان انتساب را نزدیک بالا یا پایین محتوا و در همان ظرف دیداری قرار دهید. برای محتوای تک‌خطی، ارجاع را می‌توان در سمت راست یا چپ قرار داد.
بااستفاده از نشانه‌های میانای کاربری مانند حاشیه، رنگ پس‌زمینه، سایه، یا فضای سفید کافی، «محتوای پلاتفرم Google Maps» را به‌صورت دیداری از محتواهای دیگر متمایز کنید.
- با نسبت دادن Google Maps به محتوای غیر از «پلاتفرم Google Maps»، آن را به‌اشتباه معرفی نکنید.
- مطمئن شوید که ارجاع همیشه قابل‌مشاهده و خوانا باشد. هرگز آن را حذف، پنهان، یا مبهم نکنید یا تغییر ندهید.
شکل‌های زیر نمونه‌هایی از این الزامات بصری را نشان می‌دهد.
ارائه‌دهندگان داده‌های طرف سوم
برخی‌از داده‌ها و تصاویر موجود در محصولات نقشه‌برداری ما از ارائه‌دهندگانی غیراز Google دریافت می‌شود. برای برخی‌از محصولات، مانند Map Tiles API، ممکن است ارجاع لازم به ارائه‌دهنده داده‌های طرف سوم را به شما ارائه دهیم. وقتی این کار را انجام می‌دهیم، متن ارجاع شما باید نام «Google Maps» و ارائه‌دهنده(های) داده مربوطه را ذکر کند، مانند «داده‌های نقشه: Google، Maxar Technologies». وقتی Google ارجاع به طرف سوم ارائه می‌دهد، فقط گنجاندن «Google Maps» یا نشان‌واره Google ارجاع مناسبی نیست.
الزامات اضافی Places API
الزامات زیر مختص Places API است.
تکمیل خودکار برای نشانی‌های کاربر نهایی
وقتی کاربر نهایی از عملکرد «تکمیل خودکار» در «برنامه مشتری» شما برای تایپ کردن نشانی خیابان استفاده می‌کند و آن نشانی خیابان می‌توانست به‌طور کامل و دقیق توسط آن کاربر نهایی بدون «تکمیل خودکار» ارائه شود، نشانی انتخاب‌شده کاربر نهایی مشمول محدودیت‌های «محتوای Google Maps» در «قرارداد پلاتفرم Google Maps» شما نمی‌شود. این استثنا فقط برای نشانی خیابان انتخاب‌شده توسط کاربر نهایی و صرفاً برای تراکنش خاص آن کاربر نهایی اعمال می‌شود؛ این استثنا برای فهرست نشانی‌های پیشنهادی ارائه‌شده توسط عملکرد «تکمیل خودکار» یا سایر «محتوای Google Maps» اعمال نمی‌شود. این استثنا برای هیچ‌کدام از عملکردهای جستجوی نشانی یا نقطه موردعلاقه که توسط دیگر سرویس‌های «پلاتفرم Google Maps» ارائه می‌شود اعمال نمی‌شود.
فهرست نشانی‌های سمت راست همچنان مشمول محدودیت‌های «محتوای Google Maps» است. وقتی کاربر نهایی نشانی انتخابی‌اش را انتخاب می‌کند، آن نشانی صرفاً برای تراکنش قابل‌اجرای آن کاربر نهایی مشمول محدودیت‌های «محتوای Google Maps» نمی‌شود.
عکس‌ها و مرورها
همه محتوا را به نویسنده محتوا نسبت دهید
هنگام نمایش عکس‌ها یا مرورها، همیشه باید نام نویسنده را ذکر کنید. هر عکس و مرور شامل ارجاع به نویسنده (تصویر چهره‌نما، نام، و پیوند نمایه نویسنده) است.
الزامات دیداری برای ذکر منبع:
- درصورت وجود فضای کافی، بااستفاده از همه منابع دردسترس (چهره‌نما، نام، و پیوند نمایه) به نویسنده ارجاع دهید.
- برای مرورها، اگر فضا محدود است، حداقل شرط لازم نمایش چهرک نویسنده است.
- برای عکس‌ها، اگر فضا محدود باشد (مثلاً در گالری یا برای ریزعکس‌ها)، می‌توان از ذکر نام نویسنده صرف‌نظر کرد، مشروط بر اینکه کاربر بتواند به نسخه بزرگ‌تری از تصویر که شامل ذکر نام کامل نویسنده است دسترسی داشته باشد.
- نقل‌قول نویسنده را طوری قرار دهید که به‌وضوح با عکس یا مرور نویسنده مرتبط باشد.
دسترسی مستقیم به محتوای منبع در Google Maps را فراهم می‌کند
برای هر عکس و مرور، کاربران نهایی باید همیشه بااستفاده از googleMapsUri ارائه‌شده به مشاهده عکس یا مرور منبع اصلی در Google Maps دسترسی داشته باشند.
نمایش تاریخ انتشار نسبی (توصیه‌شده) *
نمایش تاریخ انتشار نسبی (برای مثال، «۲ روز پیش») برای عکس‌ها و مرورها بااستفاده از
relativePublishTimeDescription ارائه‌شده اعتماد کاربر را به محتوا افزایش می‌دهد.
فعال کردن گزارش تخلف محتوا (توصیه‌شده) *
عکس‌ها و مرورهای ارائه‌شده ازطریق Places API (جدید) و Places API (قدیمی) در هر کجای دنیا که باشید مشمول خط‌مشی‌های محتوا و محصول Google هستند. شما و کاربران نهایی‌تان می‌توانید محتوایی را که می‌خواهید طبق خط‌مشی‌های Google یا قوانین ذی‌ربط از سرویس‌های Google برداشته شود بااستفاده از flagContentUri برای هر عکس و مرور گزارش کنید. همچنین، محتوا را می‌توان با دنبال کردن پیوند مستقیم به محتوا در Google Maps گزارش کرد، که در آنجا گزارش مشکل نیز دردسترس است.
مرورها
توضیح دهید مرورها چگونه مرتب و فیلتر می‌شوند
اعلان واضحی اضافه کنید که نحوه مرتب‌سازی و فیلتر کردن مرورها را شرح دهد، ازجمله هرگونه معیار جستجوی اعمال‌شده. به‌طور پیش‌فرض، مرورها براساس مربوط بودن مرتب شده‌اند.
نمایش ماه و سالی که مرورکنندگان از مکان‌ها در فرانسه بازدید کرده‌اند
هنگام نمایش مرورهای مکان‌ها در فرانسه و قلمروهای فرانسه، Places API یک
visitDate (ماه و سالی که نویسنده از مکان بازدید کرده است) برمی‌گرداند که باید
در کنار محتوا نمایش داده شود.
اطلاع‌رسانی به کاربران نهایی وقتی مرورها ترجمه شده‌اند (توصیه‌شده) *
وقتی مروری از زبان اصلی‌اش ترجمه شده است، کاربران نهایی را مطلع کنید. می‌توانید به کاربران نهایی امکان دهید نوشتار ترجمه‌نشده اصلی را مشاهده کنند originalText. یا می‌توانند پیوند مستقیم به محتوا را در Google Maps دنبال کنند که در آنجا نوشتار اصلی ترجمه‌نشده دردسترس است.
مرورها و میانگین رده‌بندی
اطلاع‌رسانی به کاربران نهایی درباره نحوه درستی‌سنجی مرورها توسط Google (توصیه‌شده) *
Google مرورها را درستی‌سنجی نمی‌کند، اما وجود محتوای جعلی را بررسی می‌کند و درصورت شناسایی، آن را برمی‌دارد. هنگام نمایش مرورها و رده‌بندی میانگین، کاربران نهایی را از خط‌مشی مرور Google مطلع کنید. درباره خط‌مشی محتوای تولیدشده توسط کاربر Google Maps بیشتر بدانید.
خلاصه‌های هوشواره‌ای
وقتی خلاصه‌های تولیدشده با هوش مصنوعی را در برنامه‌تان نمایش می‌دهید — ازجمله خلاصه‌های مکان، منطقه، و مرور — باید کارهای زیر را انجام دهید:
- نمایش ارجاع‌های الزامی، پیوندهای گزارش‌دهی، و پیوندهای مرجع به‌صورتی که در زیر تعریف شده است.
- کاربران نهایی باید بتوانند متن کامل خلاصه را همان‌طور که Google Maps ارائه کرده است بخوانند.
نمایش نوشتار شفاف‌سازی خلاصه‌های تولیدشده با هوش مصنوعی
هنگام نمایش خلاصه هوشواره‌ای از هر نوع، همیشه نوشتار شفاف‌سازی بومی‌سازی‌شده (ارائه‌شده در فیلد disclosureText بدنه پاسخ) را بلافاصله زیر خلاصه قرار دهید. هرگز نوشتار شفاف‌سازی ارائه‌شده توسط میانای برنامه‌سازی کاربردی را اصلاح یا تقویت نکنید.
الزامات اضافی خلاصه مکان و منطقه
خلاصه‌های مکان و منطقه که در برنامه‌تان نمایش داده می‌شود باید با نوشتار زیر و پیوندهای الزامی همراه باشد:
| نوشتار | الزام |
|---|---|
| درباره این خلاصه | از پیوند زیر برای «چگونگی یافتن منابع اطلاعات فهرستگان‌های محلی و استفاده از آن‌ها توسط Google» استفاده کنید: https://support.google.com/local-listings/answer/9851099. |
| گزارش تخلف خلاصه |
از پیوند موجود در فیلد توجه: خلاصه‌های تولیدشده با هوش مصنوعی که ازطریق Places API (جدید) ارائه می‌شوند، در هر کجای دنیا که باشید، مشمول خط‌مشی‌های محتوا و محصول Google هستند. باید به کاربران نهایی‌تان اطلاع دهید که اگر می‌خواهند محتوایی را گزارش کنند که طبق قوانین ذی‌ربط باید از سرویس‌های Google برداشته شود، باید آن را بااستفاده از نشانی وب ارائه‌شده برای پرچم‌گذاری محتوا ( |
الزامات خلاصه مرورها
خلاصه مرورهای نمایش‌داده‌شده در برنامه‌تان باید با عنوان «خلاصه مرور» همراه باشد. به‌علاوه، باید از نوشتار و پیوندهای الزامی زیر استفاده کنید:
| نوشتار | الزام |
|---|---|
| درباره این خلاصه | از پیوند زیر برای «چگونگی یافتن منابع اطلاعات فهرستگان‌های محلی و استفاده از آن‌ها توسط Google» استفاده کنید: https://support.google.com/local-listings/answer/9851099 |
| گزارش تخلف خلاصه |
از پیوند موجود در فیلد توجه: خلاصه‌های تولیدشده با هوش مصنوعی که ازطریق Places API (جدید) ارائه می‌شوند، در هر کجای دنیا که باشید، مشمول خط‌مشی‌های محتوا و محصول Google هستند. باید به کاربران نهایی‌تان اطلاع دهید که اگر می‌خواهند محتوایی را گزارش کنند که طبق قوانین ذی‌ربط باید از سرویس‌های Google برداشته شود، باید آن را بااستفاده از نشانی وب ارائه‌شده برای پرچم‌گذاری محتوا ( |
| دیدن مرورها | از پیوند موجود در فیلد reviewSummary.reviewsUri پاسخ استفاده کنید. |
نمایش راهنمایی برای موارد استفاده خودرویی
برای ایمنی راننده، Google توصیه می‌کند خلاصه‌های هوش مصنوعی در حالت پارک‌شده برای تجربه‌های خودرویی ارائه شود. اگر خلاصه‌ها را در حالت رانندگی ارائه می‌دهید، اطلاعات روی صفحه باید واضح و مختصر باشد تا اطمینان حاصل شود که توجه راننده به‌سرعت به جاده برمی‌گردد:
- حداکثر ۳ خط
- ۱۲۰ نویسه یا ۲۴ کلمه یا کمتر
- حداقل اندازه جلو ۲۴dp
به‌ویژه در زمینه‌های خودرویی، مسئولیت ارائه خلاصه‌های هوشواره‌ای به‌شیوه‌ای ایمن و مطابق با همه قوانین و مقررات محلی برعهده توسعه‌دهنده است.
نتایج جستجوی مکان
توصیف عوامل تأثیرگذار بر رتبه‌بندی نتایج جستجو (توصیه‌شده) *
درطول یک تعامل کاربر، کاربران نهایی باید از عوامل اصلی و وزن عوامل اصلی که رتبه‌بندی نتایج جستجو را تعیین می‌کنند مطلع شوند.
هنگام استفاده از رتبه‌بندی اصلاح‌نشده Google، می‌توانید متن توضیحی زیر را نمایش دهید:
«وقتی در اطراف جایی دنبال کسب‌وکار یا مکانی می‌گردید، Google Maps نتایج محلی را نشان می‌دهد. چندین عامل — در درجه اول مربوط بودن، فاصله، و برجستگی — باهم ترکیب می‌شوند تا در یافتن بهترین نتایج برای شما کمک کنند. بیشتر بدانید.»
رعایت قوانین ذی‌ربط
شما ملزم هستید که همیشه از همه قوانین ذی‌ربط پیروی کنید. توجه داشته باشید که شیوه‌هایی که در این خط‌مشی‌ها با برچسب (توصیه‌شده) مشخص شده‌اند ممکن است همچنان طبق قانون اجباری باشند. علاوه‌براین، پیروی از همه الزامات اعلام‌شده و رویه‌های توصیه‌شده رعایت کامل استانداردهای قانونی را در همه حوزه‌های قضایی تضمین نمی‌کند. اگر درباره وضعیت متابعت خود سؤالی دارید، باید از مشاور حقوقی‌تان راهنمایی بگیرید.