این سند الزامات خاص همه برنامههای توسعهیافته با Places API (جدید)، ازجمله سرویس «تکمیل خودکار» (جدید) را که بخشی از آن API است، فهرست میکند. اطلاعات عمومی بیشتر برای توسعهدهندگان Google Maps را میتوانید در شرایط خدمات Google Maps Platform پیدا کنید.
خطمشیها
این بخش خطمشیهای مربوط به Places API را شرح میدهد. خطمشیها دستورالعملها و الزامات پیادهسازی عملی را ارائه میدهند تا به شما کمک کنند از «سرویس» بهدرستی و مطابق با انتظارات «پلاتفرم Google Maps» استفاده کنید.
ذخیرهسازی، ذخیره موقت، و استخراج دادهها
هنگام استفاده از «محتوای Google Maps» در برنامهتان، الزامات مدیریت داده را در بخش ۳.۲.۳ از شرایط خدمات پلاتفرم Google Maps و شرایط خاص سرویس پلاتفرم Google Maps دنبال کنید:
- محدودیتهای ذخیرهسازی در حافظه نهان و استخراج داده (بخش ۳.۲.۳ (الف) و (ب)): «محتوای Google Maps» را فقط بهصورت صریح و طبق آنچه در شرایط خاص سرویس Google Maps Platform مجاز شده است در حافظه نهان ذخیره یا نگهداری کنید. «محتوای Google Maps» را برای استفاده در خارج از «سرویسها» صادر، استخراج، یا جمعآوری نکنید. برای مثال، «محتوای Google Maps» را خارج از «سرویسها» پیشواکشی، نمایهگذاری، ذخیره، یا بازتوزیع نکنید؛ کاشیهای نقشه، تصاویر «نمای خیابان»، زمینکدها، مسیرها، نتایج ماتریس فاصله، اطلاعات جادهها، اطلاعات مکانها، مقادیر ارتفاع، یا جزئیات منطقه زمانی را بهصورت انبوه بارگیری نکنید؛ یا نامها، نشانیها، یا مرورهای کاربران کسبوکارها را کپی و ذخیره نکنید.
- محدودیتهای محتوای مشتقشده (بخش ۳.۲.۳(ج)): از «محتوای Google Maps» در برنامهتان طبق آنچه در شرایط خدمات Google Maps Platform مجاز شده است استفاده کنید. براساس «محتوای Google Maps» محتوا ایجاد نکنید. برای مثال، ویژگیها را از تصاویر ماهوارهای ردیابی یا دیجیتالی نکنید، مدلهای سهبعدی یا زمینی نسازید، از مقادیر طول و عرض جغرافیایی «مکانها» بهعنوان ورودی برای تحلیل نقطه در چندضلعی استفاده نکنید، از تصاویر «نمای خیابان» نمایه مکان نسازید، یا زمانهای رانندگی مبتنی بر نوشتار را به گفتار ترکیبی تبدیل نکنید.
برای کاهش تأخیر و هزینههای صورتحساب بدون ذخیره کردن دادههای محدودشده در حافظه نهان، از ماسکهای فیلد یا فهرستهای فیلد استفاده کنید تا فقط فیلدهایی را درخواست کنید که میانای کاربر شما نیاز دارد. شناسههای معاف مانند شناسه مکان را ذخیره کنید تا جزئیات جدید را هنگام تعامل کاربر با مکان واکشی کنید.
مهندسان پشتیبانی فنی Google نمیتوانند مشاوره حقوقی ارائه دهند یا برای «شرایط خدمات Google Maps Platform» استثنا قائل شوند. با مشاور حقوقیتان مشورت کنید تا ببینید آیا پیادهسازی شما با شرایط مطابقت دارد یا نه، یا اگر مورد استفاده شما به صدور پروانه سفارشی نیاز دارد، با بخش فروش تماس بگیرید.
استثنائات محدودیتهای ذخیره کردن در حافظه نهان
شرایط خاص سرویس پلاتفرم Google Maps استثناهای محدود زیر را برای ذخیرهسازی در حافظه نهان اعطا میکند:
- شناسههای مکان: شناسه مکان که برای
شناسایی منحصربهفرد مکان استفاده میشود، از
محدودیتهای ذخیرهسازی موقت مستثنی است.
بنابراین میتوانید مقادیر شناسه مکان را برای مدت نامحدود ذخیره کنید. شناسههای جا
در فیلد
idیاplace_idدر پاسخهای میانای برنامهسازی کاربردی برگردانده میشوند. در راهنمای «شناسههای مکان»، با نحوه ذخیره، بازآوری، و مدیریت شناسههای مکان آشنا شوید. - مختصات عرض و طول جغرافیایی: هنگام استفاده از سرویسهایی که این استثنا را در شرایط خاص سرویس Google Maps Platform اعطا میکنند، میتوانید مقادیر عرض جغرافیایی (
latitude) و طول جغرافیایی (longitude) را بهطور موقت تا ۳۰ روز تقویمی متوالی در حافظه نهان ذخیره کنید و پساز آن باید مختصات ذخیرهشده در حافظه نهان را حذف کنید:- Routes API، Route Optimization API، Directions API (قدیمی)، و Roads API
- Geocoding API، Geolocation API، و Address Validation API
- Places API، کیت میانای کاربر «جاها»، و کیت توسعه نرمافزار ناوبری
- دورههای ذخیرهسازی موقت مختص سرویس: شرایط مختص سرویس پلاتفرم Google Maps همچنین دورههای ذخیرهسازی موقت مختص فیلد و اهداف مجاز را برای Address Validation API، Air Quality API، Pollen API، Solar API، Weather API، و Places Aggregate API تعریف میکند.
کشورها و قلمروهای منطقه اقتصادی اروپا
این محصول برای مشتریانی که نشانی صورتحسابشان در منطقه اقتصادی اروپا (EEA) است، «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد آن نیز متفاوت باشد. پیشاز ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:
- شرایط خدمات Google Maps Platform در منطقه اقتصادی اروپا
- شرایط خاص سرویس Google Maps Platform در منطقه اقتصادی اروپا
- پرسشگان منطقه اقتصادی اروپا
- الزامات ایمنی جادهای Google Maps Platform
اگر نشانی صورتحساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال میشود:
الزامات ارجاع Google Maps
این بخش الزامات و دستورالعملهای ذکر منبع را برای نمایش 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 دنبال کنید:- حداقل ارتفاع نشانواره: ۱۶ پیکسل مستقل از تراکم
- حداکثر ارتفاع نشانواره: ۱۹ پیکسل مستقل از تراکم
- حداقل فضای خالی نشانواره: ۱۰ پیکسل مستقل از تراکم در چپ، راست، و بالا، ۵ پیکسل مستقل از تراکم در پایین
برای آشنایی با dp، به تراکم پیکسل در وبسایت Material Design مراجعه کنید.
دسترسپذیری نشانواره
این الزامات دسترسپذیری را برای نشانواره 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 دارایی سبک خانواده قلم 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 دریافت میشود. برای برخیاز محصولات، مانند Map Tiles API، ممکن است ارجاع لازم به ارائهدهنده داده طرف سوم را دراختیارتان قرار دهیم. وقتی این کار را انجام میدهیم، نوشتار ارجاع شما باید نام «Google Maps» و ارائهدهنده(های) داده مربوطه را ذکر کند، مانند «دادههای نقشه: Google، Maxar Technologies». وقتی Google ارجاع به طرف سوم ارائه میدهد، فقط گنجاندن «Google Maps» یا نشانواره Google ارجاع مناسبی نیست.
الزامات اضافی Places API
الزامات زیر مختص Places API است.
تکمیل خودکار برای نشانیهای کاربر نهایی
وقتی کاربر نهایی از عملکرد «تکمیل خودکار» در «برنامه مشتری» شما برای تایپ کردن نشانی خیابان استفاده میکند و آن نشانی خیابان میتوانست بهطور کامل و دقیق توسط آن کاربر نهایی بدون «تکمیل خودکار» ارائه شود، نشانی انتخابشده کاربر نهایی مشمول محدودیتهای «محتوای Google Maps» در «قرارداد پلاتفرم Google Maps» شما نمیشود. این استثنا فقط برای نشانی خیابان انتخابشده توسط کاربر نهایی و صرفاً برای تراکنش خاص آن کاربر نهایی اعمال میشود؛ این استثنا برای فهرست نشانیهای پیشنهادی ارائهشده توسط عملکرد «تکمیل خودکار» یا برای «محتوای Google Maps» دیگر اعمال نمیشود. این استثنا برای هیچکدام از عملکردهای جستجوی نشانی یا نقطه موردعلاقه که توسط دیگر سرویسهای «پلاتفرم Google Maps» ارائه میشود اعمال نمیشود.
فهرست نشانیهای سمت راست همچنان مشمول محدودیتهای «محتوای Google Maps» است. وقتی کاربر نهایی نشانی انتخابیاش را انتخاب میکند، آن نشانی صرفاً برای تراکنش مربوطه آن کاربر نهایی مشمول محدودیتهای «محتوای Google Maps» نمیشود.
عکسها و مرورها
همه محتوا را به نویسنده محتوا نسبت دهید
هنگام نمایش عکسها یا مرورها، همیشه باید نام نویسنده را ذکر کنید. هر عکس و مرور شامل ارجاع به نویسنده (تصویر چهرهنما، نام، و پیوند نمایه نویسنده) است.
الزامات دیداری برای ذکر منبع:
- درصورت وجود فضای کافی، نویسنده را بااستفاده از همه منابع دردسترس (چهرهنما، نام، و پیوند نمایه) ذکر کنید.
- برای مرورها، اگر فضا محدود باشد، حداقل شرط لازم نمایش چهرک نویسنده است.
- برای عکسها، اگر فضا محدود باشد (مثلاً در گالری یا برای ریزعکسها)، میتوان از ذکر نام نویسنده صرفنظر کرد، مشروط بر اینکه کاربر بتواند به نسخه بزرگتری از تصویر که شامل ذکر نام کامل نویسنده است دسترسی داشته باشد.
- انتساب نویسنده را طوری قرار دهید که بهوضوح با عکس یا مرور نویسنده مرتبط باشد.
دسترسی مستقیم به محتوای منبع در Google Maps را فراهم میکند
برای هر عکس و مرور، کاربران نهایی باید همیشه بااستفاده از googleMapsUri ارائهشده به عکس یا مرور منبع اصلی در Google Maps دسترسی داشته باشند.
نمایش تاریخ انتشار نسبی (توصیهشده) *
نمایش تاریخ انتشار نسبی (برای مثال، «۲ روز پیش») برای عکسها و مرورها بااستفاده از
relativePublishTimeDescription ارائهشده، اعتماد کاربر به محتوا را افزایش میدهد.
فعال کردن گزارش تخلف محتوا (توصیهشده) *
عکسها و مرورهای ارائهشده ازطریق Places API (جدید) و Places API (قدیمی) در هر کجای دنیا که باشید مشمول خطمشیهای محتوا و محصول Google هستند. شما و کاربران نهاییتان میتوانید محتوایی را که میخواهید طبق خطمشیهای Google یا قوانین ذیربط از سرویسهای Google برداشته شود بااستفاده از flagContentUri برای هر عکس و مرور گزارش کنید. همچنین، محتوا را میتوان با دنبال کردن پیوند مستقیم به محتوا در Google Maps گزارش کرد، که در آنجا گزارش مشکل نیز دردسترس است.
مرورها
توضیح دهید مرورها چگونه مرتب و فیلتر میشوند
اعلان واضحی اضافه کنید که نحوه مرتبسازی و فیلتر کردن مرورها را شرح دهد، ازجمله هرگونه معیار جستجوی اعمالشده. بهطور پیشفرض، مرورها براساس مربوط بودن مرتب شدهاند.
نمایش ماه و سالی که مرورکنندگان از مکانها در فرانسه بازدید کردهاند
Places API هنگام نمایش مرورهای مکانها در فرانسه و قلمروهای فرانسه،
visitDate (ماه و سالی که نویسنده از مکان بازدید کرده است) را برمیگرداند که باید
درکنار محتوا نمایش داده شود.
اطلاعرسانی به کاربران نهایی وقتی مرورها ترجمه شدهاند (توصیهشده) *
وقتی مروری از زبان اصلیاش ترجمه شده است، کاربران نهایی را مطلع کنید. میتوانید به کاربران نهایی اجازه دهید نوشتار اصلی ترجمهنشده را مشاهده کنند originalText. یا میتوانند پیوند مستقیم به محتوا را در Google Maps دنبال کنند که در آنجا نوشتار اصلی ترجمهنشده دردسترس است.
مرورها و میانگین ردهبندی
اطلاعرسانی به کاربران نهایی درباره نحوه درستیسنجی مرورها توسط Google (توصیهشده) *
Google مرورها را درستیسنجی نمیکند، اما وجود محتوای جعلی را بررسی میکند و درصورت شناسایی، آن را برمیدارد. هنگام نمایش مرورها و ردهبندی میانگین، کاربران نهایی را از خطمشی مرور Google مطلع کنید. درباره خطمشی محتوای تولیدشده توسط کاربر Google Maps بیشتر بدانید.
خلاصههای هوشوارهای
وقتی خلاصههای تولیدشده با هوش مصنوعی را در برنامهتان نمایش میدهید — ازجمله خلاصههای مکان، منطقه، و مرور — باید کارهای زیر را انجام دهید:
- ارجاعهای لازم، پیوندهای گزارشدهی، و پیوندهای مرجع را بهصورتی که در زیر تعریف شده است نمایش دهید.
- کاربران نهایی باید بتوانند متن کامل خلاصه را همانطور که Google Maps ارائه کرده است بخوانند.
نمایش نوشتار شفافسازی خلاصههای تولیدشده با هوش مصنوعی
هنگام نمایش خلاصه تولیدشده با هوش مصنوعی از هر نوعی، همیشه نوشتار شفافسازی بومیسازیشده (ارائهشده در فیلد disclosureText بدنه پاسخ) را بلافاصله زیر خلاصه قرار دهید. هرگز متن شفافسازی ارائهشده توسط میانای برنامهسازی کاربردی را اصلاح یا تقویت نکنید.
الزامات اضافی خلاصه مکان و منطقه
خلاصههای مکان و منطقه که در برنامهتان نمایش داده میشود باید با نوشتار زیر و پیوندهای الزامی همراه باشد:
| نوشتار | الزام |
|---|---|
| درباره این خلاصه | از پیوند زیر برای «چگونگی یافتن منابع اطلاعات فهرستگانهای محلی و استفاده از آنها توسط Google» استفاده کنید: https://support.google.com/local-listings/answer/9851099. |
| گزارش تخلف خلاصه |
از پیوند موجود در فیلد توجه: خلاصههای تولیدشده با هوش مصنوعی که ازطریق Places API (جدید) ارائه میشوند، در هر کجای دنیا که باشید، مشمول خطمشیهای محتوا و محصول Google هستند. باید به کاربران نهاییتان اطلاع دهید که اگر میخواهند محتوایی را گزارش کنند که طبق قوانین ذیربط باید از سرویسهای Google برداشته شود، باید آن را بااستفاده از نشانی وب ارائهشده برای پرچمگذاری محتوا ( |
الزامات خلاصه مرورها
خلاصه مرورهای نمایشدادهشده در برنامهتان باید با عنوان «خلاصه مرورها» همراه باشد. علاوهبراین، باید از نوشتار و پیوندهای الزامی زیر استفاده کنید:
| نوشتار | الزام |
|---|---|
| درباره این خلاصه | از پیوند زیر برای «چگونگی یافتن منابع اطلاعات فهرستگانهای محلی و استفاده از آنها توسط Google» استفاده کنید: https://support.google.com/local-listings/answer/9851099 |
| گزارش تخلف خلاصه |
از پیوند موجود در فیلد توجه: خلاصههای تولیدشده با هوش مصنوعی که ازطریق Places API (جدید) ارائه میشوند، در هر کجای دنیا که باشید، مشمول خطمشیهای محتوا و محصول Google هستند. باید به کاربران نهاییتان اطلاع دهید که اگر میخواهند محتوایی را گزارش کنند که طبق قوانین ذیربط باید از سرویسهای Google برداشته شود، باید آن را بااستفاده از نشانی وب ارائهشده برای پرچمگذاری محتوا ( |
| دیدن مرورها | از پیوند موجود در فیلد reviewSummary.reviewsUri پاسخ استفاده کنید. |
نمایش راهنمایی برای موارد استفاده خودرویی
برای ایمنی راننده، Google توصیه میکند خلاصههای مبتنی بر هوش مصنوعی در حالت پارکشده برای تجربههای خودرویی ارائه شود. اگر خلاصهها را در حالت رانندگی ارائه میدهید، اطلاعات روی صفحه باید واضح و مختصر باشد تا اطمینان حاصل شود که توجه راننده بهسرعت به جاده برمیگردد:
- حداکثر ۳ خط
- ۱۲۰ نویسه یا ۲۴ کلمه یا کمتر
- حداقل اندازه جلو ۲۴dp
بهویژه در زمینههای خودرویی، مسئولیت ارائه خلاصههای با بهرهگیری از هوش مصنوعی به روشهایی که ایمن و مطابق با همه قوانین و مقررات محلی باشد، برعهده توسعهدهنده است.
نتایج جستجوی مکان
عواملی را که بر رتبهبندی نتایج جستجو تأثیر میگذارند شرح دهید (توصیهشده) *
در یک تعامل کاربر، کاربران نهایی باید از عوامل اصلی و وزن عوامل اصلی که رتبهبندی نتایج جستجو را تعیین میکنند مطلع شوند.
هنگام استفاده از رتبهبندی اصلاحنشده Google، میتوانید متن توضیحی زیر را نمایش دهید:
«وقتی در اطراف جایی دنبال کسبوکار یا مکانی میگردید، Google Maps نتایج محلی را نشان میدهد. چندین عامل — در درجه اول مربوط بودن، فاصله، و برجستگی — باهم ترکیب میشوند تا در یافتن بهترین نتایج برای شما کمک کنند. بیشتر بدانید.»
رعایت قوانین ذیربط
شما ملزم هستید که همواره از همه قوانین ذیربط پیروی کنید. توجه داشته باشید که شیوههایی که در این خطمشیها با برچسب (توصیهشده) مشخص شدهاند ممکن است همچنان طبق قانون اجباری باشند. علاوهبراین، پیروی از همه الزامات بیانشده و رویههای توصیهشده رعایت کامل استانداردهای قانونی را در همه حوزههای قضایی تضمین نمیکند. اگر درباره وضعیت رعایت مقررات خود سؤالی دارید، باید از مشاور حقوقیتان راهنمایی بگیرید.