نمایش نقشه پایه

این مثال نقشه‌ای ایجاد می‌کند که مرکز آن سیاتل، واشنگتن است.

شروع کنید

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

مشاهده کد

Swift

import GoogleMaps
import UIKit

class BasicMapViewController: UIViewController {
  var statusLabel: UILabel!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Seattle coordinates
    let camera = GMSCameraPosition(latitude: 47.6089945, longitude: -122.3410462, zoom: 14)
    let mapView = GMSMapView(frame: view.bounds, camera: camera)
    mapView.delegate = self
    view = mapView
    navigationController?.navigationBar.isTranslucent = false

    statusLabel = UILabel(frame: .zero)
    statusLabel.alpha = 0.0
    statusLabel.backgroundColor = .blue
    statusLabel.textColor = .white
    statusLabel.textAlignment = .center
    view.addSubview(statusLabel)
    statusLabel.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      statusLabel.topAnchor.constraint(equalTo: view.topAnchor),
      statusLabel.heightAnchor.constraint(equalToConstant: 30),
      statusLabel.leadingAnchor.constraint(equalTo: view.leadingAnchor),
      statusLabel.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    ])
  }
}

extension BasicMapViewController: GMSMapViewDelegate {
  func mapViewDidStartTileRendering(_ mapView: GMSMapView) {
    statusLabel.alpha = 0.8
    statusLabel.text = "Rendering"
  }

  func mapViewDidFinishTileRendering(_ mapView: GMSMapView) {
    statusLabel.alpha = 0.0
  }
}
BasicMapViewController.swift
      

آبجکتیو-سی

#import "GoogleMapsDemos/Samples/BasicMapViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation BasicMapViewController {
  UILabel *_statusLabel;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  // Seattle coordinates
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.6089945
                                                          longitude:-122.3410462
                                                               zoom:14];
  GMSMapView *view = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  view.delegate = self;
  self.view = view;

  // Add status label, initially hidden.
  _statusLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, 0, 30)];
  _statusLabel.alpha = 0.0f;
  _statusLabel.autoresizingMask = UIViewAutoresizingFlexibleWidth;
  _statusLabel.backgroundColor = [UIColor blueColor];
  _statusLabel.textColor = [UIColor whiteColor];
  _statusLabel.textAlignment = NSTextAlignmentCenter;

  [view addSubview:_statusLabel];
}

- (void)mapViewDidStartTileRendering:(GMSMapView *)mapView {
  _statusLabel.alpha = 0.8f;
  _statusLabel.text = @"Rendering";
}

- (void)mapViewDidFinishTileRendering:(GMSMapView *)mapView {
  _statusLabel.alpha = 0.0f;
}

@end
BasicMapViewController.m
      

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

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

مهم: باید هرگونه وابستگی موجود را که بااستفاده از CocoaPods یا به‌صورت دستی اضافه شده است بردارید. برای دستورالعمل‌ها، مرحله ۲ از راه‌اندازی پروژه 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

   آبجکتیو-سی

   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. کلید میانای برنامه‌سازی کاربردی را از پروژه‌تان با کیت توسعه نرم‌افزار 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 اجازه دهید به مکانتان دسترسی داشته باشد، اجازه دادن را انتخاب کنید.