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

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

خط‌مشی‌ها

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

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

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

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

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

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

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

• شرایط خدمات پلاتفرم Google Maps
• شرایط خاص سرویس Google Maps Platform

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

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

اِسنادهای طرف سوم

برای ژاپن و کره جنوبی، داده‌های آب‌وهوا توسط Weathernews Inc.، اپراتور خدمات هواشناسی دارای مجوز رسمی، ارائه می‌شود. اگر از داده‌های آب‌وهوا برای ژاپن یا کره جنوبی استفاده می‌کنید، باید از ارجاع‌های زیر استفاده کنید:

ژاپن (مطابق با JMA): 気象データ提供：株式会社ウェザーニューズ

کره (مطابق با KMA): 날씨 정보 제공: 웨더뉴스

نمایش ارجاع Google Maps

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

ارجاع 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). کنتراست دسترس‌پذیر (۴.۵:۱) را درمقابل پس‌زمینه حفظ کنید.
  اندازه قلم	حداقل اندازه قلم: ۱۲ اس‌پی حداکثر اندازه قلم: ۱۶ اس‌پی برای آشنایی با اس‌پی، به واحدهای اندازه قلم در وب‌سایت Material Design مراجعه کنید.
  فاصله حروف	معمولی

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

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

اگر از داده‌ها یا تصاویر نمایشی Weather API استفاده می‌کنید، باید ذکر منبع زیر را روی داده‌ها یا تصاویر استفاده‌شده یا درکنار آن‌ها، یا همراه با ذکر منبع برای طرف‌های سوم دیگر، اضافه کنید: «منبع: شامل داده‌های آب‌وهوا از Google.» اگر کاشی‌ها در Google Map نشان داده می‌شوند و ارجاع ازقبل نمایان است، لازم نیست ارجاع دیگری اضافه کنید.

درنظر داشته باشید که در کلیدی که روی نقشه قرار می‌گیرد و مقدار هر رنگ را توضیح می‌دهد، ذکر منبع Google Maps (با رعایت همه الزامات ذکر منبع نمانام) را بگنجانید.

ارجاع هنگام ایجاد محتوای جدید بااستفاده از داده‌های Environment APIs

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

اگر داده‌های Air Quality API،‏ Pollen API،‏ Solar API، یا Weather API را همان‌طور که هست و بدون هیچ‌گونه تغییری نمایش می‌دهید، از نشان‌واره Google Maps یا ارجاع نوشتاری استفاده کنید.