ترسیم چندخطی روی نقشه

نقشه‌ای از جنوب اقیانوس آرام را با پویانمایی چندخطی‌های قرمز و سبز که موقعیت و اندازه آن‌ها تغییر می‌کند نشان می‌دهد.

شروع کنید

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

مشاهده کد

Swift

import GoogleMaps
import UIKit

final class PolylinesViewController: UIViewController {
  private lazy var styles: [GMSStrokeStyle] = {
    let greenStyle = GMSStrokeStyle.gradient(from: .green, to: UIColor.green.withAlphaComponent(0))
    let redStyle = GMSStrokeStyle.gradient(from: UIColor.red.withAlphaComponent(0), to: .red)
    return [greenStyle, redStyle, GMSStrokeStyle.solidColor(UIColor(white: 0, alpha: 0))]
  }()
  private var pathLength: Double = 0
  private var pos: Double = 0
  private var polylines: [GMSPolyline] = []

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

  override func loadView() {
    view = mapView
    mapView.accessibilityElementsHidden = true
  }

  override func viewDidLoad() {
    super.viewDidLoad()

    var path = GMSMutablePath()
    path.addLatitude(-33.866901, longitude: 151.195988)
    path.addLatitude(-18, longitude: 179)
    path.addLatitude(21.291982, longitude: -157.821856)
    path.addLatitude(37.423802, longitude: -122.091859)
    path.addLatitude(-12, longitude: -77)
    path.addLatitude(-33.866901, longitude: 151.195988)
    path = path.pathOffset(byLatitude: -30, longitude: 0)
    pathLength = path.length(of: .geodesic) / 21
    for i in 0..<30 {
      let polyline = GMSPolyline(path: path.pathOffset(byLatitude: Double(i) * 1.5, longitude: 0))
      polyline.strokeWidth = 8
      polyline.geodesic = true
      polyline.map = mapView
      polylines.append(polyline)
    }
    animatePath()
  }

  // Updates the path style every 0.1 seconds.
  private func animatePath() {
    polylines.forEach {
      if let path = $0.path {
        $0.spans = GMSStyleSpansOffset(path, styles, [NSNumber(value: pathLength)], .geodesic, pos)
      }
    }
    pos -= 50000

    DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + 0.1) {
      self.animatePath()
    }
  }
}
      

آبجکتیو-سی

#import "GoogleMapsDemos/Samples/PolylinesViewController.h"

#import <GoogleMaps/GoogleMaps.h>

static CLLocationCoordinate2D kSydneyAustralia = {-33.866901, 151.195988};
static CLLocationCoordinate2D kHawaiiUSA = {21.291982, -157.821856};
static CLLocationCoordinate2D kFiji = {-18, 179};
static CLLocationCoordinate2D kMountainViewUSA = {37.423802, -122.091859};
static CLLocationCoordinate2D kLimaPeru = {-12, -77};
static bool kAnimate = true;

@implementation PolylinesViewController {
  NSArray *_styles;
  NSArray *_lengths;
  NSArray *_polys;
  double _pos, _step;
  GMSMapView *_mapView;
}

- (void)tick {
  for (GMSPolyline *poly in _polys) {
    poly.spans = GMSStyleSpansOffset(poly.path, _styles, _lengths, kGMSLengthGeodesic, _pos);
  }
  _pos -= _step;
  if (kAnimate) {
    __weak id weakSelf = self;
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, NSEC_PER_SEC / 10), dispatch_get_main_queue(),
                   ^{
                     [weakSelf tick];
                   });
  }
}

- (void)initLines {
  if (!_polys) {
    NSMutableArray *polys = [NSMutableArray array];
    GMSMutablePath *path = [GMSMutablePath path];
    [path addCoordinate:kSydneyAustralia];
    [path addCoordinate:kFiji];
    [path addCoordinate:kHawaiiUSA];
    [path addCoordinate:kMountainViewUSA];
    [path addCoordinate:kLimaPeru];
    [path addCoordinate:kSydneyAustralia];
    path = [path pathOffsetByLatitude:-30 longitude:0];
    _lengths = @[ @([path lengthOfKind:kGMSLengthGeodesic] / 21) ];
    for (int i = 0; i < 30; ++i) {
      GMSPolyline *poly = [[GMSPolyline alloc] init];
      poly.path = [path pathOffsetByLatitude:(i * 1.5) longitude:0];
      poly.strokeWidth = 8;
      poly.geodesic = YES;
      poly.map = _mapView;
      [polys addObject:poly];
    }
    _polys = polys;
  }
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-30 longitude:-175 zoom:3];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.accessibilityElementsHidden = YES;
  self.view = mapView;
  _mapView = mapView;

  CGFloat alpha = 1;
  UIColor *green = [UIColor colorWithRed:0 green:1 blue:0 alpha:alpha];
  UIColor *greenTransp = [UIColor colorWithRed:0 green:1 blue:0 alpha:0];
  UIColor *red = [UIColor colorWithRed:1 green:0 blue:0 alpha:alpha];
  UIColor *redTransp = [UIColor colorWithRed:1 green:0 blue:0 alpha:0];
  GMSStrokeStyle *grad1 = [GMSStrokeStyle gradientFromColor:green toColor:greenTransp];
  GMSStrokeStyle *grad2 = [GMSStrokeStyle gradientFromColor:redTransp toColor:red];
  _styles = @[
    grad1,
    grad2,
    [GMSStrokeStyle solidColor:[UIColor colorWithWhite:0 alpha:0]],
  ];
  _step = 50000;
  [self initLines];
  [self tick];
}

@end
      

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

برنامه نمونه «کیت توسعه نرم‌افزار Google Maps برای iOS» به‌صورت بایگانی بارگیری در GitHub دردسترس است. برای نصب و امتحان کردن برنامه نمونه «کیت توسعه نرم‌افزار Google Maps برای iOS»، این مراحل را دنبال کنید.

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

    Swift

    cd maps-sdk-for-ios-samples/GoogleMaps-Swift
    open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

    آبجکتیو-سی

    cd maps-sdk-for-ios-samples-main/GoogleMaps
    open GoogleMapsDemos.xcodeproj
  3. در پروژه Xcode، به File (فایل) > Add Package Dependencies (افزودن وابستگی‌های بسته) بروید. https://github.com/googlemaps/ios-maps-sdk را به‌عنوان نشانی وب وارد کنید، کلید ورود را فشار دهید تا بسته وارد شود، و روی افزودن بسته کلیک کنید.
  4. در Xcode، دکمه کامپایل را فشار دهید تا برنامه را با طرح فعلی بسازید. ساخت با خطا مواجه می‌شود و از شما می‌خواهد کلید میانای برنامه‌سازی کاربردی را در فایل SDKConstants.swift برای Swift یا فایل SDKDemoAPIKey.h برای Objective-C وارد کنید.
  5. کلید میانای API را از پروژه‌تان با کیت توسعه نرم‌افزار Google Maps برای iOS فعال‌شده دریافت کنید.
  6. فایل SDKConstants.swift را برای Swift یا فایل SDKDemoAPIKey.h را برای Objective-C ویرایش کنید و کلید میانای API خود را در تعریف ثابت apiKey یا kAPIKey جای‌گذاری کنید. برای مثال:

    Swift

    static let apiKey = "YOUR_API_KEY"

    آبجکتیو-سی

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

    Swift

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

    آبجکتیو-سی

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