ژست های نقشه را فعال و غیرفعال کنید

نقشه تنها زمانی به حرکات زوم پاسخ می دهد که سوئیچ روشن باشد.

شروع کنید

قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای iOS را ببینید.

کد را مشاهده کنید

سویفت

import GoogleMaps
import UIKit

class GestureControlViewController: UIViewController {
  private let holderHeight: CGFloat = 60
  private let zoomLabelInset: CGFloat = 16

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -25.5605, longitude: 133.605097, zoom: 3)
    return GMSMapView(frame: .zero, camera: camera)
  }()
  private lazy var zoomSwitch: UISwitch = UISwitch(frame: .zero)

  override func viewDidLoad() {
    super.viewDidLoad()

    view.addSubview(mapView)

    let holder = UIView(frame: .zero)
    holder.backgroundColor = UIColor(white: 1, alpha: 0.8)
    view.addSubview(holder)

    let zoomLabel = UILabel(frame: .zero)
    zoomLabel.text = "Zoom gestures"
    zoomLabel.font = .boldSystemFont(ofSize: 18)
    holder.addSubview(zoomLabel)

    // Control zooming.
    holder.addSubview(zoomSwitch)
    zoomSwitch.addTarget(self, action: #selector(toggleZoom), for: .valueChanged)
    zoomSwitch.isOn = true

    [mapView, holder, zoomLabel, zoomSwitch].forEach({
      $0.translatesAutoresizingMaskIntoConstraints = false
    })
    NSLayoutConstraint.activate([
      mapView.leftAnchor.constraint(equalTo: view.leftAnchor),
      mapView.rightAnchor.constraint(equalTo: view.rightAnchor),
      mapView.topAnchor.constraint(equalTo: view.topAnchor),
      mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
      holder.heightAnchor.constraint(equalToConstant: holderHeight),
      holder.centerXAnchor.constraint(equalTo: view.centerXAnchor),
      holder.widthAnchor.constraint(equalTo: view.widthAnchor),
      zoomLabel.leftAnchor.constraint(equalTo: holder.leftAnchor, constant: zoomLabelInset),
      zoomLabel.centerYAnchor.constraint(equalTo: holder.centerYAnchor),
      zoomSwitch.rightAnchor.constraint(equalTo: holder.rightAnchor, constant: -zoomLabelInset),
      zoomSwitch.centerYAnchor.constraint(
        equalTo: holder.centerYAnchor),
    ])
    NSLayoutConstraint.activate([
      holder.topAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.topAnchor)
    ])
  }

  @objc func toggleZoom() {
    mapView.settings.zoomGestures = zoomSwitch.isOn
  }

}
      

هدف-C

#import "GoogleMapsDemos/Samples/GestureControlViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation GestureControlViewController {
  GMSMapView *_mapView;
  UISwitch *_zoomSwitch;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-25.5605
                                                          longitude:133.605097
                                                               zoom:3];

  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  _mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
  _mapView.accessibilityIdentifier = @"gestureControlDemoMapView";

  self.view = [[UIView alloc] initWithFrame:CGRectZero];
  [self.view addSubview:_mapView];

  UIView *holder = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 0, 59)];
  holder.autoresizingMask =
      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin;
  holder.backgroundColor = [UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.8f];
  [self.view addSubview:holder];

  // Zoom label.
  UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(16, 16, 200, 29)];
  label.text = @"Zooming?";
  label.font = [UIFont boldSystemFontOfSize:18.0f];
  label.textAlignment = NSTextAlignmentLeft;
  label.backgroundColor = [UIColor clearColor];
  label.layer.shadowColor = [[UIColor whiteColor] CGColor];
  label.layer.shadowOffset = CGSizeMake(0.0f, 1.0f);
  label.layer.shadowOpacity = 1.0f;
  label.layer.shadowRadius = 0.0f;
  [holder addSubview:label];

  // Control zooming.
  _zoomSwitch = [[UISwitch alloc] initWithFrame:CGRectMake(-90, 16, 0, 0)];
  _zoomSwitch.autoresizingMask = UIViewAutoresizingFlexibleLeftMargin;
  [_zoomSwitch addTarget:self
                  action:@selector(didChangeZoomSwitch)
        forControlEvents:UIControlEventValueChanged];
  _zoomSwitch.on = YES;
  [holder addSubview:_zoomSwitch];
}

- (void)didChangeZoomSwitch {
  _mapView.settings.zoomGestures = _zoomSwitch.isOn;
}

@end
      

برنامه نمونه کامل را به صورت محلی اجرا کنید

برنامه نمونه Maps SDK برای iOS به عنوان یک بایگانی دانلود از GitHub در دسترس است. این مراحل را دنبال کنید تا برنامه نمونه Maps SDK برای iOS را نصب و امتحان کنید.

  1. git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git را اجرا کنید تا مخزن نمونه ها را در یک فهرست محلی کلون کنید.
  2. یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید، و به فهرست راهنمای GoogleMaps بروید:

    سویفت

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
    pod install
    open GoogleMapsSwiftDemos.xcworkspace

    هدف-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    pod install
    open GoogleMapsDemos.xcworkspace
  3. در Xcode، دکمه کامپایل را فشار دهید تا برنامه با طرح فعلی ساخته شود . بیلد یک خطایی ایجاد می‌کند که از شما می‌خواهد کلید API خود را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  4. اگر هنوز کلید API ندارید، دستورالعمل‌ها را برای راه‌اندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، می توانید کلید را به شناسه بسته نرم افزاری نمونه محدود کنید تا مطمئن شوید که فقط برنامه شما می تواند از کلید استفاده کند. شناسه بسته پیش‌فرض برنامه نمونه‌های SDK com.example.GoogleMapsDemos است.
  5. فایل SDKConstants.swift را برای Swift یا SDKDemoAPIKey.h برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابت apiKey یا kAPIKey قرار دهید. به عنوان مثال:

    سویفت

    static let apiKey = "YOUR_API_KEY"

    هدف-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:

    سویفت

    #error (Register for API Key and insert here. Then delete this line.)

    هدف-C

    #error Register for API Key and insert here.
  7. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود که فهرستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
  8. یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
  9. اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.
،
نقشه تنها زمانی به حرکات زوم پاسخ می دهد که سوئیچ روشن باشد.

شروع کنید

قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای iOS را ببینید.

کد را مشاهده کنید

سویفت

import GoogleMaps
import UIKit

class GestureControlViewController: UIViewController {
  private let holderHeight: CGFloat = 60
  private let zoomLabelInset: CGFloat = 16

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -25.5605, longitude: 133.605097, zoom: 3)
    return GMSMapView(frame: .zero, camera: camera)
  }()
  private lazy var zoomSwitch: UISwitch = UISwitch(frame: .zero)

  override func viewDidLoad() {
    super.viewDidLoad()

    view.addSubview(mapView)

    let holder = UIView(frame: .zero)
    holder.backgroundColor = UIColor(white: 1, alpha: 0.8)
    view.addSubview(holder)

    let zoomLabel = UILabel(frame: .zero)
    zoomLabel.text = "Zoom gestures"
    zoomLabel.font = .boldSystemFont(ofSize: 18)
    holder.addSubview(zoomLabel)

    // Control zooming.
    holder.addSubview(zoomSwitch)
    zoomSwitch.addTarget(self, action: #selector(toggleZoom), for: .valueChanged)
    zoomSwitch.isOn = true

    [mapView, holder, zoomLabel, zoomSwitch].forEach({
      $0.translatesAutoresizingMaskIntoConstraints = false
    })
    NSLayoutConstraint.activate([
      mapView.leftAnchor.constraint(equalTo: view.leftAnchor),
      mapView.rightAnchor.constraint(equalTo: view.rightAnchor),
      mapView.topAnchor.constraint(equalTo: view.topAnchor),
      mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
      holder.heightAnchor.constraint(equalToConstant: holderHeight),
      holder.centerXAnchor.constraint(equalTo: view.centerXAnchor),
      holder.widthAnchor.constraint(equalTo: view.widthAnchor),
      zoomLabel.leftAnchor.constraint(equalTo: holder.leftAnchor, constant: zoomLabelInset),
      zoomLabel.centerYAnchor.constraint(equalTo: holder.centerYAnchor),
      zoomSwitch.rightAnchor.constraint(equalTo: holder.rightAnchor, constant: -zoomLabelInset),
      zoomSwitch.centerYAnchor.constraint(
        equalTo: holder.centerYAnchor),
    ])
    NSLayoutConstraint.activate([
      holder.topAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.topAnchor)
    ])
  }

  @objc func toggleZoom() {
    mapView.settings.zoomGestures = zoomSwitch.isOn
  }

}
      

هدف-C

#import "GoogleMapsDemos/Samples/GestureControlViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation GestureControlViewController {
  GMSMapView *_mapView;
  UISwitch *_zoomSwitch;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-25.5605
                                                          longitude:133.605097
                                                               zoom:3];

  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  _mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
  _mapView.accessibilityIdentifier = @"gestureControlDemoMapView";

  self.view = [[UIView alloc] initWithFrame:CGRectZero];
  [self.view addSubview:_mapView];

  UIView *holder = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 0, 59)];
  holder.autoresizingMask =
      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin;
  holder.backgroundColor = [UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.8f];
  [self.view addSubview:holder];

  // Zoom label.
  UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(16, 16, 200, 29)];
  label.text = @"Zooming?";
  label.font = [UIFont boldSystemFontOfSize:18.0f];
  label.textAlignment = NSTextAlignmentLeft;
  label.backgroundColor = [UIColor clearColor];
  label.layer.shadowColor = [[UIColor whiteColor] CGColor];
  label.layer.shadowOffset = CGSizeMake(0.0f, 1.0f);
  label.layer.shadowOpacity = 1.0f;
  label.layer.shadowRadius = 0.0f;
  [holder addSubview:label];

  // Control zooming.
  _zoomSwitch = [[UISwitch alloc] initWithFrame:CGRectMake(-90, 16, 0, 0)];
  _zoomSwitch.autoresizingMask = UIViewAutoresizingFlexibleLeftMargin;
  [_zoomSwitch addTarget:self
                  action:@selector(didChangeZoomSwitch)
        forControlEvents:UIControlEventValueChanged];
  _zoomSwitch.on = YES;
  [holder addSubview:_zoomSwitch];
}

- (void)didChangeZoomSwitch {
  _mapView.settings.zoomGestures = _zoomSwitch.isOn;
}

@end
      

برنامه نمونه کامل را به صورت محلی اجرا کنید

برنامه نمونه Maps SDK برای iOS به عنوان یک بایگانی دانلود از GitHub در دسترس است. این مراحل را دنبال کنید تا برنامه نمونه Maps SDK برای iOS را نصب و امتحان کنید.

  1. git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git را اجرا کنید تا مخزن نمونه ها را در یک فهرست محلی کلون کنید.
  2. یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید، و به فهرست راهنمای GoogleMaps بروید:

    سویفت

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
    pod install
    open GoogleMapsSwiftDemos.xcworkspace

    هدف-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    pod install
    open GoogleMapsDemos.xcworkspace
  3. در Xcode، دکمه کامپایل را فشار دهید تا برنامه با طرح فعلی ساخته شود . بیلد یک خطایی ایجاد می‌کند که از شما می‌خواهد کلید API خود را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  4. اگر هنوز کلید API ندارید، دستورالعمل‌ها را برای راه‌اندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، می توانید کلید را به شناسه بسته نرم افزاری نمونه محدود کنید تا مطمئن شوید که فقط برنامه شما می تواند از کلید استفاده کند. شناسه بسته پیش‌فرض برنامه نمونه‌های SDK com.example.GoogleMapsDemos است.
  5. فایل SDKConstants.swift را برای Swift یا SDKDemoAPIKey.h برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابت apiKey یا kAPIKey قرار دهید. به عنوان مثال:

    سویفت

    static let apiKey = "YOUR_API_KEY"

    هدف-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:

    سویفت

    #error (Register for API Key and insert here. Then delete this line.)

    هدف-C

    #error Register for API Key and insert here.
  7. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود که فهرستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
  8. یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
  9. اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.
،
نقشه تنها زمانی به حرکات زوم پاسخ می دهد که سوئیچ روشن باشد.

شروع کنید

قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای iOS را ببینید.

کد را مشاهده کنید

سویفت

import GoogleMaps
import UIKit

class GestureControlViewController: UIViewController {
  private let holderHeight: CGFloat = 60
  private let zoomLabelInset: CGFloat = 16

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -25.5605, longitude: 133.605097, zoom: 3)
    return GMSMapView(frame: .zero, camera: camera)
  }()
  private lazy var zoomSwitch: UISwitch = UISwitch(frame: .zero)

  override func viewDidLoad() {
    super.viewDidLoad()

    view.addSubview(mapView)

    let holder = UIView(frame: .zero)
    holder.backgroundColor = UIColor(white: 1, alpha: 0.8)
    view.addSubview(holder)

    let zoomLabel = UILabel(frame: .zero)
    zoomLabel.text = "Zoom gestures"
    zoomLabel.font = .boldSystemFont(ofSize: 18)
    holder.addSubview(zoomLabel)

    // Control zooming.
    holder.addSubview(zoomSwitch)
    zoomSwitch.addTarget(self, action: #selector(toggleZoom), for: .valueChanged)
    zoomSwitch.isOn = true

    [mapView, holder, zoomLabel, zoomSwitch].forEach({
      $0.translatesAutoresizingMaskIntoConstraints = false
    })
    NSLayoutConstraint.activate([
      mapView.leftAnchor.constraint(equalTo: view.leftAnchor),
      mapView.rightAnchor.constraint(equalTo: view.rightAnchor),
      mapView.topAnchor.constraint(equalTo: view.topAnchor),
      mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
      holder.heightAnchor.constraint(equalToConstant: holderHeight),
      holder.centerXAnchor.constraint(equalTo: view.centerXAnchor),
      holder.widthAnchor.constraint(equalTo: view.widthAnchor),
      zoomLabel.leftAnchor.constraint(equalTo: holder.leftAnchor, constant: zoomLabelInset),
      zoomLabel.centerYAnchor.constraint(equalTo: holder.centerYAnchor),
      zoomSwitch.rightAnchor.constraint(equalTo: holder.rightAnchor, constant: -zoomLabelInset),
      zoomSwitch.centerYAnchor.constraint(
        equalTo: holder.centerYAnchor),
    ])
    NSLayoutConstraint.activate([
      holder.topAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.topAnchor)
    ])
  }

  @objc func toggleZoom() {
    mapView.settings.zoomGestures = zoomSwitch.isOn
  }

}
      

هدف-C

#import "GoogleMapsDemos/Samples/GestureControlViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation GestureControlViewController {
  GMSMapView *_mapView;
  UISwitch *_zoomSwitch;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-25.5605
                                                          longitude:133.605097
                                                               zoom:3];

  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  _mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
  _mapView.accessibilityIdentifier = @"gestureControlDemoMapView";

  self.view = [[UIView alloc] initWithFrame:CGRectZero];
  [self.view addSubview:_mapView];

  UIView *holder = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 0, 59)];
  holder.autoresizingMask =
      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin;
  holder.backgroundColor = [UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.8f];
  [self.view addSubview:holder];

  // Zoom label.
  UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(16, 16, 200, 29)];
  label.text = @"Zooming?";
  label.font = [UIFont boldSystemFontOfSize:18.0f];
  label.textAlignment = NSTextAlignmentLeft;
  label.backgroundColor = [UIColor clearColor];
  label.layer.shadowColor = [[UIColor whiteColor] CGColor];
  label.layer.shadowOffset = CGSizeMake(0.0f, 1.0f);
  label.layer.shadowOpacity = 1.0f;
  label.layer.shadowRadius = 0.0f;
  [holder addSubview:label];

  // Control zooming.
  _zoomSwitch = [[UISwitch alloc] initWithFrame:CGRectMake(-90, 16, 0, 0)];
  _zoomSwitch.autoresizingMask = UIViewAutoresizingFlexibleLeftMargin;
  [_zoomSwitch addTarget:self
                  action:@selector(didChangeZoomSwitch)
        forControlEvents:UIControlEventValueChanged];
  _zoomSwitch.on = YES;
  [holder addSubview:_zoomSwitch];
}

- (void)didChangeZoomSwitch {
  _mapView.settings.zoomGestures = _zoomSwitch.isOn;
}

@end
      

برنامه نمونه کامل را به صورت محلی اجرا کنید

برنامه نمونه Maps SDK برای iOS به عنوان یک بایگانی دانلود از GitHub در دسترس است. این مراحل را دنبال کنید تا برنامه نمونه Maps SDK برای iOS را نصب و امتحان کنید.

  1. git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git را اجرا کنید تا مخزن نمونه ها را در یک فهرست محلی کلون کنید.
  2. یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید، و به فهرست راهنمای GoogleMaps بروید:

    سویفت

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
    pod install
    open GoogleMapsSwiftDemos.xcworkspace

    هدف-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    pod install
    open GoogleMapsDemos.xcworkspace
  3. در Xcode، دکمه کامپایل را فشار دهید تا برنامه با طرح فعلی ساخته شود . بیلد یک خطایی ایجاد می‌کند که از شما می‌خواهد کلید API خود را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  4. اگر هنوز کلید API ندارید، دستورالعمل‌ها را برای راه‌اندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، می توانید کلید را به شناسه بسته نرم افزاری نمونه محدود کنید تا مطمئن شوید که فقط برنامه شما می تواند از کلید استفاده کند. شناسه بسته پیش‌فرض برنامه نمونه‌های SDK com.example.GoogleMapsDemos است.
  5. فایل SDKConstants.swift را برای Swift یا SDKDemoAPIKey.h برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابت apiKey یا kAPIKey قرار دهید. به عنوان مثال:

    سویفت

    static let apiKey = "YOUR_API_KEY"

    هدف-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:

    سویفت

    #error (Register for API Key and insert here. Then delete this line.)

    هدف-C

    #error Register for API Key and insert here.
  7. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود که فهرستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
  8. یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
  9. اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.
،
نقشه تنها زمانی به حرکات زوم پاسخ می دهد که سوئیچ روشن باشد.

شروع کنید

قبل از اینکه بتوانید کد نمونه را امتحان کنید، باید محیط توسعه خود را پیکربندی کنید. برای اطلاعات بیشتر، Maps SDK برای نمونه کدهای iOS را ببینید.

کد را مشاهده کنید

سویفت

import GoogleMaps
import UIKit

class GestureControlViewController: UIViewController {
  private let holderHeight: CGFloat = 60
  private let zoomLabelInset: CGFloat = 16

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -25.5605, longitude: 133.605097, zoom: 3)
    return GMSMapView(frame: .zero, camera: camera)
  }()
  private lazy var zoomSwitch: UISwitch = UISwitch(frame: .zero)

  override func viewDidLoad() {
    super.viewDidLoad()

    view.addSubview(mapView)

    let holder = UIView(frame: .zero)
    holder.backgroundColor = UIColor(white: 1, alpha: 0.8)
    view.addSubview(holder)

    let zoomLabel = UILabel(frame: .zero)
    zoomLabel.text = "Zoom gestures"
    zoomLabel.font = .boldSystemFont(ofSize: 18)
    holder.addSubview(zoomLabel)

    // Control zooming.
    holder.addSubview(zoomSwitch)
    zoomSwitch.addTarget(self, action: #selector(toggleZoom), for: .valueChanged)
    zoomSwitch.isOn = true

    [mapView, holder, zoomLabel, zoomSwitch].forEach({
      $0.translatesAutoresizingMaskIntoConstraints = false
    })
    NSLayoutConstraint.activate([
      mapView.leftAnchor.constraint(equalTo: view.leftAnchor),
      mapView.rightAnchor.constraint(equalTo: view.rightAnchor),
      mapView.topAnchor.constraint(equalTo: view.topAnchor),
      mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
      holder.heightAnchor.constraint(equalToConstant: holderHeight),
      holder.centerXAnchor.constraint(equalTo: view.centerXAnchor),
      holder.widthAnchor.constraint(equalTo: view.widthAnchor),
      zoomLabel.leftAnchor.constraint(equalTo: holder.leftAnchor, constant: zoomLabelInset),
      zoomLabel.centerYAnchor.constraint(equalTo: holder.centerYAnchor),
      zoomSwitch.rightAnchor.constraint(equalTo: holder.rightAnchor, constant: -zoomLabelInset),
      zoomSwitch.centerYAnchor.constraint(
        equalTo: holder.centerYAnchor),
    ])
    NSLayoutConstraint.activate([
      holder.topAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.topAnchor)
    ])
  }

  @objc func toggleZoom() {
    mapView.settings.zoomGestures = zoomSwitch.isOn
  }

}
      

هدف-C

#import "GoogleMapsDemos/Samples/GestureControlViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation GestureControlViewController {
  GMSMapView *_mapView;
  UISwitch *_zoomSwitch;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-25.5605
                                                          longitude:133.605097
                                                               zoom:3];

  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  _mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
  _mapView.accessibilityIdentifier = @"gestureControlDemoMapView";

  self.view = [[UIView alloc] initWithFrame:CGRectZero];
  [self.view addSubview:_mapView];

  UIView *holder = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 0, 59)];
  holder.autoresizingMask =
      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin;
  holder.backgroundColor = [UIColor colorWithRed:1.0 green:1.0 blue:1.0 alpha:0.8f];
  [self.view addSubview:holder];

  // Zoom label.
  UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(16, 16, 200, 29)];
  label.text = @"Zooming?";
  label.font = [UIFont boldSystemFontOfSize:18.0f];
  label.textAlignment = NSTextAlignmentLeft;
  label.backgroundColor = [UIColor clearColor];
  label.layer.shadowColor = [[UIColor whiteColor] CGColor];
  label.layer.shadowOffset = CGSizeMake(0.0f, 1.0f);
  label.layer.shadowOpacity = 1.0f;
  label.layer.shadowRadius = 0.0f;
  [holder addSubview:label];

  // Control zooming.
  _zoomSwitch = [[UISwitch alloc] initWithFrame:CGRectMake(-90, 16, 0, 0)];
  _zoomSwitch.autoresizingMask = UIViewAutoresizingFlexibleLeftMargin;
  [_zoomSwitch addTarget:self
                  action:@selector(didChangeZoomSwitch)
        forControlEvents:UIControlEventValueChanged];
  _zoomSwitch.on = YES;
  [holder addSubview:_zoomSwitch];
}

- (void)didChangeZoomSwitch {
  _mapView.settings.zoomGestures = _zoomSwitch.isOn;
}

@end
      

برنامه نمونه کامل را به صورت محلی اجرا کنید

برنامه نمونه Maps SDK برای iOS به عنوان یک بایگانی دانلود از GitHub در دسترس است. این مراحل را دنبال کنید تا برنامه نمونه Maps SDK برای iOS را نصب و امتحان کنید.

  1. git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git را اجرا کنید تا مخزن نمونه ها را در یک فهرست محلی کلون کنید.
  2. یک پنجره ترمینال را باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید، و به فهرست راهنمای GoogleMaps بروید:

    سویفت

    cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
    pod install
    open GoogleMapsSwiftDemos.xcworkspace

    هدف-C

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    pod install
    open GoogleMapsDemos.xcworkspace
  3. در Xcode، دکمه کامپایل را فشار دهید تا برنامه با طرح فعلی ساخته شود . بیلد یک خطایی ایجاد می‌کند که از شما می‌خواهد کلید API خود را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  4. اگر هنوز کلید API ندارید، دستورالعمل‌ها را برای راه‌اندازی یک پروژه در Google Cloud Console و دریافت یک کلید API دنبال کنید. هنگام پیکربندی کلید در Cloud Console، می توانید کلید را به شناسه بسته نرم افزاری نمونه محدود کنید تا مطمئن شوید که فقط برنامه شما می تواند از کلید استفاده کند. شناسه بسته پیش‌فرض برنامه نمونه‌های SDK com.example.GoogleMapsDemos است.
  5. فایل SDKConstants.swift را برای Swift یا SDKDemoAPIKey.h برای Objective-C ویرایش کنید و کلید API خود را در تعریف ثابت apiKey یا kAPIKey قرار دهید. به عنوان مثال:

    سویفت

    static let apiKey = "YOUR_API_KEY"

    هدف-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف شده توسط کاربر استفاده می شود:

    سویفت

    #error (Register for API Key and insert here. Then delete this line.)

    هدف-C

    #error Register for API Key and insert here.
  7. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود که فهرستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
  8. یکی از گزینه های نمایش داده شده را انتخاب کنید تا با یکی از ویژگی های Maps SDK برای iOS آزمایش کنید.
  9. اگر از شما خواسته شد به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی شما را بدهید، Allow را انتخاب کنید.