開始使用
請務必先設定開發環境，再試用程式碼範例。詳情請參閱 Maps SDK for iOS 程式碼範例。
查看程式碼
Swift
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)
}
})
}
}
Objective-C
#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
在本機執行完整的範例應用程式
您可以從 GitHub 下載封存檔，取得 Maps SDK for iOS 範例應用程式。請按照下列步驟安裝及試用 Maps SDK for iOS 範例應用程式。
- 執行
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git將範例存放區複製到本機目錄。 開啟終端機視窗，前往複製範例檔案的目錄，然後深入 GoogleMaps 目錄：
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod installopen GoogleMapsSwiftDemos.xcworkspaceObjective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod installopen GoogleMapsDemos.xcworkspace- 在 Xcode 中按下編譯按鈕，即可使用目前的配置建構應用程式。建構作業會產生錯誤，提示您在
SDKConstants.swift檔案 (Swift) 或SDKDemoAPIKey.h檔案 (Objective-C) 中輸入 API 金鑰。 - 如果您還沒有 API 金鑰，請按照操作說明在 Google Cloud 控制台中設定專案並取得 API 金鑰。在 Cloud 控制台中設定金鑰時，您可以限制金鑰，只允許範例應用程式的軟體包 ID 使用金鑰，確保只有您的應用程式可以使用金鑰。SDK 範例應用程式的預設套件 ID 為
com.example.GoogleMapsDemos。 - 編輯 Swift 的
SDKConstants.swift檔案或 Objective-C 的SDKDemoAPIKey.h檔案，然後將 API 金鑰貼到apiKey或kAPIKey常數的定義中。例如：Swift
static let apiKey = "YOUR_API_KEY"Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY"; - 在
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.
- 建構並執行專案。iOS 模擬器視窗隨即顯示 Maps SDK 示範清單。
- 選擇其中一個顯示的選項，即可試用 Maps SDK for iOS 的功能。
- 如果系統提示您允許 GoogleMapsDemos 存取您的位置，請選擇「允許」。