خط‌مشی‌ها و ارجاع‌ها برای کیت توسعه نرم‌افزار پیمایش برای iOS

این سند الزامات برنامه‌های توسعه‌یافته با کیت توسعه نرم‌افزار ناوبری برای iOS را فهرست می‌کند.

استفاده قابل‌قبول از پیاده‌سازی مشتری

«کیت توسعه نرم‌افزار پیمایش برای iOS» برای ارائه پیمایش گام‌به‌گام هم‌زمان به رانندگان در برنامه تلفن همراه طراحی شده است. داده‌های تولیدشده توسط میانای برنامه‌سازی کاربردی ممکن است در برنامه‌های دیگر نیز برای هم‌رسانی اطلاعات مربوط به وضعیت راننده و ردیابی کلی مکان‌های راننده استفاده شود.

پیاده‌سازی مشتری غیرمجاز

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

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

استخراج محتوا

«نام جاده» و «محدودیت سرعت» ممکن است براساس تعاملات کاربر با برنامه‌تان به شما برگردانده شود. اگر بخواهید «نام جاده» یا «محدودیت سرعت» را برای استفاده در هر زمینه دیگری خارج از جلسه کاربر ضبط یا حفظ کنید، این کار به‌منزله استخراج داده خواهد بود که طبق شرایط ما مجاز نیست.

اصلاحات قابل‌قبول در «میانای کاربر ناوبری»

«کیت توسعه نرم‌افزار پیمایش برای iOS» سفارشی‌سازی‌های خاصی در میانای کاربر امکان‌پذیر می‌کند، مثلاً سفارشی‌سازی نقشه پیمایش، افزودن نشانگرهای سفارشی، تغییر اندازه و محتوای سرایند و پانویس اطراف نمای دید پیمایش، یا تغییر اندازه نمای دید پیمایش خود. در برخی شرایط، ممکن است بخواهید محتوا را روی صفحه پیمایش فعال قرار دهید.

هنگام انجام این کار، نباید تغییراتی ایجاد کنید که استفاده ایمن توسط رانندگان را مهار کند. برای مثال، تغییرات زیر می‌تواند بر ایمنی راننده تأثیر منفی بگذارد و باید از آن‌ها اجتناب شود:

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

سایر الزامات پیاده‌سازی

• بدون رضایت کتبی قبلی از Google، نمی‌توانید شرایط درون‌محصولی Navigation SDK را تغییر دهید.
• برنامه شما باید اطلاعات زیر را هنگام اولین استفاده کاربر نهایی از برنامه به او نمایش دهد:
  • شرایط خدمات «کیت توسعه نرم‌افزار پیمایش».
  • کاربران نهایی باید هنگام استفاده از ناوبری همیشه قضاوت مستقل داشته باشند، زیرا اطلاعات «سرویس کیت توسعه نرم‌افزار ناوبری» ممکن است با شرایط واقعی در زمان واقعی متفاوت باشد.
  • کاربران نهایی مسئولیت کامل هزینه‌هایی را که هنگام دنبال کردن مسیرهای ارائه‌شده توسط سرویس «کیت توسعه نرم‌افزار ناوبری» متحمل می‌شوند، مانند هزینه عوارض یا خطوط ویژه خودروهای پرسرنشین، برعهده دارند.

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

این بخش الزامات و دستورالعمل‌های ذکر منبع را برای نمایش 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، این دستورالعمل‌ها را دنبال کنید.

• به هیچ وجه نشان‌واره را تغییر ندهید.
• نسبت ابعادی نشان‌واره را حفظ کنید تا از اعوجاج جلوگیری شود.
• از نشان‌واره با خط پیرامونی روی پس‌زمینه شلوغ، مثل نقشه یا تصویر، استفاده کنید.
• از نشان‌واره بدون حاشیه روی پس‌زمینه ساده، مثل رنگ یکدست یا گرادیان ملایم، استفاده کنید.

مشخصات اندازه نشان‌واره

• حداقل ارتفاع نشان‌واره: ۱۶ پیکسل مستقل از تراکم
• حداکثر ارتفاع نشان‌واره: ۱۹ پیکسل مستقل از تراکم
• حداقل فضای خالی نشان‌واره: ۱۰ پیکسل در سمت راست، چپ، و بالا، ۵ پیکسل در پایین

برای آشنایی با 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»، آن را به‌اشتباه معرفی نکنید.
• تأیید کنید که ارجاع همیشه قابل‌مشاهده و خوانا باشد. هرگز آن را حذف، پنهان، مبهم، یا اصلاح نکنید.