این سند فهرستی از الزامات ویژه همه برنامههایی است که با Places API (جدید) توسعه داده شدهاند، ازجمله سرویس «تکمیل خودکار (جدید)» که بخشی از آن API است. اطلاعات کلی بیشتر برای توسعهدهندگان Google Maps را میتوانید در شرایط خدمات پلاتفرم Google Maps پیدا کنید.
خطمشیها
این بخش خطمشیهای مربوط به «میانای برنامهسازی کاربردی مکانها» را شرح میدهد. خطمشیها دستورالعملها و الزامات اجرایی عملی ارائه میدهند تا به شما کمک کنند از «سرویس» بهدرستی و مطابق با انتظارات «پلاتفرم Google Maps» استفاده کنید.
استثنائات محدودیتهای ذخیره کردن در حافظه نهان
توجه داشته باشید که شناسه مکان که برای شناسایی منحصربهفرد مکان استفاده میشود،
از محدودیتهای ذخیره در حافظه نهان معاف است.
بنابراین میتوانید مقادیر شناسه مکان را برای همیشه ذخیره کنید.
شناسه مکان در فیلد place_id در
پاسخهای میانای برنامهسازی کاربردی برگردانده میشود. در راهنمای شناسههای مکان با نحوه ذخیره، بازآوری، و مدیریت شناسههای مکان آشنا شوید.
کشورها و قلمروهای منطقه اقتصادی اروپا
این محصول برای مشتریانی که نشانی صورتحساب آنها در منطقه اقتصادی اروپا (EEA) است «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد متفاوتی نیز داشته باشد. قبلاز ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:
- شرایط خدمات پلاتفرم Google Maps در منطقه اقتصادی اروپا
- شرایط خاص سرویس پلاتفرم Google Maps در منطقه اقتصادی اروپا
- پرسشگان منطقه اقتصادی اروپا
- الزامات ایمنی جادهای پلاتفرم Google Maps
اگر نشانی صورتحساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال میشود:
الزامات ذکر منبع Google Maps
این بخش الزامات و دستورالعملهای ذکر منبع را برای نمایش Google Maps و محتوا ازطریق برنامههایتان ارائه میدهد.
نمایش اسناد Google Maps
هنگام نمایش «محتوا» از میاناهای برنامهسازی کاربردی «پلاتفرم Google Maps» در برنامه یا وبسایتتان، باید الزامات ذکر منبع Google Maps را رعایت کنید. اگر «محتوا» در «نقشه Google» نشان داده شود و اسناد قبلاً نمایان باشد، نیازی به افزودن اسناد اضافی نیست.
اسناد Google Maps اضافه شد
برای ارجاع Google Maps که ازقبل توسط «پلاتفرم Google Maps» در میانای کاربر ارائه شده است، مثلاً در «کیت میانای کاربر جاها»:
- صرفنظر از جایی که اسناد نمایش داده میشود، اسناد ذکرشده را حذف نکنید. اسناد را تغییر ندهید، پنهان نکنید، یا مبهم نکنید و مطمئن شوید که در پسزمینه بهوضوح قابل مشاهده است.
- همواره «محتوای پلاتفرم Google Maps» را بااستفاده از نشانههای میانای کاربری مانند حاشیه، رنگ پسزمینه، سایه، یا فضای خالی کافی، از سایر محتواها بهصورت بصری متمایز کنید.
- هنگام ایجاد تغییرات دیداری، باید از همه الزامات اسنادی 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). تضاد (۴٫۵:۱) دسترسپذیر را دربرابر پسزمینه حفظ کنید. اندازه قلم حداقل اندازه قلم: ۱۲ اسپی
حداکثر اندازه قلم: ۱۶ اسپی
برای آشنایی با اسپی، واحدهای اندازه قلم را در وبسایت «طراحی مواد» ببینید.فاصله حروف معمولی
نمونه 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
الزامات زیر مختص «میانای برنامهسازی کاربردی مکانها» است.
تکمیل خودکار برای نشانیهای کاربر نهایی
وقتی کاربر نهایی از عملکرد «تکمیل خودکار» در «برنامه مشتری» شما برای تایپ کردن پیشاز نشانی خیابان استفاده میکند و آن نشانی خیابان بدون «تکمیل خودکار» بهطور کامل و دقیق توسط آن کاربر نهایی ارائه میشد، نشانی انتخابی کاربر نهایی مشمول محدودیتهای «محتوای Google Maps» در «قرارداد پلاتفرم Google Maps» شما نمیشود. این استثنا فقط برای نشانی خیابان انتخابشده توسط کاربر نهایی و صرفاً برای تراکنش خاص آن کاربر نهایی اعمال میشود؛ این استثنا برای فهرست نشانیهای پیشنهادی ارائهشده توسط عملکرد «تکمیل خودکار» یا سایر «محتوای Google Maps» اعمال نمیشود. این استثنا برای هیچکدام از عملکردهای جستجوی نشانی یا نقطه موردعلاقه که توسط دیگر سرویسهای «پلاتفرم Google Maps» ارائه میشود اعمال نمیشود.
فهرست نشانی در سمت راست همچنان تابع محدودیتهای «محتوای Google Maps» است. پساز اینکه کاربر نهایی نشانی موردنظرش را انتخاب کرد، آن نشانی صرفاً برای هدف انجام معامله مربوط به آن کاربر نهایی مشمول محدودیتهای «محتوای Google Maps» نمیشود.
عکسها و مرورها
نسبت دادن همه محتوا به نویسنده محتوا
هنگام نمایش عکسها یا مرورها، همیشه باید نام نویسنده را ذکر کنید. هر عکس و مرور شامل ارجاع به نویسنده (تصویر چهرهنما، نام، و پیوند نمایه نویسنده) است.
الزامات دیداری برای ذکر منبع نویسنده:
- وقتی فضا اجازه میدهد، نویسنده را بااستفاده از همه منابع دردسترس (چهرک، نام، و پیوند نمایه) نسبت دهید.
- برای مرورها، اگر فضا محدود است، حداقل الزام نمایش چهرک نویسنده است.
- برای عکسها، اگر فضا محدود باشد (مثلاً در گالری یا برای ریزعکسها)، میتوان ارجاع به نویسنده را حذف کرد، مشروط بر اینکه کاربر بتواند به نسخه بزرگتری از تصویر که شامل ارجاع کامل به نویسنده است دسترسی داشته باشد.
- ارجاع به نویسنده را طوری قرار دهید که بهوضوح با عکس یا مرور نویسنده مرتبط باشد.
دسترسی مستقیم به محتوای منبع در Google Maps را فراهم کنید
کاربران نهایی باید همیشه بتوانند عکس منبع یا مرور را در Google Maps بااستفاده از googleMapsUri ارائهشده برای هر عکس و مرور مشاهده کنند.
نمایش تاریخ انتشار نسبی (توصیه میشود) *
نمایش تاریخ انتشار نسبی (برای مثال، «۲ روز پیش») برای عکسها و مرورها بااستفاده از
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 نتایج محلی را نشان میدهد. چندین عامل — در درجه اول مربوط بودن، فاصله، و برجستگی — باهم ترکیب میشوند تا در یافتن بهترین نتایج برای جستجو کمک کنند. بیشتر بدانید."
رعایت قوانین ذیربط
شما ملزم هستید که همیشه از همه قوانین ذیربط پیروی کنید. توجه داشته باشید که رویههایی که در این خطمشیها بهعنوان (توصیهشده) برچسبگذاری شدهاند ممکن است همچنان براساس قانون الزامی باشند. علاوهبراین، پیروی از همه الزامات بیانشده و رویههای توصیهشده رعایت کامل استانداردهای قانونی را در همه حوزههای قضایی تضمین نمیکند. اگر درباره وضعیت انطباق خود سؤالاتی دارید، باید از مشاور حقوقی خود راهنمایی بخواهید.