این سند الزاماتی را فهرست میکند که مختص همه برنامههای توسعهیافته با Places API است، از جمله سرویس تکمیل خودکار مکان که بخشی از آن API است. اطلاعات عمومی بیشتر برای توسعه دهندگان نقشه های Google را می توان در شرایط خدمات پلت فرم Google Maps یافت.
اگر یک برنامه Places API ایجاد می کنید، باید شرایط استفاده و یک خط مشی رازداری را با برنامه خود در دسترس قرار دهید که با دستورالعمل های ذکر شده در توافقنامه شما با Google مطابقت دارد: مکان پیشنهادی برای در دسترس قرار دادن شرایط استفاده و سیاست حفظ حریم خصوصی به پلت فرم برنامه شما بستگی دارد. در صورت توسعه یک برنامه تلفن همراه، توصیه می شود پیوندی به شرایط استفاده و خط مشی رازداری در صفحه دانلود برنامه خود در فروشگاه برنامه مربوطه و در منوی تنظیمات برنامه ارائه دهید. در صورت توسعه یک برنامه وب، توصیه می شود که پیوندی به شرایط استفاده و سیاست حفظ حریم خصوصی در پاورقی وب سایت خود ارائه دهید. برنامههایی که از Places API استفاده میکنند، تابع شرایط توافقنامه شما با Google هستند. با توجه به شرایط توافق نامه خود، نباید هیچ محتوایی را از قبل واکشی، فهرست بندی، ذخیره یا ذخیره کنید، مگر تحت شرایط محدودی که در شرایط ذکر شده است. توجه داشته باشید که شناسه مکان ، که برای شناسایی منحصربهفرد یک مکان استفاده میشود، از محدودیتهای حافظه پنهان مستثنی است. شناسه مکان در قسمت «place_id» در پاسخهای Places API برگردانده میشود. با نحوه ذخیره، بازخوانی و مدیریت شناسه مکان در راهنمای شناسه مکان آشنا شوید. می توانید نتایج Places API را روی نقشه گوگل یا بدون نقشه نمایش دهید. اگر میخواهید نتایج Places API را روی نقشه نشان دهید، این نتایج باید در نقشه گوگل نمایش داده شوند. استفاده از داده های Places API بر روی نقشه ای که نقشه گوگل نیست ممنوع است. اگر برنامه شما دادهها را در نقشه 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 ها در شی فیلدهای آبجکت اگر برنامه شما عکسهایی را نمایش میدهد، باید برای هر عکسی که دارای آنها است، اسناد نویسنده را نشان دهید. جزئیات مربوط به عکس در یک شی هر عنصر از آرایه فیلدهای شیء یک شی هنگام نمایش نظرات ارائه شده توسط کاربران Google، باید نام نویسنده را در نزدیکی قرار دهید. وقتی در فیلد انتساب نویسنده شی گوگل همچنین توصیه می کند که نحوه مرتب سازی نظرات را به کاربر نهایی نشان دهید. هر بررسی در یک شی فیلدهای شیء اگر نمیتوانید از نشانواره دانلودی Google استفاده کنید، دستورالعملهای سبک برای اسناد Google در CSS و HTML در زیر آمده است. مقدار فضای خالی اطراف قفل باید برابر یا بیشتر از ارتفاع "G" در گوگل باشد. فاصله بین کپی منبع و نشانواره Google باید نصف عرض "G" باشد. خط کناری باید همیشه واضح، خوانا و با تنوع رنگی مناسب برای یک پسزمینه مشخص باشد. همیشه مطمئن شوید که کنتراست کافی برای تنوع لوگویی که انتخاب می کنید ارائه می کنید. از متن Google Material Grey 700 در پسزمینه سفید یا روشن استفاده کنید که از محدوده 0% تا 40% حداکثر رنگ سیاه استفاده میکند. در پسزمینههای تیرهتر، و بیش از عکاسی یا الگوهای غیرمشغله، از متن سفید برای خطهای کناری و اسناد استفاده کنید. از فونت Roboto استفاده کنید. CSS زیر، وقتی روی متن "Google" اعمال شود، "Google" را با فونت، رنگ و فاصله مناسب روی پسزمینه سفید یا روشن نشان میدهد. برای استفاده در پس زمینه روشن برای استفاده در پس زمینه تیره 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
در یک پاسخ می تواند تا پنج نظر داشته باشد. می توانید به صورت اختیاری این نظرات را در برنامه خود نمایش دهید.Review
موجود است، توصیه می کنیم عکس نویسنده و پیوند به نمایه او را نیز اضافه کنید. تصویر زیر نمونه ای از بررسی یک پارک را نشان می دهد: Place
از یک پاسخ توسط یک شی Review
نشان داده می شود. برای افزودن شی Review
به پاسخ، places.reviews
(جستجوی نزدیک و جستجوی متن) یا reviews
(جزئیات مکان) را در ماسک فیلد درخواست اضافه کنید.Review
حاوی انتساب هستند، یا اگر هیچ انتسابی برای نمایش وجود نداشته باشد خالی هستند.
#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
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;