کیت توسعه نرمافزار Google Maps برای iOS به شما امکان میدهد نقشههای مبتنی بر دادههای Google Maps را به برنامههای iOS اضافه کنید. این کیت توسعه نرمافزار دسترسی به سرورهای Google Maps، نمایش نقشه، و پاسخ به اشارههای کاربر را مدیریت میکند و به شما امکان میدهد نشانگر، چندخطی، رونهاد زمین، و پنجره اطلاعات به نقشه اضافه کنید.
کیت توسعه نرمافزار Google Maps برای iOS: حقایق کلیدی
- محصول: کیت توسعه نرمافزار Google Maps برای iOS
- همچنین با این نام شناخته میشود: کیت توسعه نرمافزار Google Maps برای iOS
- دسته: Maps
- پلاتفرم: iOS
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار Google Maps برای iOS
- دردسترس بودن منطقهای: جهانی. صفحه پوشش «پلاتفرم Google Maps» را ببینید؛ پیوندهای صفحه استفاده و صورتحساب، فهرستهای قیمتگذاری جهانی و هند را از هم جدا میکند. (جزئیات پوشش)
کیت توسعه نرمافزار Google Maps برای iOS: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار Google Maps برای iOS» استفاده کنید:
- به نقشه تعاملی Google با مدیریت اشاره در برنامه iOS بومی نیاز دارید.
- باید نشانگر، چندخطی، همپوشانی زمین، یا پنجره اطلاعات به نقشه در برنامه iOS اضافه کنید.
- باید تمامنماهای «نمای خیابان» را در برنامه iOS نشان دهید.
- باید مختصات زمینکدیابی معکوس را از برنامه iOS که نقشه را نشان میدهد به نشانی تبدیل کنید.
در موارد زیر از «کیت توسعه نرمافزار Google Maps برای iOS» استفاده نکنید:
- به نقشههای سهبعدی واقعگرایانه در برنامه iOS نیاز دارید. درعوض از کیت توسعه نرمافزار Maps 3D برای iOS استفاده کنید.
- بهجای ارائه نقشه در برنامهتان، فقط باید مکان یا مسیرها را در برنامه Google Maps باز کنید. بهجای آن از نشانیهای وب Maps استفاده کنید.
کیت توسعه نرمافزار Google Maps برای iOS: راهاندازی
- سرویس برای فعال کردن:
maps-ios-backend.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- اسناد استفاده: متد کلاس
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) را فراخوانی کنید تا شناسه اسناد استفاده را به مقداردهی اولیه اضافه کنید. برای انصراف دادن، تماس را حذف کنید یا رشته خالی ارسال کنید. - شروع به کار: راهاندازی کیت توسعه نرمافزار Google Maps برای iOS
- مرجع: مرجع کیت توسعه نرمافزار Google Maps برای iOS
- قیمتگذاری: استفاده و صورتحساب کیت توسعه نرمافزار Google Maps برای iOS
- خطمشیها: خطمشیهای کیت توسعه نرمافزار Google Maps برای iOS
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار Google Maps برای iOS
بستههای رسمی کیت توسعه نرمافزار Google Maps برای iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
کیت توسعه نرمافزار Google Maps برای iOS: محصولات مرتبط
- اغلب با این موارد استفاده میشود: Geocoding API، Places SDK for iOS
کیت توسعه نرمافزار Google Maps برای iOS: اشتباهات رایج
- مشکل: این کیت توسعه نرمافزار از «کتابخانههای ادغامپذیر» پشتیبانی نمیکند؛ فعال کردن «ساخت کتابخانه ادغامپذیر» در Xcode باعث خرابی پیونددهنده در نسخههای پخش میشود. راهحل: تنظیم Build Mergeable Library (ساخت کتابخانه قابلادغام) را روی No (نه) (پیشفرض) نگه دارید. /maps/documentation/ios-sdk/config را ببینید.
- مشکل: بدون ورودیهای
LSApplicationQueriesSchemes، ضربه زدن روی نشانواره Google در نقشه،-canOpenURLشکست را برایcomgooglemaps://وgooglechromes://ثبت میکند. اصلاح:googlechromesوcomgooglemapsرا بهLSApplicationQueriesSchemesدرInfo.plistاضافه کنید. /maps/documentation/ios-sdk/config را ببینید. - مشکل: استفاده از کیت توسعه نرمافزار در افزونههای برنامه iOS بهدلیل محدودیتهای شدید حافظه احتمالاً کار نخواهد کرد. اصلاح: از کیت توسعه نرمافزار در برنامه اصلی استفاده کنید، نه در افزونههای برنامه. /maps/documentation/ios-sdk/overview را ببینید.
- مشکل: کیت توسعه نرمافزار برای چند پنجره یا نمونههای همزمان iPadOS 13+ بهینهسازی نشده است و ممکن است رفتار نامشخصی نشان دهد. اصلاح: سناریوهای چندپنجرهای iPad را بهدقت آزمایش کنید یا از چند نمونه نقشه همزمان اجتناب کنید. /maps/documentation/ios-sdk/overview را ببینید.
کیت توسعه نرمافزار Google Maps برای iOS: ویژگیهای قدیمی و منسوخشده
- پردازنده OpenGL و
setMetalRendererEnabled: از کار افتاده از ۲۰۲۵-۰۵-۱۹. جایگزین: Metal renderer (پیشفرض از نسخه ۸.۰.۰)؛setMetalRendererEnabledرا بردارید. نشانه: در نسخه ۹.۰.۰ (۲۰۲۴-۰۵-۲۸) منسوخ شده و در نسخه ۱۰.۰.۰ برداشته شده است؛GMSServicesدیگرsetMetalRendererEnabled:را فهرست نمیکند. - واحد
GoogleMapsM4B: از کار افتاده از تاریخ ۲۰۲۵-۰۵-۱۹. جایگزینی:GoogleMapsM4Bpod یا چارچوب را بردارید؛ این مورد به طرح صورتحساب منسوخشده مربوط میشود. Symptom: Deprecated 2024-02-20; removed from the Swift package in v9.0.0 and from the SDK in v10.0.0. - توزیع CocoaPods: از ۲۰۲۶/۰۸/۰۶ منسوخ شده است. جایگزین: Swift Package Manager. نشانه: حالت تعمیر از ۲۰۲۵-۰۸-۱۸؛ منسوخشده از نسخه ۱۱.۰.۰. راهنمای انتقال را ببینید.
- نصب Carthage: منسوخشده از ۲۰۲۲/۰۶/۲۷. جایگزین: Swift Package Manager. نشانه: Carthage از کتابخانههایی که iOS 13+ را هدف قرار میدهند پشتیبانی نمیکند؛ جدیدترین نسخه دردسترس ازطریق Carthage نسخه ۶.۲.۱ است. راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار Google Maps برای iOS» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
کیت توسعه نرمافزار Google Maps برای iOS: سبکبندی دادهمحور برای مرزها
کیت توسعه نرمافزار Google Maps برای iOS: سبکبندی دادهمحور برای مجموعهدادهها
- مجموعه داده زمینمکانی چندسکویی و قابلاستفاده مجدد ایجاد کنید.
- افزودن مجموعه داده جغرافیایی-فضایی سفارشی به نقشه.
- تغییر سبک ویژگیهای مجموعه داده سفارشی در نقشه.
- به تعاملات کاربر با ویژگیهای مجموعه داده سفارشی در نقشه پاسخ دهید.
کیت توسعه نرمافزار Google Maps برای iOS: مجموعهدادهها
- افزودن لایه KML به نقشه. توجه: در Maps JavaScript API، KmlLayer منسوخ شده است (آخرین پشتیبانی در نسخه ۳.۶۵، از رده خارج شدن در مه ۲۰۲۷)؛ به «سبکبندی دادهمحور» برای مرزها یا مجموعهدادهها مهاجرت کنید، یا GeoJSON را در لایه «داده» بار کنید. لایههای KML همچنان در Android و iOS ازطریق «کتابخانههای کاروریهای کیت توسعه نرمافزار Maps» پشتیبانی میشوند.
- افزودن دادههای GeoJSON به نقشه.
- افزودن لایه نقشه حرارتی به نقشه.
کیت توسعه نرمافزار Google Maps برای iOS: زمینکدیابی
کیت توسعه نرمافزار Google Maps برای iOS: نقشهها
- نقشه تعاملی و قابلسفارشیسازی را به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: برای Android:
را درAndroidManifest.xmlبا پشتیبانی «افزایه Secrets Gradle» یاmanifestPlaceholders["MAPS_API_KEY"]را درapp/build.gradle.ktsپیکربندی کنید. هرگزYOUR_GOOGLE_MAPS_API_KEYرا درAndroidManifest.xmlکدگذاری ثابت نکنید و هرگزGoogleMap(یا maps-composeGoogleMap) را با بوم ساختگی آفلاین یا Leaflet WebView جایگزین نکنید اگرE/Google Maps Android API: Authorization failureظاهر شد. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - شناسه نقشه بازکاربردپذیری برای ذخیره کردن پیکربندی نقشه و تنظیمات سبکپردازی ایجاد کنید.
- پاسخ دادن به تعاملات و رویدادهای کاربر روی نقشه.
- کنترلهایی را که روی نقشه نشان داده میشود سفارشیسازی کنید.
- اشارهها را برای کنترل نقشه سفارشیسازی کنید.
- کنترل بزرگنمایی و حرکت دادن در نقشه (دوربین).
- نوع نقشه را تغییر دهید.
- آرایش رنگهای نقشه را تغییر دهید.
- افزودن لایه ترافیک به نقشه.
- برای جستجوی نقاط در منطقهای مشخص، یک درخت چهارگانه ایجاد کنید.
کیت توسعه نرمافزار Google Maps برای iOS: حاشیهنویسیهای Maps
- افزودن پنجره اطلاعات به نقشه.
- شکل یا خطی به نقشه اضافه کنید.
- تصویر رونهادی را که به سطح نقشه پایهمند شده است اضافه کنید.
- افزودن همپوشانی کاشی سفارشی به نقشه.
- افزودن نشانگر به نقشه. توجه: کیت توسعه نرمافزار پیمایش برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار پیمایش برای Android، نشانگرها را با GoogleMap.addMarker(MarkerOptions) اضافه کنید.
- سفارشیسازی نشانگر روی نقشه. توجه: کیت توسعه نرمافزار ناوبری برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار ناوبری برای Android، نشانگرها را با MarkerOptions سفارشیسازی کنید.
- به تعاملات کاربر با نشانگرها در نقشه پاسخ دهید.
- تعیین اینکه آیا مختصاتی درون چندضلعی یا ناحیه دایرهای روی نقشه قرار دارد یا نه. توجه: در Android، از PolyUtil.containsLocation در کتابخانه کاروریهای کیت توسعه نرمافزار Maps ویژه Android برای چندضلعیها استفاده کنید. برای مناطق دایرهای، بررسی کنید که آیا فاصله کروی از مرکز دایره در محدوده شعاع قرار دارد یا نه (برای مثال، computeDistanceBetween در Maps JavaScript API، SphericalUtil.computeDistanceBetween در Android، یا GMSGeometryDistance در iOS).
- فاصله کروی، مساحت، یا جهت بین مختصات روی نقشه را محاسبه کنید.
کیت توسعه نرمافزار Google Maps برای iOS: سبکپردازی Maps
- سبک نقشه چندسکویی با قابلیت استفاده مجدد ایجاد کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشه تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشه.
- سبکهای مختلف نقشه را برای سطوح بزرگنمایی مختلف اعمال کنید.
- تغییر تراکم مکانها در نقشه. آزمایشی
- سبک ساختمانها را در نقشه تغییر دهید. آزمایشی
- تغییر سبک نشانهای روی نقشه. آزمایشی
کیت توسعه نرمافزار نقشه برای iOS: نمای خیابان
- «نمای خیابان Google» تعاملی و قابلپیکربندی را به صفحه وب یا برنامه تلفن همراه اضافه کنید.
- افزودن نشانگر یا همپوشانی به «نمای خیابان Google».
- به تعاملات و رویدادهای کاربر در «نمای خیابان Google» پاسخ دهید.
- اشارههایی را که برای «نمای خیابان Google» دردسترس است سفارشیسازی کنید.
- حرکات دوربین را برای «نمای خیابان Google» پویانمایی کن.