ניהול אירועי סמן

בדוגמה הזו מוצגת מפה עם שני סמנים. כשמקישים על סמן, המצלמה מבצעת זום וסיבוב כדי להתמקד בסמן שנבחר.

שנתחיל?

כדי לנסות את קוד הדוגמה, צריך להגדיר את סביבת הפיתוח. מידע נוסף זמין במאמר דוגמאות קוד ל-SDK של מפות ל-iOS.

הצגת הקוד

Swift

import GoogleMaps
import UIKit

final class MarkerEventsViewController: UIViewController {

  private lazy var mapView: GMSMapView = {
    let camera = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    return GMSMapView(frame: .zero, camera: camera)
  }()

  private var melbourneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -37.81969, longitude: 144.966085))

  override func loadView() {
    let sydneyMarker = GMSMarker(
      position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))
    sydneyMarker.map = mapView
    melbourneMarker.map = mapView
    mapView.delegate = self
    view = mapView
  }
}

extension MarkerEventsViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, markerInfoWindow marker: GMSMarker) -> UIView? {
    if marker == melbourneMarker {
      return UIImageView(image: UIImage(named: "Icon"))
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, didTap marker: GMSMarker) -> Bool {
    // Animate to the marker
    CATransaction.begin()
    CATransaction.setAnimationDuration(3)
    let camera = GMSCameraPosition(target: marker.position, zoom: 8, bearing: 50, viewingAngle: 60)
    mapView.animate(to: camera)
    CATransaction.commit()

    // Melbourne marker has a InfoWindow so return false to allow markerInfoWindow to
    // fire. Also check that the marker isn't already selected so that the InfoWindow
    // doesn't close.
    if marker == melbourneMarker && mapView.selectedMarker != melbourneMarker {
      return false
    }
    return true
  }
}
MarkerEventsViewController.swift
      

Objective-C

#import "GoogleMapsDemos/Samples/MarkerEventsViewController.h"

#import <QuartzCore/QuartzCore.h>

#import <GoogleMaps/GoogleMaps.h>

@implementation MarkerEventsViewController {
  GMSMapView *_mapView;
  GMSMarker *_melbourneMarker;
  BOOL _rotating;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-37.81969
                                                          longitude:144.966085
                                                               zoom:4];
  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

  GMSMarker *sydneyMarker = [[GMSMarker alloc] init];
  sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  sydneyMarker.map = _mapView;

  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = _mapView;

  _mapView.delegate = self;
  self.view = _mapView;
}

#pragma mark - GMSMapViewDelegate

- (UIView *)mapView:(GMSMapView *)mapView markerInfoWindow:(GMSMarker *)marker {
  if (marker == _melbourneMarker) {
    return [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"Icon"]];
  }

  return nil;
}

- (BOOL)mapView:(GMSMapView *)mapView didTapMarker:(GMSMarker *)marker {
  GMSCameraPosition *camera = [[GMSCameraPosition alloc] initWithTarget:marker.position
                                                                   zoom:8
                                                                bearing:50
                                                           viewingAngle:60];
  // Animate to the marker
  [CATransaction begin];
  [CATransaction setAnimationDuration:3.f];  // 3 second animation
  [CATransaction setCompletionBlock:^{
    if (_rotating) {  // Animation was interrupted by orientation change.
      [CATransaction
          setDisableActions:true];  // Disable animation to avoid interruption from rotation.
      [_mapView animateToCameraPosition:camera];
    }
  }];

  [mapView animateToCameraPosition:camera];
  [CATransaction commit];

  // Melbourne marker has a InfoWindow so return NO to allow markerInfoWindow to fire. Also check
  // that the marker isn't already selected so that the InfoWindow doesn't close.
  if (marker == _melbourneMarker && mapView.selectedMarker != _melbourneMarker) {
    return NO;
  }

  // The Tap has been handled so return YES
  return YES;
}

- (void)viewWillTransitionToSize:(CGSize)size
       withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
  _rotating = true;
  [coordinator
      animateAlongsideTransition:nil
                      completion:^(
                          id<UIViewControllerTransitionCoordinatorContext> _Nonnull context) {
                        _rotating = false;
                      }];
  [super viewWillTransitionToSize:size withTransitionCoordinator:coordinator];
}

@end
MarkerEventsViewController.m
      

הרצת אפליקציית הדוגמה המלאה באופן מקומי

אפליקציית הדוגמה של Maps SDK ל-iOS זמינה כארכיון להורדה ב-GitHub. כדי להתקין את אפליקציית הדוגמה של Maps SDK for iOS ולנסות אותה, פועלים לפי השלבים הבאים.

חשוב: צריך להסיר את כל התלויות הקיימות שנוספו באמצעות CocoaPods או באופן ידני. הוראות מפורטות מופיעות בשלב 2 של הגדרת פרויקט Xcode.

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

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. בפרויקט Xcode, עוברים אל File (קובץ) > Add Package Dependencies (הוספת תלות בחבילה). מזינים את כתובת ה-URL https://github.com/googlemaps/ios-maps-sdk, לוחצים על Enter כדי למשוך את החבילה ולוחצים על הוספת חבילה.
4. ב-Xcode, לוחצים על לחצן ההידור כדי לבנות את האפליקציה עם הסכימה הנוכחית. תהליך הבנייה יפיק שגיאה, שתבקש מכם להזין את מפתח ה-API בקובץ SDKConstants.swift עבור Swift או בקובץ SDKDemoAPIKey.h עבור Objective-C.
5. מקבלים מפתח API מהפרויקט שבו מופעל Maps SDK ל-iOS.
6. עורכים את הקובץ SDKConstants.swift ב-Swift או את הקובץ SDKDemoAPIKey.h ב-Objective-C ומדביקים את מפתח ה-API בהגדרה של הקבוע apiKey או kAPIKey. לדוגמה:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   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.)

   Objective-C

   #error Register for API Key and insert here.

8. מבצעים Build ומריצים את הפרויקט. חלון הסימולטור של iOS מופיע עם רשימה של הדגמות של Maps SDK.
9. בוחרים באחת מהאפשרויות שמוצגות כדי להתנסות בתכונה של Maps SDK ל-iOS.
10. אם מופיעה בקשה לאפשר ל-GoogleMapsDemos לגשת למיקום שלכם, בוחרים באפשרות אישור.