خط‌مشی‌ها و ارجاع‌های Time Zone API

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

خط‌مشی‌ها

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

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

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

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

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

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

الزامات ارجاع Google Maps

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

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

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

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

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