خط‌مشی‌ها و ارجاع‌ها برای Geocoding API

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

خط‌مشی‌ها

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

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

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

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

می‌توانید فیلتر کردن سمت کارخواه را در فهرست نتایج سطح بالا انجام دهید (برای مثال، حذف نتایج نشانی که با معیارهای خاص کشور یا کد پستی مطابقت ندارند) و زیرفهرست‌های موجود در یک نتیجه را فیلتر یا بازآرایی کنید (برای مثال، اولویت‌بندی نقاط ناوبری خاص)، به‌شرطی که معیارهای فیلتر کردن یا بازآرایی برای کاربران نهایی گمراه‌کننده نباشد. باید مطمئن شوید که این تغییرات داده‌های اصلی برگردانده‌شده توسط API را به‌اشتباه نشان نمی‌دهد.

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

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

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

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

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

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

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

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

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

نمونه‌هایی از انواع قابل‌قبول برای ارجاع نشان‌واره 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 ارجاع مناسبی نیست.

خلاصه‌های هوشواره‌ای

وقتی خلاصه‌های تولیدشده با هوش مصنوعی را در برنامه‌تان نمایش می‌دهید، باید کارهای زیر را انجام دهید:

• ارجاع‌های لازم، پیوندهای گزارش‌دهی، و پیوندهای مرجع را به‌صورتی که در زیر تعریف شده است نمایش دهید.
• کاربران نهایی باید بتوانند متن کامل خلاصه را همان‌طور که توسط Google Maps Platform ارائه شده است بخوانند.

نمایش نوشتار شفاف‌سازی خلاصه‌های تولیدشده با هوش مصنوعی

هنگام نمایش خلاصه با بهره‌گیری از هوش مصنوعی، همیشه نوشتار شفاف‌سازی بومی‌سازی‌شده (ارائه‌شده در فیلد disclosure_text بدنه پاسخ) را بلافاصله زیر خلاصه قرار دهید. هرگز متن شفاف‌سازی ارائه‌شده توسط API را اصلاح یا تقویت نکنید.

شکل ۱: نوشتار شفاف‌سازی به‌درستی در زیر خلاصه‌های تولیدشده با هوش مصنوعی نمایش داده شده است.

الزامات خلاصه ورود

خلاصه‌های زمان رسیدن که در برنامه‌تان نمایش داده می‌شود باید با نوشتار زیر و پیوندهای الزامی همراه باشد:

نوشتار	الزام
درباره این خلاصه	از پیوند زیر برای «چگونگی یافتن منابع اطلاعات فهرستگان‌های محلی و استفاده از آن‌ها توسط Google» استفاده کنید: https://support.google.com/local-listings/answer/9851099.
گزارش تخلف خلاصه	از پیوند موجود در فیلد flag_content_url پاسخ استفاده کنید تا بتوانید مشکلی را درباره محتوای خلاصه به Google گزارش کنید. توجه: خلاصه‌های تولیدشده با هوش مصنوعی که ازطریق Geocoding API ارائه می‌شوند، در هر کجای دنیا که باشید، مشمول خط‌مشی‌های محتوا و محصول Google هستند. باید به کاربران نهایی خود اطلاع دهید که اگر می‌خواهند محتوایی را گزارش کنند که باید طبق قوانین ذی‌ربط از سرویس‌های Google برداشته شود، باید آن را بااستفاده از نشانی وب ارائه‌شده برای پرچم‌گذاری محتوا (flag_content_url) گزارش کنند.

شکل ۲: خلاصه تولیدشده با هوش مصنوعی که با پیوندهای مرتبط الزامی ازطریق منوِ سرریز دراختیار کاربران نهایی قرار داده شده است.

نمایش راهنمایی برای موارد استفاده خودرویی

برای ایمنی راننده، Google توصیه می‌کند خلاصه‌های هوش مصنوعی در حالت پارک‌شده برای تجربه‌های خودرویی ارائه شود. اگر خلاصه‌ها را در حالت رانندگی ارائه می‌دهید، اطلاعات روی صفحه باید واضح و مختصر باشد تا اطمینان حاصل شود که توجه راننده به‌سرعت به جاده برمی‌گردد:

• حداکثر ۳ خط
• ۱۲۰ نویسه یا ۲۴ کلمه یا کمتر
• حداقل اندازه جلو ۲۴dp

به‌ویژه در زمینه‌های خودرویی، مسئولیت ارائه خلاصه‌های تولیدشده با هوش مصنوعی به روش‌هایی که ایمن و مطابق با همه قوانین و مقررات محلی باشد، برعهده توسعه‌دهنده است.