API سیاست‌های Places

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

سیاست ها

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

استثناهایی از محدودیت های حافظه پنهان

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

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

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

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

الزامات اسناد Google Maps

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

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

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

شامل اسناد Google Maps

برای اسناد Google Maps که قبلاً توسط Google Maps Platform در رابط کاربری ارائه شده است، مانند Places UI Kit:

  • انتساب اضافه شده را صرف نظر از جایی که نمایش داده می شود، حذف نکنید. انتساب را تغییر ندهید، پنهان یا مبهم نکنید و مطمئن شوید که به وضوح در پس زمینه قابل مشاهده است.
  • همیشه با استفاده از نشانه‌های رابط کاربری مانند حاشیه، رنگ پس‌زمینه، سایه یا فضای خالی کافی، محتوای پلتفرم 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 دنبال کنید:
  • حداقل ارتفاع لوگو: 16dp
  • حداکثر ارتفاع لوگو: 19dp
  • حداقل فضای خالی لوگو: 10dp در سمت چپ، راست و بالا، 5dp در پایین

برای آشنایی با dp، تراکم پیکسلی را در وب سایت طراحی متریال ببینید.

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

قابلیت دسترسی به لوگو

این الزامات دسترسی را برای نشان‌واره Google Maps دنبال کنید:
تغییرات غیرقابل قبول و مشکلات دسترسی برای ارجاع نشان‌واره Google Maps
تغییرات غیرقابل قبول و مشکلات دسترسی برای ارجاع نشان‌واره 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
  • به متن Google Maps همانطور که در جدول زیر توضیح داده شده است، سبک دهید:

    الزامات استایل متن Google Maps
    اموال سبک
    خانواده فونت ربات . بارگیری فونت اختیاری است.
    خانواده فونت بازگشتی هر فونت بدنه sans serif که قبلاً در محصول شما استفاده شده است یا "Sans-Serif" برای فراخوانی فونت پیش‌فرض سیستم
    سبک فونت عادی
    وزن فونت 400
    رنگ فونت سفید، سیاه (#1F1F1F) یا خاکستری (#5E5E5E). کنتراست قابل دسترس (4.5:1) را در پس زمینه حفظ کنید.
    اندازه فونت حداقل اندازه فونت: 12sp
    حداکثر اندازه فونت: 16 sp
    برای آشنایی با sp، واحدهای اندازه فونت را در وب سایت طراحی متریال ببینید.
    فاصله حروف عادی

مثال 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;
}

الزامات بصری

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

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

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

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

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

مثالی از سه رویکرد برای متمایز کردن محتوای Google Maps (رتبه‌بندی مکان) از سایر محتواها
مثالی از سه رویکرد برای متمایز کردن محتوای Google Maps (رتبه‌بندی مکان) از سایر محتواها

انتساب Google Maps را مبهم نکنید یا آن را با محتوای منابع دیگر مخلوط نکنید
انتساب Google Maps را مبهم نکنید یا آن را با محتوای منابع دیگر مخلوط نکنید

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

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

سایر الزامات انتساب

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

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

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

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

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

اسناد شخص ثالث

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

بازیابی اسناد از یک مکان

اگر برنامه شما اطلاعاتی را که با تماس با جزئیات مکان به دست آمده را با شناسه مکان نمایش می دهد، برنامه باید اسناد شخص ثالث را نیز برای جزئیات مکان به دست آمده نمایش دهد.

Attribution ها در شی Place یک پاسخ با یک شی Attribution نشان داده می شوند. برای افزودن Attribution به پاسخ، places.attributions (جستجوی نزدیک و جستجوی متن) یا attributions (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

فیلدهای آبجکت Attribution رشته‌هایی هستند که شامل provider و providerUri Uri انتساب هستند، یا در صورتی که هیچ خصیصه‌ای برای نمایش وجود نداشته باشد، یک رشته خالی است.

نمایش مشخصات یک عکس

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

جزئیات مربوط به عکس در یک شی Place پاسخ در آرایه photos موجود است. برای افزودن آرایه photos به پاسخ، places.photos (جستجوی نزدیک و جستجوی متن) یا photos (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

هر عنصر از آرایه photos نمونه ای از Photo است که حاوی آرایه authorAttributions از نوع AuthorAttribution است.

فیلدهای شیء AuthorAttribution رشته‌هایی هستند که حاوی displayName ، uri و photoUri انتساب هستند، یا اگر هیچ انتسابی برای نمایش وجود نداشته باشد، یک رشته خالی است.

نمایش یک بررسی

یک شی Place در یک پاسخ می تواند تا پنج نظر داشته باشد. می توانید به صورت اختیاری این نظرات را در برنامه خود نمایش دهید.

هنگام نمایش نظرات ارائه شده توسط کاربران Google، باید نام نویسنده را در نزدیکی قرار دهید. وقتی در فیلد انتساب نویسنده شی Review موجود است، توصیه می کنیم عکس نویسنده و پیوند به نمایه او را نیز اضافه کنید. تصویر زیر نمونه ای از بررسی یک پارک را نشان می دهد:

نمایش انتساب نویسنده

گوگل همچنین توصیه می کند که نحوه مرتب سازی نظرات را به کاربر نهایی نشان دهید.

هر بررسی در یک شی Place از یک پاسخ توسط یک شی Review نشان داده می شود. برای افزودن شی Review به پاسخ، places.reviews (جستجوی نزدیک و جستجوی متن) یا reviews (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

فیلدهای شیء Review حاوی انتساب هستند، یا اگر هیچ انتسابی برای نمایش وجود نداشته باشد خالی هستند.

اسناد نتایج جستجو

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

سربرگ: درباره این نتایج

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

دکمه 1: بیشتر بدانید
متن "بیشتر بیاموزید" باید به مقاله مرکز راهنمایی پیوند داده شود.

دکمه 2: خوب

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

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

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

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

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

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

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

خلاصه مکان و منطقه نمایش داده شده در برنامه شما باید با متن زیر و پیوندهای ضروری همراه باشد:

متن مورد نیاز
در مورد این خلاصه از پیوند زیر برای «نحوه منابع Google و استفاده از اطلاعات در فهرست‌های محلی» استفاده کنید: https://support.google.com/local-listings/answer/9851099 .
خلاصه گزارش

از پیوند موجود در قسمت flagContentUri پاسخ برای فعال کردن گزارش یک مشکل در مورد محتوای خلاصه به Google استفاده کنید.

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

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

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

خلاصه مرورهای نمایش داده شده در برنامه شما باید با عنوانی با متن "بازبینی خلاصه" همراه باشد. علاوه بر این، باید از متن زیر و پیوندهای مورد نیاز استفاده کنید:

متن مورد نیاز
در مورد این خلاصه از پیوند زیر برای «نحوه استفاده از اطلاعات Google در فهرست‌های محلی» استفاده کنید: https://support.google.com/local-listings/answer/9851099
خلاصه گزارش

از پیوند موجود در قسمت flagContentUri پاسخ استفاده کنید.

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

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

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

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

  • بیش از 3 خط نیست
  • 120 کاراکتر یا 24 کلمه یا کمتر
  • حداقل اندازه جلو 24dp

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