Places SDK برای iOS به شما امکان می‌دهد برنامه‌های آگاه از موقعیت مکانی بسازید که به طور متناوب به مشاغل محلی و سایر مکان‌های نزدیک دستگاه پاسخ می‌دهند. این بدان معنی است که می توانید برنامه های غنی را بر اساس مکان هایی که برای کاربر معنی دارند بسازید.
مفاهیم
مکان به عنوان یک فضای فیزیکی که یک نام دارد تعریف می شود. راه دیگری برای تفکر در مورد یک مکان این است که آن مکان هر چیزی است که می توانید روی نقشه پیدا کنید. به عنوان مثال می توان به مشاغل محلی، نقاط دیدنی و مکان های جغرافیایی اشاره کرد. در API، یک مکان با GMSPlace Class Reference نشان داده می شود. این شامل اطلاعاتی مانند نام مکان و آدرس آن، موقعیت جغرافیایی، شناسه مکان، شماره تلفن، نوع مکان، آدرس وب سایت و غیره است.
نمای کلی SDK
از Places SDK برای iOS استفاده کنید تا به مشتریان خود کمک کنید کجا هستند و اطرافشان را کشف کنند. Places SDK برای iOS API های زیر را ارائه می دهد:
به طور خودکار نام و/یا آدرس یک مکان را هنگام تایپ کاربران پر می کند.
سایر موارد برجسته SDK عبارتند از:
تشخیص دقیق مکان در قدرت کم با اسکن Wi-Fi.
حافظه پنهان روی دستگاه: بیشتر درخواست‌ها برای Places SDK برای iOS ممکن است شامل یک سفر رفت و برگشت به سرور Google باشد، اما شما همچنین می‌توانید داده‌ها را به‌مدت 30 روز به صورت محلی ذخیره کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Places SDK for iOS allows you to build location-aware iOS applications that utilize local business and point of interest data.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK offers two versions: Places SDK for iOS and Places SDK for iOS (New), with the latter featuring a simplified pricing model and Swift support through a separate Preview SDK.\u003c/p\u003e\n"],["\u003cp\u003eCore functionalities include place details retrieval, place photos, text search, nearby search, autocomplete, and current place detection (in the older SDK version).\u003c/p\u003e\n"],["\u003cp\u003eThe SDK leverages on-device caching for improved performance and requires adherence to Google Maps Platform Terms of Service and attribution display guidelines.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you have a project with an active billing account and the Places API enabled.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nSelect 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 iOS, 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/ios-sdk/cloud-setup).\n\nIntroduction\n------------\n\nThe Places SDK for iOS lets you build location-aware apps that respond\ncontextually to the local businesses and other places near the device. This means you\ncan build rich apps based on places that mean something to the user.\n| **Note:** Places API (New) is the current version of the Places SDK for iOS. Places API is now Legacy and can no longer be enabled. Legacy documentation and migration guides are available on the [Legacy](/maps/documentation/places/ios-sdk/overview-legacy) tab.\n\nConcepts\n--------\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[`GMSPlace Class Reference`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSPlace).\nIt includes information such as the name of the place and its address, geographical location,\nplace ID, phone number, place type, website URL, and more.\n| **Note:** Whenever your app displays information about places sourced from the Places SDK for iOS, the app must also show all relevant attributions that are returned by the API. See the documentation on [displaying attributions](/maps/documentation/places/ios-sdk/attributions).\n\nSDK overview\n------------\n\nUse Places SDK for iOS to help your customers explore where they are and what's around\nthem. Places SDK for iOS provides the following APIs:\n\n| Places SDK for iOS (New) | Description |\n|-----------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Place Details (New)](/maps/documentation/places/ios-sdk/details-place) | Returns information about places, including the place's name and address, the geographical location, the type of place (such as night club, pet store, museum), and more. |\n| [Place Photo (New)](/maps/documentation/places/ios-sdk/place-photos) | Returns high-quality images of a place. |\n| [Text Search (New)](/maps/documentation/places/ios-sdk/text-search) | Returns information about a set of places based on a text search. |\n| [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search) | Returns information about a set of places by specifying a location as a search area. |\n| [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete) | Automatically fills in the name and/or address of a place as users type. |\n\nOther highlights of the SDK include:\n\n- Accurate place detection at low power with Wi-Fi scan.\n- On-device caching: Most requests to the Places SDK for iOS may involve a round trip to a Google server, but you can also cache data locally for 30 days.\n\nPolicies and terms\n------------------\n\nAll applications that use the Places SDK for iOS must adhere\nto the requirements described in the\n[Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms),\nand [Displaying Attributions](/maps/documentation/places/ios-sdk/attributions)."]]
