خط‌مشی‌ها و ارجاع‌های «میانای برنامه‌سازی کاربردی آب‌وهوا»

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

خط‌مشی‌ها

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

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

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

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

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

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

الزامات ذکر منبع Google Maps

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

نمایش اسناد Google Maps

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

اسناد 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

بارگیری نشان‌واره‌های 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 را به‌صورت نوشتاری بنویسید. این دستورالعمل‌ها را دنبال کنید:

گونه‌های قابل‌قبول اسناد نوشتاری 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
    دارایی سبک
    خانواده قلم Roboto. بار کردن قلم اختیاری است.
    خانواده قلم جایگزین هر قلم سن‌سریف نوشتار اصلی که ازقبل در محصولتان استفاده شده است یا «سن‌سریف» برای فراخواندن قلم سیستم پیش‌فرض
    سبک قلم معمولی
    سیاهی قلم ۴۰۰
    رنگ قلم سفید، سیاه (#1F1F1F)، یا خاکستری (#5E5E5E). کنتراست دسترس‌پذیر (۴.۵:۱) را درمقابل پس‌زمینه حفظ کنید.
    اندازه قلم حداقل اندازه قلم: ۱۲ اس‌پی
    حداکثر اندازه قلم: ۱۶ اس‌پی
    برای آشنایی با اس‌پی، به واحدهای اندازه قلم در وب‌سایت Material Design مراجعه کنید.
    فاصله حروف معمولی

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

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 Maps که در بالا، پایین، و کنار محتوا قرار گرفته است
نمونه‌ای از ارجاع Google Maps که در بالا، پایین، و کنار محتوا قرار گرفته است

نمونه‌ای از دو رویکرد برای متمایز کردن «محتوای Google Maps» (رده‌بندی مکان) از محتوای دیگر
نمونه‌ای از دو رویکرد برای متمایز کردن «محتوای Google Maps» (رده‌بندی مکان) از محتوای دیگر

اسناد Google Maps را مبهم نکنید یا آن را با محتوای منابع دیگر ترکیب نکنید
ارجاع Google Maps را پنهان نکنید یا آن را با محتوای منابع دیگر ترکیب نکنید

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

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

سایر الزامات ذکر منبع

اگر از داده‌ها یا تصاویر نمایشی Weather API استفاده می‌کنید، باید ارجاع زیر را در کنار یا روی داده‌ها یا تصاویر استفاده‌شده، یا همراه با ارجاع به اشخاص ثالث دیگر، درج کنید: «منبع: شامل داده‌های آب‌وهوا از Google»

اسناد هنگام ایجاد محتوای جدید بااستفاده از داده‌های «میاناهای برنامه‌سازی کاربردی محیط»

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

اگر داده‌های «کیفیت هوا»، «گرده»، «خورشیدی»، یا «آب‌وهوا» را همان‌گونه که هست، بدون هیچ تغییری، نمایش می‌دهید، از نوشتار ارجاع یا نشان‌واره Google Maps استفاده کنید.

سمت راست: داده‌های «کیفیت هوا» و «گرده» بدون تغییر ارائه شده است؛
       سمت چپ: محتوای سفارشی که داده‌های Google Maps را نسبت می‌دهد
سمت راست: داده‌های کیفیت هوا و گرده Google Maps که بدون تغییر ارائه شده‌اند با نشان‌واره Google Maps یا نوشتار اسنادی منسوب می‌شوند.
درست: امتیاز سفارشی که محتوای Google Maps و منابع دیگر را تجمیع می‌کند یا محتوای Google Maps Environmental API را تفسیر می‌کند، با «شامل داده‌های Google Maps» طبق دستورالعمل‌های ذکر منبع نوشتاری نسبت داده می‌شود.