Places SDK برای Android به شما امکان میدهد برنامههای آگاه از موقعیت مکانی بسازید که به طور متناوب به مشاغل محلی و سایر مکانهای نزدیک دستگاه کاربر پاسخ میدهند. این بدان معناست که میتوانید برنامههای غنی را بر اساس مکانهایی بسازید که برای کاربر معنی دارند تا خدمات ساده مبتنی بر جغرافیایی ارائه شده توسط خدمات مکان Android را تکمیل کنند.
مفاهیم
رابطهای زیر نقاط ورودی اولیه Places SDK برای Android را فراهم میکنند:
Places دسترسی برنامهریزی شده به پایگاه داده Google از مکانهای محلی و اطلاعات کسبوکار و همچنین مکان فعلی دستگاه را فراهم میکند.
Autocomplete ویجتهای از پیش ساخته شده را برای بازگرداندن پیشبینیهای مکان در پاسخ به درخواستهای جستجوی کاربر فراهم میکند.
مکان به عنوان یک فضای فیزیکی که یک نام دارد تعریف می شود. راه دیگری برای تفکر در مورد یک مکان این است که آن مکان هر چیزی است که می توانید روی نقشه پیدا کنید. به عنوان مثال می توان به مشاغل محلی، نقاط دیدنی و مکان های جغرافیایی اشاره کرد. در API، یک مکان با رابط Place نشان داده می شود. این شامل اطلاعاتی مانند نام مکان و آدرس آن، موقعیت جغرافیایی، شناسه مکان، شماره تلفن، نوع مکان، آدرس وب سایت و غیره است.
نمای کلی API
به مشتریان خود کمک کنید مکان هایشان و آنچه را که در اطرافشان است کشف کنند:
تکمیل خودکار مکان به طور خودکار نام و/یا آدرس یک مکان را با تایپ کاربران پر می کند.
Place Details برمی گردد و اطلاعات دقیق تری درباره یک مکان نمایش می دهد.
Nearby Search فهرستی از مکانها را بر اساس مکان و شعاع جستجو برمیگرداند.
Place Photos تصاویری با کیفیت بالا از یک مکان برمی گرداند.
جستجوی متن مکان ها را بر اساس یک رشته متن جستجو برمی گرداند.
شناسههای مکان شناسه منحصربهفرد یک یا چند مکان را برای بازیابی اطلاعات مکان در صورت تقاضا ذخیره میکنند.
سیاست ها و شرایط
همه برنامههایی که از Places SDK برای Android استفاده میکنند باید از شرایطی که در شرایط خدمات ، استفاده و صورتحساب پلتفرم Google Maps توضیح داده شده است، و نشاندادهها را رعایت کنند.
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Places SDK for Android allows you to build location-aware apps that utilize Google's database of local place and business information.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose between the Places SDK for Android and the Places SDK for Android (New), each with its own features and pricing model.\u003c/p\u003e\n"],["\u003cp\u003eKey functionalities include Place Autocomplete, Current Place, Place Details, Text Search, Place Photos, and Place IDs to enrich user experiences.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the SDK, you need a project with a billing account and the Places API enabled, along with adhering to Google Maps Platform Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your app displays relevant attributions when presenting information sourced from the Places SDK for Android.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/places/android-sdk/overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/overview \"View this page for the Web Service platform docs.\") \n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| **Before you begin:** Before you start using the Places SDK for Android, you need a project with a billing account and the Places API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/places/android-sdk/cloud-setup).\n\nIntroduction\n\nThe Places SDK for Android lets you build location-aware apps that respond\ncontextually to the local businesses and other places near the user's device. This means you\ncan build rich apps based on places that mean something to the user, to complement the\nstraightforward geographic-based services offered by the\n[Android location services](https://developer.android.com/training/location/index.html).\n| **Note:** Places SDK (New) is the current version of Places SDK for Android. Places SDK is now Legacy and can no longer be enabled. Legacy documentation and migration guides are available on the [Legacy](/maps/documentation/places/android-sdk/overview-legacy) tab.\n\nConcepts\n\nThe following interfaces provide the primary entry points to the\nPlaces SDK for Android:\n\n- [`Places`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places) provides programmatic access to Google's database of local place and business information, as well as the device's current place.\n- [`Autocomplete`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/widget/Autocomplete) provides pre-made widgets to return place predictions in response to user search queries.\n\nA *place* is defined as a physical space that has a name. Another way\nof thinking about a place is that it's anything you can find on a map.\nExamples include local businesses, points of interest, and geographic\nlocations. In the API, a place is represented by the\n[`Place`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place)\ninterface. It includes information such as the name of the place and its\naddress, geographical location, place ID, phone number, place type, website\nURL, and more.\n| **Note:** Whenever your app displays information about places sourced from the Places SDK for Android, the app must also show all relevant attributions that are returned by the API. See the documentation on [displaying\n| attributions](/maps/documentation/places/android-sdk/attributions).\n\nAPI overview\n\nHelp your customers explore where they are and what's around them:\n\n- [Place Autocomplete](/maps/documentation/places/android-sdk/place-autocomplete) automatically fills in the name and/or address of a place as users type.\n- [Place Details](/maps/documentation/places/android-sdk/details-place) return and display more detailed information about a place.\n- [Nearby Search](/maps/documentation/places/android-sdk/nearby-search) returns a list of places based on a location and a search radius.\n- [Place Photos](/maps/documentation/places/android-sdk/place-photos) returns high-quality images of a place.\n- [Text Search](/maps/documentation/places/android-sdk/text-search) returns places based on a search text string.\n- [Place IDs](/maps/documentation/places/android-sdk/place-id) store the unique ID for one or more places for retrieval of place information on demand.\n\n| **Note:** Google gathers anonymous usage statistics.\n\nPolicies and Terms\n\nAll applications that use the Places SDK for Android must adhere\nto the requirements described in the\n[Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms),\n[Usage and Billing](/maps/documentation/places/android-sdk/usage-and-billing), and\n[Displaying Attributions](/maps/documentation/places/android-sdk/attributions)."]]