API سیاست‌های Places

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

این سند الزاماتی را فهرست می‌کند که مختص همه برنامه‌های توسعه‌یافته با Places API (جدید) است، از جمله سرویس تکمیل خودکار (جدید) که بخشی از آن API است. اطلاعات عمومی بیشتر برای توسعه دهندگان نقشه های Google را می توان در شرایط خدمات پلت فرم Google Maps یافت.

شرایط استفاده و سیاست حفظ حریم خصوصی را ارائه دهید

اگر یک برنامه Places API ایجاد می کنید، باید شرایط استفاده و یک خط مشی رازداری را با برنامه خود در دسترس قرار دهید که با دستورالعمل های ذکر شده در توافقنامه شما با Google مطابقت دارد:

• شرایط استفاده و سیاست حفظ حریم خصوصی باید در دسترس عموم باشد.
• شما باید به صراحت در شرایط استفاده برنامه خود بیان کنید که با استفاده از برنامه شما، کاربران به شرایط خدمات Google ملزم هستند.
• شما باید در خط‌مشی رازداری خود به کاربران اطلاع دهید که از API(های) Google Maps استفاده می‌کنید و با ارجاع به خط‌مشی رازداری Google ادغام کنید.

مکان پیشنهادی برای در دسترس قرار دادن شرایط استفاده و سیاست حفظ حریم خصوصی به پلت فرم برنامه شما بستگی دارد.

اپلیکیشن های موبایل

در صورت توسعه یک برنامه تلفن همراه، توصیه می شود پیوندی به شرایط استفاده و خط مشی رازداری در صفحه دانلود برنامه خود در فروشگاه برنامه مربوطه و در منوی تنظیمات برنامه ارائه دهید.

برنامه های کاربردی وب

در صورت توسعه یک برنامه وب، توصیه می شود که پیوندی به شرایط استفاده و سیاست حفظ حریم خصوصی در پاورقی وب سایت خود ارائه دهید.

پیش واکشی، ذخیره سازی یا ذخیره سازی محتوا

برنامه‌هایی که از Places API استفاده می‌کنند، تابع شرایط توافقنامه شما با Google هستند. با توجه به شرایط توافق نامه خود، نباید هیچ محتوایی را از قبل واکشی، فهرست بندی، ذخیره یا ذخیره کنید، مگر تحت شرایط محدودی که در شرایط ذکر شده است.

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

نمایش نتایج API Places

می توانید نتایج Places API را روی نقشه گوگل یا بدون نقشه نمایش دهید. اگر می‌خواهید نتایج Places API را روی نقشه نشان دهید، این نتایج باید در نقشه گوگل نمایش داده شوند. استفاده از داده های Places API بر روی نقشه ای که نقشه گوگل نیست ممنوع است.

نشان‌واره و اسناد Google را نمایش دهید

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

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

لوگوی گوگل باید در گوشه سمت چپ پایین نقشه قرار گیرد و اطلاعات انتساب در گوشه سمت راست پایین قرار گیرد، که هر دو باید روی نقشه به طور کلی ارائه شوند و نه زیر نقشه یا مکان دیگری در برنامه. مثال نقشه زیر نشان‌واره گوگل را در سمت چپ پایین نقشه و انتساب را در سمت راست پایین نشان می‌دهد.

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

فایل فشرده زیر حاوی لوگوی گوگل در اندازه های صحیح برای برنامه های دسکتاپ، اندروید و iOS است. شما نمی توانید این لوگوها را به هیچ وجه تغییر اندازه یا تغییر دهید.

دانلود: google_logo.zip

انتساب را تغییر ندهید اطلاعات انتساب را حذف، مبهم یا برش ندهید. نمی‌توانید از نشان‌واره‌های Google به صورت درون خطی استفاده کنید (به عنوان مثال، «این نقشه‌ها از [Google_logo] هستند»).

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

شامل ارائه دهندگان داده شخص ثالث. برخی از داده ها و تصاویر موجود در محصولات نقشه برداری ما از ارائه دهندگانی غیر از Google می آیند. اگر از چنین تصاویری استفاده می‌کنید، متن انتساب شما باید نام «Google» و ارائه‌دهنده(های) داده مربوطه، مانند «داده‌های نقشه: Google، Maxar Technologies» را ذکر کند. هنگامی که ارائه‌دهندگان داده شخص ثالثی وجود دارند که با تصاویر ذکر شده است، فقط شامل «Google» یا نشان‌واره Google به درستی ارجاع داده نمی‌شود.

اگر از Google Maps Platform در دستگاهی استفاده می‌کنید که نمایش اسناد در آن کاربردی نیست، لطفاً با تیم فروش Google تماس بگیرید تا در مورد مجوزهای مربوط به مورد استفاده خود صحبت کنید.

سایر الزامات انتساب

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

بازیابی اسناد از یک مکان

اگر برنامه شما اطلاعاتی را که با تماس با جزئیات مکان به دست آمده را با شناسه مکان نمایش می دهد، برنامه باید اسناد شخص ثالث را نیز برای جزئیات مکان به دست آمده نمایش دهد.

Attribution ها در شی Place یک پاسخ با یک شی Attribution نشان داده می شوند. برای افزودن Attribution به پاسخ، places.attributions (جستجوی نزدیک و جستجوی متن) یا attributions (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

فیلدهای آبجکت Attribution رشته‌هایی هستند که شامل provider و providerUri Uri انتساب هستند، یا در صورتی که هیچ خصیصه‌ای برای نمایش وجود نداشته باشد، یک رشته خالی است.

نمایش مشخصات یک عکس

اگر برنامه شما عکس‌هایی را نمایش می‌دهد، باید برای هر عکسی که دارای آن‌ها است، اسناد نویسنده را نشان دهید.

جزئیات مربوط به عکس در یک شی Place پاسخ در آرایه photos موجود است. برای افزودن آرایه photos به پاسخ، places.photos (جستجوی نزدیک و جستجوی متن) یا photos (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

هر عنصر از آرایه photos نمونه ای از Photo است که حاوی آرایه authorAttributions از نوع AuthorAttribution است.

فیلدهای شیء AuthorAttribution رشته‌هایی هستند که حاوی displayName ، uri و photoUri انتساب هستند، یا اگر هیچ انتسابی برای نمایش وجود نداشته باشد، یک رشته خالی است.

نمایش یک بررسی

یک شی Place در یک پاسخ می تواند تا پنج نظر داشته باشد. می توانید به صورت اختیاری این نظرات را در برنامه خود نمایش دهید.

هنگام نمایش نظرات ارائه شده توسط کاربران Google، باید نام نویسنده را در نزدیکی قرار دهید. وقتی در فیلد انتساب نویسنده شی Review موجود است، توصیه می کنیم عکس نویسنده و پیوند به نمایه او را نیز اضافه کنید. تصویر زیر نمونه ای از بررسی یک پارک را نشان می دهد:

گوگل همچنین توصیه می کند که نحوه مرتب سازی نظرات را به کاربر نهایی نشان دهید.

هر بررسی در یک شی Place از یک پاسخ توسط یک شی Review نشان داده می شود. برای افزودن شی Review به پاسخ، places.reviews (جستجوی نزدیک و جستجوی متن) یا reviews (جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.

فیلدهای شیء Review حاوی انتساب هستند، یا اگر هیچ انتسابی برای نمایش وجود نداشته باشد خالی هستند.

اسناد نتایج جستجو

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

سربرگ: درباره این نتایج

بدنه: وقتی مشاغل یا مکان‌های نزدیک به یک مکان را جستجو می‌کنید، Google Maps نتایج محلی را به شما نشان می‌دهد. چندین عامل - در درجه اول ارتباط، فاصله و برجستگی - برای کمک به یافتن بهترین نتایج برای جستجوی شما ترکیب شده اند.

دکمه 1: بیشتر بدانید
متن "بیشتر بیاموزید" باید به مقاله مرکز راهنمایی پیوند داده شود.

دکمه 2: خوب

خلاصه های مبتنی بر هوش مصنوعی

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

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

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

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

الزامات اضافی خلاصه مکان و منطقه

خلاصه مکان و منطقه نمایش داده شده در برنامه شما باید با متن زیر و پیوندهای ضروری همراه باشد:

بررسی خلاصه الزامات

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

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

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

• بیش از 3 خط نیست
• 120 کاراکتر یا 24 کلمه یا کمتر
• حداقل اندازه جلو 24dp

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

دستورالعمل‌های سبک برای ارجاع Google

اگر نمی‌توانید از نشان‌واره دانلودی Google استفاده کنید، دستورالعمل‌های سبک برای اسناد Google در CSS و HTML در زیر آمده است.

فضای خالی

مقدار فضای خالی اطراف قفل باید برابر یا بیشتر از ارتفاع "G" در گوگل باشد.

فاصله بین کپی منبع و نشان‌واره Google باید نصف عرض "G" باشد.

خوانایی

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

رنگ

از متن Google Material Grey 700 در پس‌زمینه سفید یا روشن استفاده کنید که از محدوده 0% تا 40% حداکثر رنگ سیاه استفاده می‌کند.

#5f6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

در پس‌زمینه‌های تیره‌تر، و بیش از عکاسی یا الگوهای غیرمشغله، از متن سفید برای خط‌های کناری و اسناد استفاده کنید.

#ffffff
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

فونت

از فونت Roboto استفاده کنید.

مثال CSS

CSS زیر، وقتی روی متن "Google" اعمال شود، "Google" را با فونت، رنگ و فاصله مناسب روی پس‌زمینه سفید یا روشن نشان می‌دهد.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5f6368;