کیت توسعه نرمافزار مکانها، ویژه iOS به برنامههای iOS امکان میدهد اطلاعات مربوط به مکانها (کسبوکارها، مکانهای جالب، مکانهای جغرافیایی) را ازطریق «جزئیات جا»، «عکسهای جا»، «جستجوی نوشتار»، «جستجوی اطراف»، و «تکمیل خودکار» دریافت کنند. Places API (New) نسخه فعلی کیت توسعه نرمافزار است.
کیت توسعه نرمافزار مکانها، ویژه iOS: حقایق کلیدی
- محصول: کیت توسعه نرمافزار مکانها، ویژه iOS
- همچنین با این نام شناخته میشود: Places SDK for iOS (New)
- دسته: مکانها
- پلاتفرم: iOS
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار Places برای iOS
کیت توسعه نرمافزار مکانها، ویژه iOS: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار مکانها» ویژه iOS استفاده کنید:
- به جزئیات مکان، عکسها، «جستجوی نوشتار»، یا نتایج «جستجوی اطراف» در برنامه iOS بومی نیاز دارید.
- به تکمیل خودکار نام یا نشانی مکان هنگام تایپ کردن کاربران در برنامه iOS نیاز دارید.
- میخواهید مؤلفههای ازپیشساختهشده «کیت میانای کاربر جاها» (جزئیات جا، جستجو، تکمیل خودکار) را در برنامه iOS داشته باشید.
در موارد زیر از «کیت توسعه نرمافزار مکانها» برای iOS استفاده نکنید:
- درحال ساختن برنامه Android بومی هستید. بهجای آن، از کیت توسعه نرمافزار مکانها، ویژه Android استفاده کنید.
- درحال ساختن صفحه وب در مرورگر هستید. بهجای آن از Maps JavaScript API استفاده کنید.
- به دادههای مکان از سرور یا زیرینه ازطریق HTTP نیاز دارید، نه در کارخواه iOS. درعوض از Places API (New) استفاده کنید.
کیت توسعه نرمافزار مکانها، ویژه iOS: راهاندازی
- سرویس برای فعال کردن:
places.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- انتساب استفاده: روش کلاس
addInternalUsageAttributionIDرا درGMSPlacesClient(Objective-C/Swift) یاPlacesClient(GooglePlacesSwift) فراخوانی کنید تا شناسه انتساب استفاده اضافه شود؛ با حذف کردن فراخوانی، انصراف داده میشود. - شروع به کار: راهاندازی Places SDK for iOS
- مرجع: مرجع کیت توسعه نرمافزار مکانها، ویژه iOS
- قیمتگذاری: استفاده و صدور صورتحساب Places SDK for iOS
- خطمشیها: خطمشیهای «کیت توسعه نرمافزار مکانها» برای iOS
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار Places برای iOS
بستههای رسمی کیت توسعه نرمافزار Places برای iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
کیت توسعه نرمافزار مکانها، ویژه iOS: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار Google Maps برای iOS
کیت توسعه نرمافزار مکانها، ویژه iOS: اشتباهات رایج
- مشکل: اگر Places API (جدید) در پروژه Cloud فعال نباشد یا در فهرست میاناهای برنامهسازی کاربردی مجاز کلید میانای برنامهسازی کاربردی نباشد، فراخوانیهای Places SDK for iOS (جدید) ناموفق خواهد بود. راهحل: Places API (جدید) را فعال کنید و آن را به محدودیتهای کلید API مورداستفاده برنامه اضافه کنید. /maps/documentation/places/ios-sdk/legacy/migrate-overview را ببینید.
- مشکل:
kGMSPlacesRateLimitExceeded(-7) یعنی کلید API از حد نرخ استفادهاش فراتر رفته است؛ برنامههایی که از نسخههای خاموششده SDK 2.x (خاموششده در ۲۹ ژوئیه ۲۰۱۹) استفاده میکنند نیز این خطا را دریافت میکنند. اصلاح: سهمیه و استفاده از Places API (جدید) را در کنسول Google Cloud بررسی کنید و برنامهها را در نسخههای کیت توسعه نرمافزار (SDK) قدیمیتر از ۳.۰ بهروز کنید. /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode را ببینید. - مشکل: استفاده مجدد از کد جلسه در برنامههای مختلف در یک پروژه یا در جلسات مختلف، گروهبندی صورتحساب جلسه تکمیل خودکار را مختل میکند. اصلاح: برای هر جلسه تکمیل خودکار، یک کد جلسه یکتا (UUID نسخه ۴ توصیه میشود) تولید کنید؛ کدها باید برای هر پروژه یکتا باشند. /maps/documentation/places/ios-sdk/use-session-tokens را ببینید.
- مشکل: برنامهها دادههای مکان را بدون ارجاعهای برگرداندهشده توسط API نمایش میدهند. اصلاح: نمایش همه ارجاعهای مربوطه که با دادههای «اماکن» برگردانده شدهاند، طبق صفحه خطمشیها. /maps/documentation/places/ios-sdk/overview را ببینید.
کیت توسعه نرمافزار مکانها، ویژه iOS: ویژگیهای قدیمی و منسوخشده
- کیت توسعه نرمافزار Places برای iOS (نسخه قدیمی): از ۲۰۲۵/۰۳/۰۱ قدیمی شده است. جایگزین: Places SDK for iOS (New) (requires Places API (New)). نشانه: کلاسها و روشهای قدیمی (برای مثال
fetchPlaceFromPlaceID،GMSAutocompleteFetcher، وGMSAutocompleteViewController) در کیت توسعه نرمافزار نسخه ۱۱.۰.۰ و جدیدتر وجود ندارند و باعث ایجاد مشکل در کامپایل میشوند. راهنمای انتقال را ببینید. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerوGMSAutocompleteFetcherinitWithBounds:filter: از کار افتاده از ۲۰۲۰-۱۰-۱۳. جایگزینی:GMSAutocompleteFilter(locationBiasیاlocationRestriction) درGMSAutocompleteRequestباGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:، یا اصلاحکنندههایGooglePlacesSwiftplaceAutocompleteیاbasicPlaceAutocompleteبرای ابزاره میانای کاربر. نشانه: روشها در کیت توسعه نرمافزار نسخه ۴.۰.۰ و جدیدتر وجود ندارند (وGMSAutocompleteResultsViewControllerوGMSAutocompleteFetcherدر کیت توسعه نرمافزار نسخه ۱۱.۰.۰ برداشته شدهاند). راهنمای انتقال را ببینید.- مرزهای تکمیل خودکار مبتنی بر
GMSCoordinateBounds(پارامترهایGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode؛bounds/boundsModeازfindAutocompletePredictionsFromQueryوautocompleteQuery): از ۲۰۲۰-۱۰-۱۳ از رده خارج شده است. جایگزینی:GMSAutocompleteRequestباGMSAutocompleteFilter(locationBiasیاlocationRestriction) وGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:، یا اصلاحکنندههایGooglePlacesSwiftplaceAutocompleteیاbasicPlaceAutocompleteبرای ابزاره میانای کاربر. نشانه: ویژگیها و پارامترها در SDK نسخه ۴.۰.۰ و جدیدتر وجود ندارند (وGMSAutocompleteViewControllerوfindAutocompletePredictionsFromQueryدر SDK نسخه ۱۱.۰.۰ برداشته شدند). راهنمای انتقال را ببینید. GMSPlace.openNowStatus: ازکارافتاده از ۲۰۲۰-۱۰-۱۳. جایگزین:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) یاPlacesClient.isPlaceOpen(with:)درGooglePlacesSwift. نشانه: دارایی در کیت توسعه نرمافزار نسخه ۴.۰.۰ و جدیدتر وجود ندارد. راهنمای انتقال را ببینید.GMSPlaceFieldبهعنوانNS_ENUM: از رده خارج شده از ۲۰۲۰-۱۰-۱۳. جایگزینی: ثابتهایGMSPlacePropertyبا کلاسهای درخواست مثلGMSFetchPlaceRequestوGMSPlaceSearchByTextRequest، یاPlacePropertyدرGooglePlacesSwift. نشانه: باNS_OPTIONSدر کیت توسعه نرمافزار نسخه ۴.۰.۰ جایگزین شده است (GMSPlaceFieldچونNS_OPTIONSبه API قدیمی تعلق دارد و در کیت توسعه نرمافزار نسخه ۱۱.۰.۰ و نسخههای جدیدتر وجود ندارد). راهنمای انتقال را ببینید.- کیت توسعه نرمافزار Places برای iOS نسخه ۲.۷.۰: از کار افتاده از ۲۰۱۹/۰۷/۲۹. جایگزین: نسخه فعلی Places SDK for iOS. نشانه:
kGMSPlacesRateLimitExceededخطا.
کارهایی که میتوانید با «کیت توسعه نرمافزار مکانها» برای iOS انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
کیت توسعه نرمافزار مکانها، ویژه iOS: هوش مصنوعی زایا
- خلاصهای با پشتیبانی هوش مصنوعی از مرورهای کاربر برای شناسه مشخصشده «مکان Google» برگردانید.
- خلاصه مکان با بهرهگیری از هوش مصنوعی را برای منطقه و امکانات رفاهی اطراف شناسه مکان Google مشخصشده برای ایستگاه شارژ خودرو برقی برمیگرداند.
کیت توسعه نرمافزار مکانها، ویژه iOS: مکانها
- فهرستی از مکانها و جزئیات مکان را براساس رشته پُرسمان برمیگرداند.
- فهرستی از مکانها و جزئیات مکان نزدیک به یک مکان خاص را برمیگرداند.
- نتایج تکمیل خودکار درباره مکانها را براساس رشته پُرسمان برمیگرداند.
- اطلاعات دقیق درباره مکان خاصی را برمیگرداند.
- عکسهای مکان خاصی را برگردانید. توجه: ارجاع به نویسنده هر عکس (نام نویسنده، پیوندشده به شناسه منبع یکسان نمایه او) را همراه با عکس نمایش دهید. خطمشیهای «اماکن» برای هر پلاتفرم این را الزامی میکند، برای مثال /maps/documentation/javascript/policies#photo-attributions و /maps/documentation/places/web-service/policies#photos-and-review.
- تغییر اندازه عکسهای مکان.
- ردهبندیها و مرورهای مکان خاصی را برمیگرداند. توجه: در سرویس وب Places API (جدید)، «جزئیات جا» یک درخواست HTTP GET به https://places.googleapis.com/v1/places/{placeId} با X-Goog-FieldMask (برای مثال، rating,userRatingCount,reviews) است؛ «جستجوی نوشتار»، «جستجوی اطراف»، و «تکمیل خودکار» از POST استفاده میکنند. در Android، Place.Field.RATING، USER_RATING_COUNT، و REVIEWS را به PlacesClient.fetchPlace() ارسال کنید. در iOS، GMSPlacePropertyRating، GMSPlacePropertyUserRatingsTotal، و GMSPlacePropertyReviews را در GMSFetchPlaceRequest ارسال کنید.
- افزودن ابزاره تکمیل خودکار به صفحه وب یا برنامهای که نتایج مربوط به مکانها را براساس رشته پُرسمان برمیگرداند.
- فیلدهای دادهای را که در پاسخهای اطلاعات مکان گنجانده شده است مشخص کنید.
- انواع مکان را برای گنجاندن در پاسخهای اطلاعات مکان مشخص کنید.
- اطلاعات مربوط به مکانی را که دستگاه کاربر درحالحاضر در آن قرار دارد برمیگرداند. توجه: روشهای قدیمی «مکان فعلی» در «کیت توسعه نرمافزار مکانها» برای Android نسخه ۶.۰ و بالاتر و «کیت توسعه نرمافزار مکانها» برای iOS نسخه ۱۱.۰ و بالاتر برداشته شدهاند؛ مختصات دستگاه را از خدمات مکان پلاتفرم بازیابی کنید و «جستجوی اطراف» را فراخوانی کنید.
- خلاصه نمای کلی با پشتیبانی هوش مصنوعی را برای مکان خاصی برمیگرداند.
- خلاصه منطقه با پشتیبانی هوش مصنوعی را که مکانهای اطراف مکان خاصی را توصیف میکند برمیگرداند.
- اطلاعات مربوط به مکانها را براساس رشته پُرسمانی که درطول مسیر ازپیش تعریفشده قرار دارد برمیگرداند.
- فاصله، زمان سفر، و شناسه منبع یکسان مسیرها را برای جستجوی نوشتاری مکانها از مجموعهای از مختصات عرض جغرافیایی/ طول جغرافیایی برگردانید.
- برگرداندن فاصله، مدت سفر، و شناسه منبع یکسان مسیرها به مکانهای اطراف از مجموعهای از مختصات عرض جغرافیایی/طول جغرافیایی.
کیت توسعه نرمافزار مکانها، ویژه iOS: کیت میانای کاربر «جاها»
- سبک CSS را بر عنصر میانای کاربر دادههای مکان اعمال کنید. توجه: ویژگیهای سفارشی CSS برای عناصر «کیت میانای کاربر جاها» در Maps JavaScript API اعمال میشود؛ «کیت توسعه نرمافزار جاها» برای Android و «کیت توسعه نرمافزار جاها» برای iOS نماهای «کیت میانای کاربر جاها» را بهصورت برنامهنویسیشده بااستفاده از مشخصههای طرحواره و سبک، سبکبندی میکنند. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- با ابزار سفارشیسازی عنصر میانای کاربر، پیکربندیها و سبک عنصر میانای کاربر دادههای مکان را سفارشیسازی کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که اطلاعات مربوط به مکان خاصی را نمایش میدهد به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نشان دادن دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که فهرستی از مکانها را براساس رشته پُرسمان نمایش میدهد به صفحه وب اضافه کنید. توجه: هم در صفحههای وب (میانای برنامهسازی کاربردی جاوا اسکریپت Maps) و هم در برنامههای تلفن همراه (کیت توسعه نرمافزار Places برای Android و کیت توسعه نرمافزار Places برای iOS) پشتیبانی میشود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که فهرستی از مکانهای نزدیک به یک مکان خاص را نمایش میدهد به صفحه وب اضافه کنید. توجه: هم در صفحههای وب (میانای برنامهسازی کاربردی جاوا اسکریپت Maps) و هم در برنامههای تلفن همراه (کیت توسعه نرمافزار Places برای Android و کیت توسعه نرمافزار Places برای iOS) پشتیبانی میشود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- افزودن عنصر میانای کاربر تکمیل خودکار پایه به صفحه وب یا برنامهای که شناسههای «مکان Google» را براساس رشته پُرسمان برمیگرداند. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq