فهرست سرفصل‌های Swift
خانه (Swift HOME) معرفی (Swift Intro) شروع به کار (Swift Get Started) سینتکس (Swift Syntax) دستورات (Swift Statements) خروجی (Swift Output) چاپ اعداد (Print Numbers) کامنت ها (Swift Comments) متغیرها (Swift Variables) چاپ متغیرها (Print Variables) چند متغیره (Multiple Variables) شناسه ها (Identifiers) ثابت ها (Constants) نمونه های دنیای واقعی (Real-Life Examples) انواع داده (Swift Data Types) اعداد (Numbers) بولی ها (Booleans) کاراکترها (Characters) تبدیل نوع (Swift Type Casting) عملگرها (Swift Operators) عملگرهای حسابی (Arithmetic Operators) عملگرهای انتساب (Assignment Operators) عملگرهای مقایسه ای (Comparison Operators) عملگرهای منطقی (Logical Operators) اولویت عملگرها (Operator Precedence) رشته ها (Swift Strings) اتصال رشته ها (Concatenation) اعداد و رشته ها (Numbers and Strings) کاراکترهای ویژه (Special Characters) یونیکد و اسکالرها (Unicode & Scalars) آرایه ها (Swift Arrays) حلقه روی آرایه (Loop Through an Array) برش های آرایه (Array Slices) اندیس ها و کران ها (Indices & Bounds) آرایه های چندبعدی (Multidimensional Arrays) نمونه های دنیای واقعی (Real-Life Examples) بازه ها (Swift Ranges) اگر...وگرنه (Swift If...Else) if (if) else (else) else if (else if) اگر...وگرنه کوتاه (Short Hand If...Else) if تو در تو (Nested If) عملگرهای منطقی (Logical Operators) نمونه های دنیای واقعی (Real-Life Examples) سوئیچ (Swift Switch) حلقه while (Swift While Loop) حلقه repeat/while (Repeat/While Loop) نمونه های دنیای واقعی (Real-Life Examples) حلقه for (Swift For Loop) حلقه های تو در تو (Nested Loops) حلقه for-each (For-Each Loop) نمونه های دنیای واقعی (Real-Life Examples) شکستن/ادامه (Swift Break/Continue) کالکشن ها (Swift Collections) ست ها (Sets) دیکشنری ها (Dictionaries) map، filter، reduce (map, filter, reduce) مرتب سازی (Sorting) تغییرپذیری (let دربرابر var) (Mutability (let vs var)) پروتکل های کالکشن (Collection Protocols) توابع (Swift Functions) اختیاری ها (Swift Optionals) enumها و الگوها (Swift Enums & Patterns) Closureها (Swift Closures) تاپل ها و نام های مستعار نوع (Tuples & Type Aliases) برنامه نویسی شیءگرا (Swift OOP) کلاس ها/اشیا (Classes/Objects) ساختارها (Structs) کلاس vs ساختار (Class vs Struct) ویژگی های کلاس (Class Properties) متدهای کلاس (Class Methods) کلیدواژه self (self Keyword) ارث بری (Swift Inheritance) چندریختی (Swift Polymorphism) پروتکل ها (Swift Protocols) جنریک ها (Swift Generics) اکستنشن ها (Swift Extensions) کنترل دسترسی (Access Control) سازنده ها (Initializers) مخرب ها (Deinitializers) معنای مقداری و COW (Value Semantics & COW) Equatable و Comparable (Equatable & Comparable) مدیریت خطا (Swift Error Handling) هم روندی (Swift Concurrency) حافظه (Swift Memory) مدیر بسته سوئیفت (Swift Package Manager) معرفی SwiftUI (SwiftUI Intro) راه اندازی پروژه iOS (iOS Project Setup) چیدمان SwiftUI (SwiftUI Layout) HStack VStack ZStack (HStack VStack ZStack) اسپیسر و ترازبندی (Spacers & Alignment) فریم و پدینگ (Frames & Padding) گریدها (Grids) GeometryReader (GeometryReader) ناحیه امن (Safe Area) استک های تنبل (Lazy Stacks) ناوبری SwiftUI (SwiftUI Navigation) NavigationStack (NavigationStack) NavigationLink (NavigationLink) TabView (TabView) شیت ها و پاپ اورها (Sheets & Popovers) دیپ لینک ها (Deep Links) ناوبری برنامه ای (Programmatic Nav) navigationDestination (navigationDestination) نوار ابزار و آیتم ها (Toolbar & Bar Items) جریان داده در SwiftUI (SwiftUI Data Flow) @State (@State) @Binding (@Binding) @ObservedObject & @StateObject (@ObservedObject & @StateObject) @EnvironmentObject (@EnvironmentObject) @Environment (Values) (@Environment (Values)) لیست ها و فرم ها در SwiftUI (SwiftUI Lists & Forms) List (List) ForEach (ForEach) Section (Section) Form (Form) TextField/Toggle/Picker (TextField/Toggle/Picker) Swipe Actions (Swipe Actions) Edit Mode (Edit Mode) List Styles (List Styles) انیمیشن ها در SwiftUI (SwiftUI Animations) انیمیشن های ضمنی (Implicit Animations) انیمیشن های صریح (Explicit Animations) ترنزیشن ها (Transitions) MatchedGeometryEffect (MatchedGeometryEffect) انیمیشن های فنری (Spring Animations) منحنی های انیمیشن (Animation Curves) ژست ها در SwiftUI (SwiftUI Gestures) TapGesture (TapGesture) LongPressGesture (LongPressGesture) DragGesture (DragGesture) ترکیب ژست ها (Composing Gestures) MagnificationGesture (MagnificationGesture) RotationGesture (RotationGesture) Modifierها و ViewBuilder (SwiftUI Modifiers & ViewBuilder) مودیفایرها (Modifiers) ViewBuilder (ViewBuilder) مودیفایرهای سفارشی (Custom Modifiers) پیش نمایش ها (SwiftUI Previews) گونه ها و وضعیت ها (Variants & States) حالت روشن/تیره (Light/Dark Mode) دسترس پذیری در SwiftUI (SwiftUI Accessibility) برچسب ها و عمل ها (Labels & Actions) سایز پویا (Dynamic Type) فوکوس و VoiceOver (Focus & VoiceOver) استایل دهی و تم دهی در SwiftUI (SwiftUI Styling & Theming) طرح های رنگی (Color Schemes) متریال ها (Materials) تم دهی (Theming) شبکه سازی (Networking) ماندگاری (Persistence) ماندگاری (Core Data) (Persistence (Core Data)) معماری MVVM (MVVM Architecture) AppStorage و SceneStorage (AppStorage & SceneStorage) تست SwiftUI (Testing SwiftUI) حریم خصوصی و مجوزها (Privacy & Permissions) اعلان های پوش (Push Notifications) ویجت ها و اکستنشن ها (Widgets & Extensions) کار در پس زمینه (Background Work) Core Location (Core Location) App Clips (App Clips) مبانی Keychain (Keychain Basics) CloudKit (CloudKit) سیستم فایل (File System) URLSession پس زمینه (Background URLSession) MapKit (MapKit) بومی سازی (Localization) دسترس پذیری (Accessibility) حریم خصوصی اپ (App Privacy) خرید درون برنامه ای (In-App Purchases) آنالیتیکس و گزارش گیری (Analytics & Reporting) تست با XCTest (Testing with XCTest) دارایی ها و آیکون ها (Assets & App Icons) امضا و انتشار (Signing & Distribution) TestFlight و App Store (TestFlight & App Store) انتشار اولین اپ (Ship Your First App) تمارین (Swift Exercises) کوییز (Swift Quiz)
نتیجه‌ای برای جستجو یافت نشد.

MapKit (MapKit)

می خواهیم با «نقشه MapKit» آشنا شویم. MapKit نقشه نشان می دهد. سپس مکان ها و مسیرها را مدیریت می کند. اصطلاح «Annotation» یعنی پین یا نماگر روی نقشه.

نقشه ساده با Region

برای نمایش نقشه، یک «ناحیه دوربین (MapCameraPosition)» می سازیم. سپس به Map وصل می کنیم.

import SwiftUI;
import MapKit;

struct BasicMap: View {
  @State private var position: MapCameraPosition = .region(
    MKCoordinateRegion(
      center: CLLocationCoordinate2D(latitude: 37.3349, longitude: -122.0090),
      span: MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
    )
  );
  var body: some View {
    Map(position: $position)
      .ignoresSafeArea();
  }
}

مشاهده در ادیتور

import SwiftUI;

struct ContentView: View {
  var body: some View {
    BasicMap();
  }
}

مشاهده در ادیتور

import SwiftUI;

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView();
    }
  }
}

مشاهده در ادیتور

این کد نقشه را روی Apple Park می گذارد. بزرگ نمایی هم ملایم است.

Annotation و Marker

«Annotation» یعنی علامت روی مختصات خاص. «Marker» یک پین ساده است.

import SwiftUI;
import MapKit;

struct MarkersMap: View {
  @State private var position: MapCameraPosition = .region(
    MKCoordinateRegion(
      center: CLLocationCoordinate2D(latitude: 37.3349, longitude: -122.0090),
      span: MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
    )
  );
  let places = [
    ("Park", CLLocationCoordinate2D(latitude: 37.3349, longitude: -122.0090)),
    ("Cafe", CLLocationCoordinate2D(latitude: 37.3327, longitude: -122.0053))
  ];
  var body: some View {
    Map(position: $position) {
      ForEach(places, id: \.0) { name, coord in
        Marker(name, coordinate: coord);
      }
    }
  }
}

مشاهده در ادیتور

import SwiftUI;

struct ContentView: View {
  var body: some View {
    MarkersMap();
  }
}

مشاهده در ادیتور

import SwiftUI;

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView();
    }
  }
}

مشاهده در ادیتور

اینجا دو Marker نزدیک هم داریم. یکی پارک است. یکی کافه.

بازکردن مسیر در Apple Maps

با MKMapItem مقصد را می سازیم. سپس مسیر را در Maps باز می کنیم.

import MapKit;

func openDirections() {
  let dest = MKMapItem(placemark: MKPlacemark(coordinate: .init(latitude: 37.3349, longitude: -122.0090)));
  dest.name = "Apple Park";
  dest.openInMaps(launchOptions: [MKLaunchOptionsDirectionsModeKey: MKLaunchOptionsDirectionsModeDriving]);
}

مشاهده در ادیتور

import SwiftUI;

struct ContentView: View {
  var body: some View {
    Button("Open Directions") {
      openDirections();
    }
    .padding();
  }
}

مشاهده در ادیتور

import SwiftUI;

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView();
    }
  }
}

مشاهده در ادیتور

نکته: قبل از استفاده از مکان کاربر، اجازه دسترسی را درخواست کن.

گام های عملی سریع

  1. 1) ماژول MapKit را ایمپورت کن.
  2. 2) Region یا CameraPosition بساز.
  3. 3) Map را با position ببند.
  4. 4) Marker یا Annotation اضافه کن.
  5. 5) اگر خواستی، مسیر را در Maps باز کن.

جمع بندی سریع

  • نقشه MapKit نمایش نقشه را ساده می کند.
  • Annotation پین یا نمای سفارشی است.
  • MKMapItem مسیر را در Maps باز می کند.
  • مجوز مکان را فراموش نکن.

مطالب مرتبط: URLSession پس زمینه برای دانلود فایل ها، Core Location برای درخواست موقعیت.