خط‌مشی‌ها و ارجاعات برای Places Aggregate API

این سند الزامات برنامه‌های توسعه‌یافته با Places Aggregate API را فهرست می‌کند. توجه داشته باشید که استفاده از Places Aggregate API تحت کنترل «قرارداد شما با Google» است.

خط‌مشی‌ها

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

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

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

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

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

• شرایط خدمات Google Maps Platform در منطقه اقتصادی اروپا
• شرایط خاص سرویس پلاتفرم Google Maps در منطقه اقتصادی اروپا
• پرسشگان منطقه اقتصادی اروپا
• الزامات ایمنی جاده‌ای پلاتفرم 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 Platform» را بااستفاده از نشانه‌های میانای کاربری مانند حاشیه، رنگ پس‌زمینه، سایه، یا فضای خالی کافی به‌صورت بصری از محتوای دیگر متمایز کنید.
• هنگام ایجاد تغییرات دیداری، باید از همه الزامات اسنادی 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 را به زبان دیگری بومی‌سازی نکنید.
  • بااستفاده از مشخصه HTML translate="no"، از ترجمه Google Maps توسط مرورگرها جلوگیری کنید.

• نوشتار Google Maps را به‌سبک شرح‌داده‌شده در جدول زیر بنویسید:

  الزامات سبک‌بندی نوشتار Google Maps
  دارایی	سبک
  خانواده قلم	Roboto. بار کردن قلم اختیاری است.
  خانواده قلم جایگزین	هر قلم سن‌سریف نوشتار اصلی که قبلاً در محصولتان استفاده شده است یا «سن‌سریف» برای فراخوانی قلم پیش‌فرض سیستم
  سبک قلم	معمولی
  سیاهی قلم	۴۰۰
  رنگ قلم	سفید، سیاه (#1F1F1F)، یا خاکستری (#5E5E5E). کنتراست دسترس‌پذیر (۴.۵:۱) را درمقابل پس‌زمینه حفظ کنید.
  اندازه قلم	حداقل اندازه قلم: ۱۲ اس‌پی حداکثر اندازه قلم: ۱۶ اس‌پی برای آشنایی با اس‌پی، واحدهای اندازه قلم را در وب‌سایت «طراحی مواد» ببینید.
  فاصله حروف	معمولی

سرویس مقایسه قیمت نمونه

‫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 می‌آید. برای برخی محصولات، مانند Map Tiles API، ممکن است اسناد استنادی موردنیاز را به ارائه‌دهنده داده طرف سوم ارائه دهیم. وقتی این کار را انجام می‌دهیم، نوشتار اسناد باید نام «Google Maps» و ارائه‌دهنده(های) داده مربوطه، مثل «داده‌های نقشه: Google،‏ Maxar Technologies» را ذکر کند. وقتی Google ارجاع به طرف سوم ارائه می‌دهد، فقط گنجاندن «Google Maps» یا نشان‌واره Google ارجاع مناسبی نیست.

سایر الزامات ارجاع

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