این سند الزامات برنامههای توسعهیافته با Maps JavaScript API را فهرست میکند. توجه داشته باشید که استفاده از Maps JavaScript API تحت کنترل قرارداد شما با Google است.
خطمشیها
این بخش خطمشیهای مربوط به Maps JavaScript API را شرح میدهد. خطمشیها دستورالعملها و الزامات اجرایی کاربردی را ارائه میدهند تا به شما کمک کنند از «سرویس» بهدرستی و مطابق با انتظارات «پلاتفرم Google Maps» استفاده کنید.
استثنائات محدودیتهای ذخیره کردن در حافظه نهان
توجه داشته باشید که شناسه مکان، که برای شناسایی منحصربهفرد مکان استفاده میشود،
از محدودیتهای ذخیرهسازی موقت معاف است.
بنابراین میتوانید مقادیر شناسه مکان را برای مدت نامحدود ذخیره کنید.
شناسه جا در فیلد place_id در پاسخهای میانای برنامهسازی کاربردی برگردانده میشود. در راهنمای «شناسههای مکان» با نحوه ذخیره، بازآوری، و مدیریت شناسههای مکان آشنا شوید.
استخراج محتوا
ممکن است «نام مکان» براساس تعاملات کاربر با برنامهتان به شما برگردانده شود. اگر «نام مکان» را برای استفاده در هر زمینه دیگری خارج از جلسه کاربر ضبط یا حفظ کنید، این کار بهمنزله استخراج داده خواهد بود که طبق شرایط ما مجاز نیست.
کشورها و قلمروهای منطقه اقتصادی اروپا
این محصول برای مشتریانی که نشانی صورتحسابشان در منطقه اقتصادی اروپا (EEA) است، «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد آن نیز متفاوت باشد. قبلاز ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:
- شرایط خدمات Google Maps Platform در منطقه اقتصادی اروپا
- شرایط خاص سرویس Google Maps Platform در منطقه اقتصادی اروپا
- پرسشگان منطقه اقتصادی اروپا
- الزامات ایمنی جادهای پلاتفرم Google Maps
اگر نشانی صورتحساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال میشود:
الزامات ذکر منبع 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
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 ارجاع مناسبی نیست.
سایر الزامات ذکر منبع
این دستورالعملها را برای بازیابی ارجاعهای شخص ثالث و نمایش ارجاعها در برنامهتان دنبال کنید.
بازیابی ارجاعها از «مکان»
اگر برنامهتان اطلاعات مرور بهدستآمده از تماس با
Place.fetchFields را نمایش میدهد،
برنامه باید ارجاعهای شخص ثالث را نیز برای جزئیات مکان بهدستآمده نمایش دهد.
API شیء Place
را برمیگرداند. برای بازیابی ارجاعها از شیء Place، از ویژگی
Place.attributions
استفاده کنید که با هر درخواست برگردانده میشود (نیازی نیست آن را با فیلدها مشخص کنید). ویژگی
List از اشیاء String را برمیگرداند، یا اگر هیچ ارجاعی برای نمایش وجود نداشته باشد، null را برمیگرداند. کد نمونه زیر دریافت مکان و فهرست کردن هرگونه ارجاع را نشان میدهد.
// Use place ID to create a new Place instance. const place = new Place({ id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen }); // Call fetchFields, passing the desired data fields. await place.fetchFields({ fields: ["displayName", "formattedAddress", "location", "reviews"], }); // Check for any place attributions. if (!place.attributions) { console.log('No attributions were found.'); return; } else { // Log the place attribution for (var attribution of place.attributions) { console.log(attribution); } }
نمایش مرور
یک شیء Place میتواند حداکثر پنج مرور داشته باشد که هر مرور با یک شیء Review نشان داده میشود. میتوانید این مرورها را بهصورت اختیاری در برنامهتان نمایش دهید.
هنگام نمایش مرورهای همیاریشده توسط کاربران Google، باید نام نویسنده را در نزدیکی آن قرار دهید. وقتی در فیلد ارجاع به نویسنده شیء Review دردسترس باشد،
توصیه میکنیم عکس نویسنده و پیوند به نمایه او را نیز اضافه کنید. تصویر زیر
نمونهای از مرور یک پارک را نشان میدهد:
مثال زیر دریافت مکان، بررسی مرورها، و نمایش دادههای اولین مرور را نشان میدهد:
// Create a new Place instance. const place = new Place({ id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA }); // Call fetchFields, passing 'reviews' and other needed fields. await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location', 'reviews'], }); // Create an HTML container. const content = document.createElement('div'); const title = document.createElement('div'); const rating = document.createElement('div'); const address = document.createElement('div'); const review = document.createElement('div'); const authorLink = document.createElement('a'); // If there are any reviews display the first one. if (place.reviews && place.reviews.length > 0) { // Get info for the first review. const reviewRating = place.reviews[0].rating; const reviewText = place.reviews[0].text; const authorName = place.reviews[0].authorAttribution.displayName; const authorUri = place.reviews[0].authorAttribution.uri; // Safely populate the HTML. title.textContent = place.displayName || ''; address.textContent = place.formattedAddress || ''; rating.textContent = `Rating: ${reviewRating} stars`; review.textContent = reviewText || ''; authorLink.textContent = authorName; authorLink.href = authorUri || ''; authorLink.target = '_blank'; content.appendChild(title); content.appendChild(address); content.appendChild(rating); content.appendChild(review); content.appendChild(authorLink); } else { content.textContent = `No reviews were found for ${place.displayName}.`; } // Create an infoWindow to display the review. infoWindow = new InfoWindow({ content, ariaLabel: place.displayName, });
اسناد مربوط به مرورهای مکان را ببینید.
نمایش ارجاعها برای عکس
اگر برنامهتان عکس نمایش میدهد، باید برای هر عکسی که ارجاع به نویسنده دارد، آن ارجاع را نشان دهید.
جزئیات مربوط به عکس در شیء Place پاسخ در آرایه photos قرار دارد. برای افزودن آرایه photos به پاسخ، فیلد داده photos را در درخواست بگنجانید.
هر عنصر آرایه عکسها نمونهای از Photo است که حاوی آرایه authorAttributions از نوع AuthorAttribution است. فیلدهای شیء
AuthorAttribution رشتههایی هستند که حاوی displayName،
uri، و photoUri ارجاع هستند، یا اگر ارجاعی برای نمایش وجود نداشته باشد،
رشتهای خالی هستند.
اسناد مربوط به عکسهای مکان را ببینید.
اسناد نتایج جستجو
در اروپا، هنگام استفاده از رتبهبندی خالص Google، محصولات جستجو باید نوشتار توضیحی داشته باشند که بیشاز ۱ کلیک فاصله نداشته باشد و عوامل اصلی و وزن عوامل اصلی را که رتبهبندی نتایج جستجو را تعیین میکنند شرح دهد. نوشتار توضیحی:
سرصفحه: درباره این نتایج
متن اصلی: وقتی در اطراف جایی دنبال کسبوکار یا مکانی میگردید، Google Maps به شما نتایج محلی را نشان میدهد. عوامل زیادی - ارتباط درجه اول داشتن، فاصله، و برجسته بودن - ترکیب میشوند تا در یافتن بهترین نتایج برای شما کمک کنند.
دکمه ۱: بیشتر بدانید
نوشتار «بیشتر بدانید» باید به مقاله «مرکز راهنمایی» پیوند داده شود.
دکمه ۲: تأیید
تکمیل خودکار برای نشانیهای کاربر نهایی
وقتی کاربر نهایی از عملکرد «تکمیل خودکار» در «برنامه مشتری» شما برای تایپ کردن نشانی خیابان استفاده میکند و آن نشانی خیابان میتوانست بهطور کامل و دقیق توسط آن کاربر نهایی بدون «تکمیل خودکار» ارائه شود، نشانی انتخابشده کاربر نهایی مشمول محدودیتهای «محتوای Google Maps» در «قرارداد پلاتفرم Google Maps» شما نمیشود. این استثنا فقط برای نشانی خیابان انتخابشده توسط کاربر نهایی و صرفاً برای تراکنش خاص آن کاربر نهایی اعمال میشود؛ این استثنا برای فهرست نشانیهای پیشنهادی ارائهشده توسط عملکرد «تکمیل خودکار» یا سایر «محتوای Google Maps» اعمال نمیشود. این استثنا برای هیچکدام از عملکردهای جستجوی نشانی یا نقطه موردعلاقه که توسط دیگر سرویسهای «پلاتفرم Google Maps» ارائه میشود اعمال نمیشود.
در تصویر قبلی، فهرست نشانی در سمت راست همچنان مشمول محدودیتهای «محتوای Google Maps» است. وقتی کاربر نهایی نشانی انتخابیاش را انتخاب میکند، آن نشانی صرفاً برای تراکنش قابلاجرای آن کاربر نهایی مشمول محدودیتهای «محتوای 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
بهویژه در زمینههای خودرویی، مسئولیت ارائه خلاصههای هوشوارهای بهشیوهای ایمن و مطابق با همه قوانین و مقررات محلی برعهده توسعهدهنده است.