نمایش پنجره اطلاعات برای نشانگر

این مثال نشانگرهایی را در سه شهر بزرگ استرالیا نمایش می‌دهد. وقتی کاربر روی یک نشانگر ضربه می‌زند، یک پنجره اطلاعات ظاهر می‌شود.

شروع کنید

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

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

سویفت

import GoogleMaps
import UIKit

final class MarkerInfoWindowViewController: UIViewController {

  private let sydneyMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))

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

  private let brisbaneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -27.4710107, longitude: 153.0234489))

  private lazy var contentView: UIImageView = {
    return UIImageView(image: UIImage(named: "aeroplane"))
  }()

  override func loadView() {
    let cameraPosition = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    let mapView = GMSMapView(frame: .zero, camera: cameraPosition)
    mapView.delegate = self
    view = mapView

    sydneyMarker.title = "Sydney"
    sydneyMarker.snippet = "Population: 4,605,992"
    sydneyMarker.map = mapView

    melbourneMarker.title = "Melbourne"
    melbourneMarker.snippet = "Population: 4,169,103"
    melbourneMarker.map = mapView

    brisbaneMarker.title = "Brisbane"
    brisbaneMarker.snippet = "Population: 2,189,878"
    brisbaneMarker.map = mapView
  }
}

extension MarkerInfoWindowViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, markerInfoWindow marker: GMSMarker) -> UIView? {
    if marker == sydneyMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, markerInfoContents marker: GMSMarker) -> UIView? {
    if marker == brisbaneMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, didCloseInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") closed.")
  }

  func mapView(_ mapView: GMSMapView, didLongPressInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") long pressed.")
  }
}

extension UIViewController {
  func showToast(message: String) {
    let toast = UIAlertController(title: nil, message: message, preferredStyle: .alert)
    present(
      toast, animated: true,
      completion: {
        DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + .seconds(2)) {
          toast.dismiss(animated: true)
        }
      })
  }
}
MarkerInfoWindowViewController.swift
      

هدف-سی

#import "GoogleMapsDemos/Samples/MarkerInfoWindowViewController.h"

#import "GoogleMapsDemos/UIViewController+GMSToastMessages.h"
#import <GoogleMaps/GoogleMaps.h>

@interface MarkerInfoWindowViewController () <GMSMapViewDelegate>

@end

@implementation MarkerInfoWindowViewController {
  GMSMarker *_sydneyMarker;
  GMSMarker *_melbourneMarker;
  GMSMarker *_brisbaneMarker;
  UIView *_contentView;
}

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

  _sydneyMarker = [[GMSMarker alloc] init];
  _sydneyMarker.title = @"Sydney";
  _sydneyMarker.snippet = @"Population: 4,605,992";
  _sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  _sydneyMarker.map = mapView;
  NSLog(@"sydneyMarker: %@", _sydneyMarker);

  _melbourneMarker.map = nil;
  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.title = @"Melbourne";
  _melbourneMarker.snippet = @"Population: 4,169,103";
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = mapView;
  NSLog(@"melbourneMarker: %@", _melbourneMarker);

  _brisbaneMarker.map = nil;
  _brisbaneMarker = [[GMSMarker alloc] init];
  _brisbaneMarker.title = @"Brisbane";
  _brisbaneMarker.snippet = @"Population: 2,189,878";
  _brisbaneMarker.position = CLLocationCoordinate2DMake(-27.4710107, 153.0234489);
  _brisbaneMarker.map = mapView;
  NSLog(@"brisbaneMarker: %@", _brisbaneMarker);

  _contentView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"aeroplane"]];

  mapView.delegate = self;
  self.view = mapView;
}

#pragma mark GMSMapViewDelegate

- (UIView *)mapView:(GMSMapView *)mapView markerInfoWindow:(GMSMarker *)marker {
  if (marker == _sydneyMarker) {
    return _contentView;
  }
  return nil;
}

- (UIView *)mapView:(GMSMapView *)mapView markerInfoContents:(GMSMarker *)marker {
  if (marker == _brisbaneMarker) {
    return _contentView;
  }
  return nil;
}

- (void)mapView:(GMSMapView *)mapView didCloseInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ closed.", marker.title];
  [self gms_showToastWithMessage:message];
}

- (void)mapView:(GMSMapView *)mapView didLongPressInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ long pressed.", marker.title];
  [self gms_showToastWithMessage:message];
}

@end
MarkerInfoWindowViewController.m
      

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

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

مهم: شما باید هرگونه وابستگی موجود اضافه شده با استفاده از CocoaPods یا به صورت دستی را حذف کنید. برای دستورالعمل‌ها به مرحله 2 از راه‌اندازی یک پروژه Xcode مراجعه کنید.

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

2. یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید و به دایرکتوری GoogleMaps بروید:

   سویفت

   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 به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
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 قرار دهید. برای مثال:

   سویفت

   static let apiKey = "YOUR_API_KEY"

   هدف-سی

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف‌شده توسط کاربر استفاده می‌شود:

   سویفت

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

   هدف-سی

   #error Register for API Key and insert here.

8. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود و لیستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
9. برای آزمایش یکی از ویژگی‌های Maps SDK برای iOS، یکی از گزینه‌های نمایش داده شده را انتخاب کنید.
10. اگر از شما خواسته شد که به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی خود را بدهید، Allow را انتخاب کنید.

،

این مثال نشانگرهایی را در سه شهر بزرگ استرالیا نمایش می‌دهد. وقتی کاربر روی یک نشانگر ضربه می‌زند، یک پنجره اطلاعات ظاهر می‌شود.

شروع کنید

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

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

سویفت

import GoogleMaps
import UIKit

final class MarkerInfoWindowViewController: UIViewController {

  private let sydneyMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))

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

  private let brisbaneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -27.4710107, longitude: 153.0234489))

  private lazy var contentView: UIImageView = {
    return UIImageView(image: UIImage(named: "aeroplane"))
  }()

  override func loadView() {
    let cameraPosition = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    let mapView = GMSMapView(frame: .zero, camera: cameraPosition)
    mapView.delegate = self
    view = mapView

    sydneyMarker.title = "Sydney"
    sydneyMarker.snippet = "Population: 4,605,992"
    sydneyMarker.map = mapView

    melbourneMarker.title = "Melbourne"
    melbourneMarker.snippet = "Population: 4,169,103"
    melbourneMarker.map = mapView

    brisbaneMarker.title = "Brisbane"
    brisbaneMarker.snippet = "Population: 2,189,878"
    brisbaneMarker.map = mapView
  }
}

extension MarkerInfoWindowViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, markerInfoWindow marker: GMSMarker) -> UIView? {
    if marker == sydneyMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, markerInfoContents marker: GMSMarker) -> UIView? {
    if marker == brisbaneMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, didCloseInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") closed.")
  }

  func mapView(_ mapView: GMSMapView, didLongPressInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") long pressed.")
  }
}

extension UIViewController {
  func showToast(message: String) {
    let toast = UIAlertController(title: nil, message: message, preferredStyle: .alert)
    present(
      toast, animated: true,
      completion: {
        DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + .seconds(2)) {
          toast.dismiss(animated: true)
        }
      })
  }
}
MarkerInfoWindowViewController.swift
      

هدف-سی

#import "GoogleMapsDemos/Samples/MarkerInfoWindowViewController.h"

#import "GoogleMapsDemos/UIViewController+GMSToastMessages.h"
#import <GoogleMaps/GoogleMaps.h>

@interface MarkerInfoWindowViewController () <GMSMapViewDelegate>

@end

@implementation MarkerInfoWindowViewController {
  GMSMarker *_sydneyMarker;
  GMSMarker *_melbourneMarker;
  GMSMarker *_brisbaneMarker;
  UIView *_contentView;
}

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

  _sydneyMarker = [[GMSMarker alloc] init];
  _sydneyMarker.title = @"Sydney";
  _sydneyMarker.snippet = @"Population: 4,605,992";
  _sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  _sydneyMarker.map = mapView;
  NSLog(@"sydneyMarker: %@", _sydneyMarker);

  _melbourneMarker.map = nil;
  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.title = @"Melbourne";
  _melbourneMarker.snippet = @"Population: 4,169,103";
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = mapView;
  NSLog(@"melbourneMarker: %@", _melbourneMarker);

  _brisbaneMarker.map = nil;
  _brisbaneMarker = [[GMSMarker alloc] init];
  _brisbaneMarker.title = @"Brisbane";
  _brisbaneMarker.snippet = @"Population: 2,189,878";
  _brisbaneMarker.position = CLLocationCoordinate2DMake(-27.4710107, 153.0234489);
  _brisbaneMarker.map = mapView;
  NSLog(@"brisbaneMarker: %@", _brisbaneMarker);

  _contentView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"aeroplane"]];

  mapView.delegate = self;
  self.view = mapView;
}

#pragma mark GMSMapViewDelegate

- (UIView *)mapView:(GMSMapView *)mapView markerInfoWindow:(GMSMarker *)marker {
  if (marker == _sydneyMarker) {
    return _contentView;
  }
  return nil;
}

- (UIView *)mapView:(GMSMapView *)mapView markerInfoContents:(GMSMarker *)marker {
  if (marker == _brisbaneMarker) {
    return _contentView;
  }
  return nil;
}

- (void)mapView:(GMSMapView *)mapView didCloseInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ closed.", marker.title];
  [self gms_showToastWithMessage:message];
}

- (void)mapView:(GMSMapView *)mapView didLongPressInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ long pressed.", marker.title];
  [self gms_showToastWithMessage:message];
}

@end
MarkerInfoWindowViewController.m
      

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

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

مهم: شما باید هرگونه وابستگی موجود اضافه شده با استفاده از CocoaPods یا به صورت دستی را حذف کنید. برای دستورالعمل‌ها به مرحله 2 از راه‌اندازی یک پروژه Xcode مراجعه کنید.

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

2. یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید و به دایرکتوری GoogleMaps بروید:

   سویفت

   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 به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
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 قرار دهید. برای مثال:

   سویفت

   static let apiKey = "YOUR_API_KEY"

   هدف-سی

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف‌شده توسط کاربر استفاده می‌شود:

   سویفت

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

   هدف-سی

   #error Register for API Key and insert here.

8. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود و لیستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
9. برای آزمایش یکی از ویژگی‌های Maps SDK برای iOS، یکی از گزینه‌های نمایش داده شده را انتخاب کنید.
10. اگر از شما خواسته شد که به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی خود را بدهید، Allow را انتخاب کنید.

،

این مثال نشانگرهایی را در سه شهر بزرگ استرالیا نمایش می‌دهد. وقتی کاربر روی یک نشانگر ضربه می‌زند، یک پنجره اطلاعات ظاهر می‌شود.

شروع کنید

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

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

سویفت

import GoogleMaps
import UIKit

final class MarkerInfoWindowViewController: UIViewController {

  private let sydneyMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))

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

  private let brisbaneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -27.4710107, longitude: 153.0234489))

  private lazy var contentView: UIImageView = {
    return UIImageView(image: UIImage(named: "aeroplane"))
  }()

  override func loadView() {
    let cameraPosition = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    let mapView = GMSMapView(frame: .zero, camera: cameraPosition)
    mapView.delegate = self
    view = mapView

    sydneyMarker.title = "Sydney"
    sydneyMarker.snippet = "Population: 4,605,992"
    sydneyMarker.map = mapView

    melbourneMarker.title = "Melbourne"
    melbourneMarker.snippet = "Population: 4,169,103"
    melbourneMarker.map = mapView

    brisbaneMarker.title = "Brisbane"
    brisbaneMarker.snippet = "Population: 2,189,878"
    brisbaneMarker.map = mapView
  }
}

extension MarkerInfoWindowViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, markerInfoWindow marker: GMSMarker) -> UIView? {
    if marker == sydneyMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, markerInfoContents marker: GMSMarker) -> UIView? {
    if marker == brisbaneMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, didCloseInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") closed.")
  }

  func mapView(_ mapView: GMSMapView, didLongPressInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") long pressed.")
  }
}

extension UIViewController {
  func showToast(message: String) {
    let toast = UIAlertController(title: nil, message: message, preferredStyle: .alert)
    present(
      toast, animated: true,
      completion: {
        DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + .seconds(2)) {
          toast.dismiss(animated: true)
        }
      })
  }
}
MarkerInfoWindowViewController.swift
      

هدف-سی

#import "GoogleMapsDemos/Samples/MarkerInfoWindowViewController.h"

#import "GoogleMapsDemos/UIViewController+GMSToastMessages.h"
#import <GoogleMaps/GoogleMaps.h>

@interface MarkerInfoWindowViewController () <GMSMapViewDelegate>

@end

@implementation MarkerInfoWindowViewController {
  GMSMarker *_sydneyMarker;
  GMSMarker *_melbourneMarker;
  GMSMarker *_brisbaneMarker;
  UIView *_contentView;
}

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

  _sydneyMarker = [[GMSMarker alloc] init];
  _sydneyMarker.title = @"Sydney";
  _sydneyMarker.snippet = @"Population: 4,605,992";
  _sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  _sydneyMarker.map = mapView;
  NSLog(@"sydneyMarker: %@", _sydneyMarker);

  _melbourneMarker.map = nil;
  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.title = @"Melbourne";
  _melbourneMarker.snippet = @"Population: 4,169,103";
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = mapView;
  NSLog(@"melbourneMarker: %@", _melbourneMarker);

  _brisbaneMarker.map = nil;
  _brisbaneMarker = [[GMSMarker alloc] init];
  _brisbaneMarker.title = @"Brisbane";
  _brisbaneMarker.snippet = @"Population: 2,189,878";
  _brisbaneMarker.position = CLLocationCoordinate2DMake(-27.4710107, 153.0234489);
  _brisbaneMarker.map = mapView;
  NSLog(@"brisbaneMarker: %@", _brisbaneMarker);

  _contentView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"aeroplane"]];

  mapView.delegate = self;
  self.view = mapView;
}

#pragma mark GMSMapViewDelegate

- (UIView *)mapView:(GMSMapView *)mapView markerInfoWindow:(GMSMarker *)marker {
  if (marker == _sydneyMarker) {
    return _contentView;
  }
  return nil;
}

- (UIView *)mapView:(GMSMapView *)mapView markerInfoContents:(GMSMarker *)marker {
  if (marker == _brisbaneMarker) {
    return _contentView;
  }
  return nil;
}

- (void)mapView:(GMSMapView *)mapView didCloseInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ closed.", marker.title];
  [self gms_showToastWithMessage:message];
}

- (void)mapView:(GMSMapView *)mapView didLongPressInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ long pressed.", marker.title];
  [self gms_showToastWithMessage:message];
}

@end
MarkerInfoWindowViewController.m
      

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

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

مهم: شما باید هرگونه وابستگی موجود اضافه شده با استفاده از CocoaPods یا به صورت دستی را حذف کنید. برای دستورالعمل‌ها به مرحله 2 از راه‌اندازی یک پروژه Xcode مراجعه کنید.

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

2. یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید و به دایرکتوری GoogleMaps بروید:

   سویفت

   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 به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
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 قرار دهید. برای مثال:

   سویفت

   static let apiKey = "YOUR_API_KEY"

   هدف-سی

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف‌شده توسط کاربر استفاده می‌شود:

   سویفت

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

   هدف-سی

   #error Register for API Key and insert here.

8. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود و لیستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
9. برای آزمایش یکی از ویژگی‌های Maps SDK برای iOS، یکی از گزینه‌های نمایش داده شده را انتخاب کنید.
10. اگر از شما خواسته شد که به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی خود را بدهید، Allow را انتخاب کنید.

،

این مثال نشانگرهایی را در سه شهر بزرگ استرالیا نمایش می‌دهد. وقتی کاربر روی یک نشانگر ضربه می‌زند، یک پنجره اطلاعات ظاهر می‌شود.

شروع کنید

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

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

سویفت

import GoogleMaps
import UIKit

final class MarkerInfoWindowViewController: UIViewController {

  private let sydneyMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -33.8683, longitude: 151.2086))

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

  private let brisbaneMarker = GMSMarker(
    position: CLLocationCoordinate2D(latitude: -27.4710107, longitude: 153.0234489))

  private lazy var contentView: UIImageView = {
    return UIImageView(image: UIImage(named: "aeroplane"))
  }()

  override func loadView() {
    let cameraPosition = GMSCameraPosition(latitude: -37.81969, longitude: 144.966085, zoom: 4)
    let mapView = GMSMapView(frame: .zero, camera: cameraPosition)
    mapView.delegate = self
    view = mapView

    sydneyMarker.title = "Sydney"
    sydneyMarker.snippet = "Population: 4,605,992"
    sydneyMarker.map = mapView

    melbourneMarker.title = "Melbourne"
    melbourneMarker.snippet = "Population: 4,169,103"
    melbourneMarker.map = mapView

    brisbaneMarker.title = "Brisbane"
    brisbaneMarker.snippet = "Population: 2,189,878"
    brisbaneMarker.map = mapView
  }
}

extension MarkerInfoWindowViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, markerInfoWindow marker: GMSMarker) -> UIView? {
    if marker == sydneyMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, markerInfoContents marker: GMSMarker) -> UIView? {
    if marker == brisbaneMarker {
      return contentView
    }
    return nil
  }

  func mapView(_ mapView: GMSMapView, didCloseInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") closed.")
  }

  func mapView(_ mapView: GMSMapView, didLongPressInfoWindowOf marker: GMSMarker) {
    showToast(message: "Info window for marker \(marker.title ?? "") long pressed.")
  }
}

extension UIViewController {
  func showToast(message: String) {
    let toast = UIAlertController(title: nil, message: message, preferredStyle: .alert)
    present(
      toast, animated: true,
      completion: {
        DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + .seconds(2)) {
          toast.dismiss(animated: true)
        }
      })
  }
}
MarkerInfoWindowViewController.swift
      

هدف-سی

#import "GoogleMapsDemos/Samples/MarkerInfoWindowViewController.h"

#import "GoogleMapsDemos/UIViewController+GMSToastMessages.h"
#import <GoogleMaps/GoogleMaps.h>

@interface MarkerInfoWindowViewController () <GMSMapViewDelegate>

@end

@implementation MarkerInfoWindowViewController {
  GMSMarker *_sydneyMarker;
  GMSMarker *_melbourneMarker;
  GMSMarker *_brisbaneMarker;
  UIView *_contentView;
}

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

  _sydneyMarker = [[GMSMarker alloc] init];
  _sydneyMarker.title = @"Sydney";
  _sydneyMarker.snippet = @"Population: 4,605,992";
  _sydneyMarker.position = CLLocationCoordinate2DMake(-33.8683, 151.2086);
  _sydneyMarker.map = mapView;
  NSLog(@"sydneyMarker: %@", _sydneyMarker);

  _melbourneMarker.map = nil;
  _melbourneMarker = [[GMSMarker alloc] init];
  _melbourneMarker.title = @"Melbourne";
  _melbourneMarker.snippet = @"Population: 4,169,103";
  _melbourneMarker.position = CLLocationCoordinate2DMake(-37.81969, 144.966085);
  _melbourneMarker.map = mapView;
  NSLog(@"melbourneMarker: %@", _melbourneMarker);

  _brisbaneMarker.map = nil;
  _brisbaneMarker = [[GMSMarker alloc] init];
  _brisbaneMarker.title = @"Brisbane";
  _brisbaneMarker.snippet = @"Population: 2,189,878";
  _brisbaneMarker.position = CLLocationCoordinate2DMake(-27.4710107, 153.0234489);
  _brisbaneMarker.map = mapView;
  NSLog(@"brisbaneMarker: %@", _brisbaneMarker);

  _contentView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"aeroplane"]];

  mapView.delegate = self;
  self.view = mapView;
}

#pragma mark GMSMapViewDelegate

- (UIView *)mapView:(GMSMapView *)mapView markerInfoWindow:(GMSMarker *)marker {
  if (marker == _sydneyMarker) {
    return _contentView;
  }
  return nil;
}

- (UIView *)mapView:(GMSMapView *)mapView markerInfoContents:(GMSMarker *)marker {
  if (marker == _brisbaneMarker) {
    return _contentView;
  }
  return nil;
}

- (void)mapView:(GMSMapView *)mapView didCloseInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ closed.", marker.title];
  [self gms_showToastWithMessage:message];
}

- (void)mapView:(GMSMapView *)mapView didLongPressInfoWindowOfMarker:(GMSMarker *)marker {
  NSString *message =
      [NSString stringWithFormat:@"Info window for marker %@ long pressed.", marker.title];
  [self gms_showToastWithMessage:message];
}

@end
MarkerInfoWindowViewController.m
      

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

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

مهم: شما باید هرگونه وابستگی موجود اضافه شده با استفاده از CocoaPods یا به صورت دستی را حذف کنید. برای دستورالعمل‌ها به مرحله 2 از راه‌اندازی یک پروژه Xcode مراجعه کنید.

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

2. یک پنجره ترمینال باز کنید، به دایرکتوری که فایل‌های نمونه را در آن کلون کرده‌اید بروید و به دایرکتوری GoogleMaps بروید:

   سویفت

   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 به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی Add Package کلیک کنید.
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 قرار دهید. برای مثال:

   سویفت

   static let apiKey = "YOUR_API_KEY"

   هدف-سی

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. در فایل SDKConstants.swift (Swift) یا فایل SDKDemoAPIKey.h (Objective-C)، خط زیر را حذف کنید، زیرا برای ثبت مشکل تعریف‌شده توسط کاربر استفاده می‌شود:

   سویفت

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

   هدف-سی

   #error Register for API Key and insert here.

8. پروژه را بسازید و اجرا کنید. پنجره شبیه‌ساز iOS ظاهر می‌شود و لیستی از نسخه‌های نمایشی Maps SDK را نشان می‌دهد.
9. برای آزمایش یکی از ویژگی‌های Maps SDK برای iOS، یکی از گزینه‌های نمایش داده شده را انتخاب کنید.
10. اگر از شما خواسته شد که به GoogleMapsDemos اجازه دسترسی به موقعیت مکانی خود را بدهید، Allow را انتخاب کنید.