مرجع سریع کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS

کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS به برنامه‌های iOS امکان می‌دهد اطلاعات مربوط به مکان‌ها (کسب‌وکارها، مکان‌های جالب، مکان‌های جغرافیایی) را ازطریق «جزئیات جا»، «عکس‌های جا»، «جستجوی نوشتار»، «جستجوی اطراف»، و «تکمیل خودکار» دریافت کنند. Places API (New) نسخه فعلی کیت توسعه نرم‌افزار است.

کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS: حقایق کلیدی

  • محصول: کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS
  • همچنین با این نام شناخته می‌شود: Places SDK for iOS (New)
  • دسته: مکان‌ها
  • پلاتفرم: iOS
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار Places برای iOS

کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS: زمان استفاده از آن

در موارد زیر از «کیت توسعه نرم‌افزار مکان‌ها» ویژه iOS استفاده کنید:

  • به جزئیات مکان، عکس‌ها، «جستجوی نوشتار»، یا نتایج «جستجوی اطراف» در برنامه iOS بومی نیاز دارید.
  • به تکمیل خودکار نام یا نشانی مکان هنگام تایپ کردن کاربران در برنامه iOS نیاز دارید.
  • می‌خواهید مؤلفه‌های ازپیش‌ساخته‌شده «کیت میانای کاربر جاها» (جزئیات جا، جستجو، تکمیل خودکار) را در برنامه iOS داشته باشید.

در موارد زیر از «کیت توسعه نرم‌افزار مکان‌ها» برای iOS استفاده نکنید:

کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS: راه‌اندازی

بسته‌های رسمی کیت توسعه نرم‌افزار Places برای iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

کیت توسعه نرم‌افزار مکان‌ها، ویژه 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) در کیت توسعه نرم‌افزار نسخه ۱۱.۰.۰ و جدیدتر وجود ندارند و باعث ایجاد مشکل در کامپایل می‌شوند. راهنمای انتقال را ببینید.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner و GMSAutocompleteFetcher initWithBounds:filter: از کار افتاده از ۲۰۲۰-۱۰-۱۳. جایگزینی: GMSAutocompleteFilter (locationBias یا locationRestriction) در GMSAutocompleteRequest با GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:، یا اصلاح‌کننده‌های GooglePlacesSwift placeAutocomplete یا basicPlaceAutocomplete برای ابزاره میانای کاربر. نشانه: روش‌ها در کیت توسعه نرم‌افزار نسخه ۴.۰.۰ و جدیدتر وجود ندارند (و GMSAutocompleteResultsViewController و GMSAutocompleteFetcher در کیت توسعه نرم‌افزار نسخه ۱۱.۰.۰ برداشته شده‌اند). راهنمای انتقال را ببینید.
  • مرزهای تکمیل خودکار مبتنی بر GMSCoordinateBounds (پارامترهای GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode؛ bounds/boundsMode از findAutocompletePredictionsFromQuery و autocompleteQuery): از ۲۰۲۰-۱۰-۱۳ از رده خارج شده است. جایگزینی: GMSAutocompleteRequest با GMSAutocompleteFilter (locationBias یا locationRestriction) و GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:، یا اصلاح‌کننده‌های GooglePlacesSwift placeAutocomplete یا basicPlaceAutocomplete برای ابزاره میانای کاربر. نشانه: ویژگی‌ها و پارامترها در SDK نسخه ۴.۰.۰ و جدیدتر وجود ندارند (و GMSAutocompleteViewController و findAutocompletePredictionsFromQuery در SDK نسخه ۱۱.۰.۰ برداشته شدند). راهنمای انتقال را ببینید.
  • GMSPlace.openNowStatus: ازکارافتاده از ۲۰۲۰-۱۰-۱۳. جایگزین: GMSPlacesClient isOpenWithRequest: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: هوش مصنوعی زایا

کیت توسعه نرم‌افزار مکان‌ها، ویژه 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