خط‌مشی‌ها و تخصیص‌ها برای Places API

این سند الزاماتی را فهرست می‌کند که مختص تمام برنامه‌های توسعه‌یافته با Places API (جدید)، از جمله سرویس تکمیل خودکار (جدید) که بخشی از آن API است، می‌باشد. اطلاعات عمومی بیشتر برای توسعه‌دهندگان Google Maps را می‌توانید در شرایط خدمات پلتفرم Google Maps بیابید.

سیاست‌ها

این بخش سیاست‌های مربوط به Places API را شرح می‌دهد. این سیاست‌ها، دستورالعمل‌ها و الزامات پیاده‌سازی عملی را ارائه می‌دهند تا به شما در استفاده صحیح از سرویس و مطابق با انتظارات پلتفرم نقشه‌های گوگل کمک کنند.

استثنائات محدودیت‌های ذخیره‌سازی

توجه داشته باشید که شناسه مکان ، که برای شناسایی منحصر به فرد یک مکان استفاده می‌شود، از محدودیت‌های ذخیره‌سازی معاف است. بنابراین می‌توانید مقادیر شناسه مکان را به طور نامحدود ذخیره کنید. شناسه مکان در فیلد place_id در پاسخ‌های API بازگردانده می‌شود. نحوه ذخیره، به‌روزرسانی و مدیریت شناسه‌های مکان را در راهنمای شناسه‌های مکان بیاموزید.

کشورها و قلمروهای منطقه اقتصادی اروپا

این محصول برای مشتریانی که آدرس صورتحساب آنها در منطقه اقتصادی اروپا (EEA) است، شرایط خدمات متفاوتی دارد و همچنین ممکن است عملکردهای متفاوتی داشته باشد. قبل از ساخت با پلتفرم Google Maps، شرایط و اطلاعات خاص EEA زیر را بررسی کنید:

• شرایط خدمات پلتفرم نقشه‌های گوگل در منطقه اقتصادی اروپا
• شرایط خاص سرویس پلتفرم نقشه‌های گوگل (Google Maps Platform) در منطقه اقتصادی اروپا (EEA)
• سوالات متداول منطقه اقتصادی اروپا (FAQ)
• الزامات ایمنی جاده‌ای پلتفرم نقشه گوگل

اگر آدرس صورتحساب شما در منطقه اقتصادی اروپا (EEA) نیست، شرایط خدمات زیر برای شما اعمال می‌شود:

• شرایط خدمات پلتفرم نقشه‌های گوگل
• شرایط خاص سرویس پلتفرم نقشه‌های گوگل

الزامات انتساب نقشه‌های گوگل

این بخش الزامات و دستورالعمل‌های مربوط به انتساب را برای نمایش نقشه‌های گوگل و محتوا از طریق برنامه‌های شما ارائه می‌دهد.

توجه: الزامات به‌روزرسانی‌شده‌ی انتساب زیر، اکنون به جای فقط «گوگل»، از «نقشه‌های گوگل» استفاده می‌کنند. ما اذعان داریم که پیاده‌سازی‌های موجود شما ممکن است مطابق با راهنمایی‌های قبلی از انتساب «گوگل» استفاده کنند و فعلاً می‌توانید به استفاده از «گوگل» به عنوان انتساب ادامه دهید. برای پیاده‌سازی‌های جدید، از «نقشه‌های گوگل» همانطور که در این بخش توضیح داده شده است استفاده کنید. در آینده، جدول زمانی و دستورالعمل‌هایی را برای کمک به شما در انتقال انتساب‌های موجود «گوگل» به انتساب‌های «نقشه‌های گوگل» ارائه خواهیم داد.

نمایش اطلاعات مربوط به نقشه گوگل

هنگام نمایش محتوا از APIهای پلتفرم نقشه‌های گوگل در برنامه یا وب‌سایت خود، باید الزامات مربوط به انتساب نقشه‌های گوگل را رعایت کنید. اگر محتوا در نقشه گوگلی نمایش داده می‌شود که انتساب از قبل در آن قابل مشاهده است، نیازی به افزودن انتساب اضافی ندارید.

شامل انتساب نقشه‌های گوگل

برای انتساب نقشه‌های گوگل که از قبل توسط پلتفرم نقشه‌های گوگل در رابط کاربری ارائه شده است، مانند کیت رابط کاربری Places:

• صرف نظر از محل نمایش، منبع ذکر شده را حذف نکنید. منبع را تغییر ندهید، پنهان نکنید یا مبهم نکنید و مطمئن شوید که در پس‌زمینه به وضوح قابل مشاهده است.
• همیشه با استفاده از نشانه‌های رابط کاربری مانند حاشیه، رنگ پس‌زمینه، سایه یا فضای خالی کافی، محتوای پلتفرم نقشه‌های گوگل را از نظر بصری از سایر محتوا متمایز کنید.
• هنگام ایجاد تغییرات بصری، باید تمام الزامات مربوط به انتساب نقشه‌های گوگل را رعایت کنید.

لوگو و متن گوگل مپ

ارجاع باید در صورت امکان به شکل لوگوی گوگل مپ باشد. در مواردی که فضا محدود است، متن گوگل مپ قابل قبول است. همیشه باید برای کاربران نهایی مشخص باشد که کدام محتوا توسط گوگل مپ ارائه می‌شود.

چپ: نمونه‌ای از انتساب لوگوی گوگل مپ، راست: نمونه‌ای از انتساب متن گوگل مپ

انتساب لوگو

برای استفاده از لوگوی گوگل مپ در برنامه یا وب‌سایت خود، این الزامات را رعایت کنید.

نمونه‌هایی از تغییرات قابل قبول برای انتساب لوگوی گوگل مپ

دانلود لوگوهای گوگل مپ

از فایل‌های رسمی لوگوی گوگل مپ استفاده کنید. لوگوهای زیر را دانلود کنید و دستورالعمل‌های این بخش را دنبال کنید.

فایل‌های مربوط به اسناد گوگل مپ را دانلود کنید

هنگام استفاده از لوگوی گوگل مپ، این دستورالعمل‌ها را دنبال کنید.

• به هیچ وجه لوگو را تغییر ندهید.
• برای جلوگیری از اعوجاج، نسبت ابعاد لوگو را حفظ کنید.
• از لوگوی مشخص شده روی یک پس زمینه شلوغ، مانند یک نقشه یا تصویر، استفاده کنید.
• از لوگوی بدون حاشیه روی یک پس‌زمینه ساده، مانند یک رنگ ثابت یا یک گرادیان ظریف، استفاده کنید.

مشخصات اندازه لوگو

برای لوگوی گوگل مپ، این مشخصات اندازه را دنبال کنید:

• حداقل ارتفاع لوگو: 16dp
• حداکثر ارتفاع لوگو: ۱۹dp
• حداقل فضای خالی لوگو: 10dp در سمت چپ، راست و بالا، 5dp در پایین

برای کسب اطلاعات در مورد dp، به بخش تراکم پیکسل در وب‌سایت Material Design مراجعه کنید.

نمونه‌ای از لوگوی گوگل مپ که حداقل فضای خالی و محدوده اندازه قابل قبول را نشان می‌دهد

دسترسی‌پذیری لوگو

این الزامات دسترسی را برای لوگوی گوگل مپس دنبال کنید:

• بین لوگو و پس‌زمینه، تضاد قابل قبولی ایجاد کنید.
• یک برچسب دسترسی‌پذیری با متن Google Maps اضافه کنید.

نمونه‌هایی از تغییرات غیرقابل قبول و مشکلات دسترسی برای انتساب لوگوی گوگل مپس

انتساب متن

اگر اندازه رابط کاربری شما با استفاده از لوگوی نقشه گوگل پشتیبانی نمی‌شود، می‌توانید نقشه گوگل را با متن بنویسید. این دستورالعمل‌ها را دنبال کنید:

نمونه‌هایی از تغییرات قابل قبول در انتساب متن نقشه‌های گوگل

• متن نقشه‌های گوگل را به هیچ وجه تغییر ندهید:
  
  • حروف بزرگ و کوچک گوگل مپ را تغییر ندهید
  • نقشه‌های گوگل را در چندین خط قرار ندهید
  • نقشه‌های گوگل را به زبان دیگری بومی‌سازی نکنید.
  • با استفاده از ویژگی HTML translate="no" از ترجمه نقشه‌های گوگل توسط مرورگرها جلوگیری کنید.

نمونه‌هایی از تغییرات غیرقابل قبول در انتساب متن نقشه‌های گوگل

• متن نقشه گوگل را مطابق جدول زیر استایل دهید:

  الزامات مربوط به سبک‌دهی متن در نقشه گوگل
  ملک	سبک
  خانواده فونت	بارگذاری فونت اختیاری است.
  خانواده فونت جایگزین	هر فونت بدنه‌ی سنس‌سریف که از قبل در محصول شما استفاده شده است یا "سنس‌سریف" برای فراخوانی فونت پیش‌فرض سیستم
  سبک فونت	عادی
  وزن فونت	۴۰۰
  رنگ فونت	سفید، مشکی (#1F1F1F) یا خاکستری (#5E5E5E). کنتراست (4.5:1) قابل قبول را نسبت به پس‌زمینه حفظ کنید.
  اندازه فونت	حداقل اندازه فونت: 12sp حداکثر اندازه فونت: 16sp برای کسب اطلاعات در مورد sp، به واحدهای اندازه فونت در وب‌سایت Material Design مراجعه کنید.
  فاصله حروف	عادی

مثال CSS

کد CSS زیر نقشه‌های گوگل را با سبک و رنگ تایپوگرافی مناسب روی پس‌زمینه سفید یا روشن نمایش می‌دهد.

@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;
}

الزامات بصری

برای نحوه‌ی نمایش بصری ارجاعات نقشه‌های گوگل، این الزامات را رعایت کنید.

• انتساب را در نزدیکی بالا یا پایین محتوا و در همان ظرف بصری قرار دهید. برای یک خط محتوا، انتساب می‌تواند در سمت راست یا چپ قرار گیرد.

• با استفاده از نشانه‌های رابط کاربری مانند حاشیه، رنگ پس‌زمینه، سایه یا فضای خالی کافی، محتوای پلتفرم نقشه‌های گوگل را از سایر محتواها به صورت بصری متمایز کنید.

• با نسبت دادن محتوای غیر از پلتفرم نقشه‌های گوگل، نقشه‌های گوگل را تحریف نکنید.
• تأیید کنید که منبع همیشه قابل مشاهده و خوانا باشد. هرگز آن را حذف، پنهان، مبهم یا تغییر ندهید.

شکل‌های زیر نمونه‌هایی از این الزامات بصری را نشان می‌دهند.

نمونه‌ای از انتساب نقشه‌های گوگل که در بالا، پایین و کنار محتوا قرار گرفته است

مثالی از دو رویکرد برای تمایز محتوای نقشه‌های گوگل (رتبه‌بندی مکان) از سایر محتواها

منبع گوگل مپ را مبهم نکنید یا آن را با محتوای منابع دیگر ترکیب نکنید.

ارائه دهندگان داده شخص ثالث

برخی از داده‌ها و تصاویر موجود در محصولات نقشه‌برداری ما از ارائه‌دهندگانی غیر از گوگل می‌آیند. برای برخی از محصولات، مانند Map Tiles API، ممکن است نسبت‌دهی لازم به ارائه‌دهنده داده شخص ثالث را در اختیار شما قرار دهیم. در این صورت، متن نسبت‌دهی شما باید شامل نام "Google Maps" و ارائه‌دهنده(گان) داده مربوطه، مانند "Map data: Google, Maxar Technologies" باشد. هنگامی که گوگل نسبت‌دهی شخص ثالث را ارائه می‌دهد، فقط ذکر "Google Maps" یا لوگوی گوگل، نسبت‌دهی مناسبی محسوب نمی‌شود.

الزامات اضافی API مکان‌ها

الزامات زیر مختص Places API هستند.

تکمیل خودکار آدرس‌های کاربر نهایی

وقتی یک کاربر نهایی از قابلیت تکمیل خودکار در برنامه مشتری شما برای تایپ آدرس خیابان استفاده می‌کند و آن آدرس خیابان بدون تکمیل خودکار توسط آن کاربر نهایی به طور کامل و دقیق ارائه می‌شد، آدرس انتخابی کاربر نهایی مشمول محدودیت‌های محتوای نقشه‌های گوگل در توافقنامه پلتفرم نقشه‌های گوگل شما نمی‌شود. این استثنا فقط برای آدرس خیابان انتخاب شده توسط کاربر نهایی و منحصراً برای تراکنش خاص آن کاربر نهایی اعمال می‌شود؛ این استثنا در مورد لیست آدرس‌های پیشنهادی ارائه شده توسط قابلیت تکمیل خودکار یا سایر محتوای نقشه‌های گوگل اعمال نمی‌شود. این استثنا در مورد هیچ یک از نقاط مورد علاقه یا قابلیت جستجوی آدرس ارائه شده توسط سایر سرویس‌های پلتفرم نقشه‌های گوگل اعمال نمی‌شود.

فهرست آدرس‌های سمت چپ همچنان مشمول محدودیت‌های محتوای نقشه‌های گوگل است. هنگامی که کاربر نهایی آدرس مورد نظر خود را انتخاب می‌کند، آن آدرس صرفاً برای اهداف تراکنش مربوطه آن کاربر نهایی، مشمول محدودیت‌های محتوای نقشه‌های گوگل نمی‌شود.

عکس‌ها و بررسی‌ها

تمام محتوا را به نویسنده محتوا نسبت دهید

هنگام نمایش عکس‌ها یا نقدها، همیشه باید به نویسنده ارجاع دهید. هر عکس و نقد شامل ارجاع به نویسنده (تصویر آواتار نویسنده، نام و لینک پروفایل) است.

الزامات بصری برای انتساب به نویسنده:

• در صورت امکان، با استفاده از تمام منابع موجود (آواتار، نام و لینک پروفایل) به نویسنده نسبت دهید.
• برای نقد و بررسی، اگر فضا محدود است، حداقل الزام نمایش آواتار نویسنده است.
• برای عکس‌ها، اگر فضا محدود باشد (مانند گالری یا برای تصاویر کوچک)، می‌توان از ذکر نام پدیدآورنده صرف نظر کرد، البته به شرطی که کاربر بتواند به نسخهٔ بزرگ‌تری از تصویر که شامل نام کامل پدیدآورنده است، دسترسی داشته باشد.
• انتساب نویسنده را طوری قرار دهید که به وضوح با عکس یا نقد نویسنده مرتبط باشد.

نمونه‌ای از ارجاع به نویسنده که در گوشه بالا سمت چپ عکس و نقد نمایش داده شده است

دسترسی مستقیم به محتوای منبع در نقشه‌های گوگل را فراهم کنید

برای هر عکس و نقد، کاربران نهایی باید همیشه با استفاده از googleMapsUri ارائه شده، به مشاهده عکس یا نقد منبع به صورت جداگانه در Google Maps دسترسی داشته باشند.

نمونه‌ای از یک منوی عمودی با لینک‌هایی برای مشاهده عکس منبع یا بررسی در نقشه‌های گوگل

نمایش تاریخ انتشار نسبی (توصیه می‌شود) *

نمایش تاریخ انتشار نسبی (مثلاً «۲ روز پیش») برای عکس‌ها و نظرات با استفاده از ویژگی نسبی relativePublishTimeDescription ، اعتماد کاربر به محتوا را افزایش می‌دهد.

فعال کردن گزارش محتوا (توصیه می‌شود) *

Photos and reviews provided through the Places API are subject to Google's content and product policies wherever you are in the world. You and your end-users can report content that you would like removed from Google's services under Google's policies or applicable laws using the flagContentUri for each photo and review. Alternatively, content can be reported by following the direct link to the content on Google Maps, where reporting a problem is also available.

نقد و بررسی‌ها

نحوه مرتب سازی و فیلتر کردن نظرات را شرح دهید

یک اطلاعیه واضح قرار دهید که نحوه مرتب‌سازی و فیلتر کردن نظرات، از جمله هرگونه معیار جستجوی اعمال شده را شرح دهد. به طور پیش‌فرض، نظرات بر اساس مرتبط بودن مرتب می‌شوند.

نمونه‌ای از اطلاعیه‌ای که نحوه‌ی سفارش نقد و بررسی‌ها را شرح می‌دهد

ماه و سالی را که منتقدان از مکان‌های فرانسه بازدید کرده‌اند نمایش دهید

هنگام نمایش نظرات مربوط به مکان‌ها در فرانسه و سرزمین‌های فرانسوی، API مکان‌ها یک visitDate (ماه و سالی که نویسنده از آن مکان بازدید کرده است) برمی‌گرداند که باید در کنار محتوا نمایش داده شود.

نمونه‌ای از تاریخ بازدید که در زیر نظر کاربر نمایش داده شده است

اطلاع‌رسانی به کاربران نهایی هنگام ترجمه نظرات (توصیه می‌شود) *

کاربران نهایی را از ترجمه شدن نقد از زبان اصلی مطلع کنید. می‌توانید به کاربران نهایی این امکان را بدهید که متن اصلی ترجمه نشده originalText مشاهده کنند. همچنین، آنها می‌توانند لینک مستقیم محتوا را در نقشه‌های گوگل که متن اصلی ترجمه نشده در آن موجود است، دنبال کنند.

نمونه‌ای از اطلاعیه ترجمه که در زیر نظر کاربر نمایش داده شده است

بررسی‌ها و میانگین امتیاز

کاربران نهایی را در مورد نحوه تأیید نظرات توسط گوگل مطلع کنید (توصیه می‌شود) *

نظرات توسط گوگل تأیید نمی‌شوند، اما گوگل محتوای جعلی را بررسی و در صورت شناسایی حذف می‌کند. هنگام نمایش نظرات و میانگین امتیاز، کاربران نهایی را از سیاست بررسی گوگل مطلع کنید. درباره سیاست محتوای تولید شده توسط کاربر در نقشه‌های گوگل بیشتر بدانید .

نمونه‌ای از اطلاعیه‌ای که سیاست بررسی گوگل را شرح می‌دهد

خلاصه‌های مبتنی بر هوش مصنوعی

وقتی خلاصه‌های مبتنی بر هوش مصنوعی را در برنامه خود نمایش می‌دهید - از جمله خلاصه مکان، منطقه و نظرات - باید موارد زیر را انجام دهید:

• انتساب‌های مورد نیاز، لینک‌های گزارش‌دهی و لینک‌های مرجع را مطابق تعریف زیر نمایش دهید.
• کاربران نهایی باید بتوانند متن خلاصه کامل را همانطور که توسط نقشه‌های گوگل ارائه شده است، بخوانند.

نمایش متن افشای خلاصه‌های مبتنی بر هوش مصنوعی

هنگام نمایش خلاصه‌ای از هر نوع که توسط هوش مصنوعی ارائه می‌شود، همیشه متن افشای اطلاعات محلی (که در فیلد disclosureText در بدنه پاسخ ارائه شده است) را بلافاصله زیر خلاصه قرار دهید. هرگز متن افشای اطلاعات ارائه شده توسط API را تغییر یا اضافه نکنید.

متن افشا به درستی در زیر هر یک از سه نوع خلاصه مبتنی بر هوش مصنوعی نمایش داده می‌شود

خلاصه مکان و منطقه، الزامات اضافی

Place and area summaries displayed in your app must be accompanied by the following text and required links:

متن	مورد نیاز
درباره این خلاصه	برای «نحوه یافتن منابع و استفاده از اطلاعات فهرست‌های محلی توسط گوگل» از لینک زیر استفاده کنید: https://support.google.com/local-listings/answer/9851099 .
خلاصه گزارش	از لینک موجود در فیلد flagContentUri پاسخ استفاده کنید تا امکان گزارش مشکل به گوگل در مورد محتوای خلاصه فراهم شود. توجه: خلاصه‌های مبتنی بر هوش مصنوعی که از طریق API Places (جدید) ارائه می‌شوند، در هر کجای دنیا که باشید، تابع سیاست‌های محتوا و محصول گوگل هستند. شما موظف هستید به کاربران نهایی خود اطلاع دهید که اگر مایل به گزارش محتوایی هستند که باید طبق قوانین مربوطه از سرویس‌های گوگل حذف شود، باید آن را با استفاده از آدرس اینترنتی محتوای پرچم ( flagContentUri ) ارائه شده گزارش دهند.

خلاصه منطقه با هوش مصنوعی نمایش داده می‌شود و پیوندهای مرتبط مورد نیاز با استفاده از یک منوی سرریز در دسترس کاربران نهایی قرار می‌گیرد.

الزامات خلاصه بررسی

خلاصه نظرات نمایش داده شده در برنامه شما باید با عنوانی با متن «خلاصه نظرات» همراه باشد. علاوه بر این، باید از متن زیر و لینک‌های مورد نیاز استفاده کنید:

متن	مورد نیاز
درباره این خلاصه	برای دسترسی به «نحوه یافتن منابع و استفاده از اطلاعات فهرست‌های محلی توسط گوگل» از لینک زیر استفاده کنید: https://support.google.com/local-listings/answer/9851099
خلاصه گزارش	از لینک موجود در فیلد flagContentUri پاسخ استفاده کنید. توجه: خلاصه‌های مبتنی بر هوش مصنوعی که از طریق API Places (جدید) ارائه می‌شوند، در هر کجای دنیا که باشید، تابع سیاست‌های محتوا و محصول گوگل هستند. شما موظف هستید به کاربران نهایی خود اطلاع دهید که اگر مایل به گزارش محتوایی هستند که باید طبق قوانین مربوطه از سرویس‌های گوگل حذف شود، باید آن را با استفاده از آدرس اینترنتی محتوای پرچم ( flagContentUri ) ارائه شده گزارش دهند.
نظرات را ببینید	از لینک موجود در فیلد reviewSummary.reviewsUri پاسخ استفاده کنید.

خلاصه بررسی مبتنی بر هوش مصنوعی به همراه لینک‌های مرتبط مورد نیاز که با استفاده از یک منوی سرریز در دسترس کاربران نهایی قرار می‌گیرد، نمایش داده می‌شود.

نمایش راهنمایی برای موارد استفاده خودرو

برای ایمنی راننده، گوگل توصیه می‌کند خلاصه‌های هوش مصنوعی را در حالت پارک شده برای تجربیات رانندگی ارائه دهید. در صورت ارائه خلاصه‌ها در حالت رانندگی، اطلاعات روی صفحه باید واضح و مختصر باشند تا اطمینان حاصل شود که توجه راننده به سرعت به جاده باز می‌گردد:

• بیش از ۳ خط نباشد
• ۱۲۰ کاراکتر یا ۲۴ کلمه یا کمتر
• حداقل اندازه جلویی 24dp

به خصوص در زمینه‌های خودرو، این مسئولیت توسعه‌دهنده است که خلاصه‌های مبتنی بر هوش مصنوعی را به روش‌هایی ایمن و مطابق با تمام قوانین و مقررات محلی ارائه دهد.

نتایج جستجو را قرار دهید

عواملی را که بر رتبه‌بندی نتایج جستجو تأثیر می‌گذارند شرح دهید (توصیه می‌شود) *

در یک تعامل با کاربر، کاربران نهایی باید از عوامل اصلی و وزن عوامل اصلی که رتبه‌بندی نتایج جستجو را تعیین می‌کنند، آگاه شوند.

هنگام استفاده از رتبه‌بندی اصلاح‌نشده گوگل، می‌توانید متن توضیحی زیر را نمایش دهید:

«هنگام جستجوی مشاغل یا مکان‌های نزدیک به یک مکان، نقشه‌های گوگل نتایج محلی را نشان می‌دهند. چندین عامل - در درجه اول ارتباط، فاصله و برجستگی - با هم ترکیب می‌شوند تا به یافتن بهترین نتایج برای جستجو کمک کنند. اطلاعات بیشتر .»

گفتگویی که نحوه تعیین رتبه‌بندی نتایج جستجو توسط گوگل را شرح می‌دهد

انطباق با قوانین مربوطه

شما موظف هستید که در همه حال به تمام قوانین مربوطه پایبند باشید. توجه داشته باشید که رویه‌هایی که در این سیاست‌ها با عنوان (توصیه شده) مشخص شده‌اند، ممکن است همچنان توسط قانون الزامی باشند. علاوه بر این، پیروی از تمام الزامات ذکر شده و رویه‌های توصیه شده، رعایت کامل قانون را در تمام حوزه‌های قضایی تضمین نمی‌کند. اگر در مورد وضعیت رعایت قوانین خود سؤالی دارید، باید از مشاور حقوقی خود راهنمایی بگیرید.