İşaretçi İçeren Harita Ekleyin

Bu eğitim, iOS cihazınıza işaretçi içeren basit bir Google haritasını nasıl ekleyeceğinizi gösterir. uygulamasını indirin. Başlangıç ya da orta seviye Swift veya Objective-C'yi ve Xcode genel bilgisini öğrenin. Gelişmiş bir rehber için Haritalar'ı inceleyerek, geliştiricilerin rehberini inceleyin.

Bu eğiticiyi kullanarak aşağıdaki haritayı oluşturacaksınız. İşaretçi şu konumda bulunuyor: Sydney, Avustralya.

Sidney'in üzerinde işaretçi bulunan bir haritanın ekran görüntüsü

Kodu alın

Şunu klonlayın veya indirin: GitHub'daki Google Haritalar iOS örnekleri deposu.

Alternatif olarak, kaynak kodunu indirmek için aşağıdaki düğmeyi tıklayın:

Kodu ver

Swift

/*
 * Copyright 2020 Google Inc. All rights reserved.
 *
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 * file except in compliance with the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 * ANY KIND, either express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

Objective-C

/*
* Copyright 2020 Google Inc. All rights reserved.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
* file except in compliance with the License. You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under
* the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
* ANY KIND, either express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end

Başlayın

Swift Paket Yöneticisi

iOS için Haritalar SDK'sı, Swift Package Manager kullanılarak yüklenebilir.

  1. iOS bağımlılıkları için mevcut tüm Haritalar SDK'sını kaldırdığınızdan emin olun.
  2. Bir terminal penceresi açıp tutorials/map-with-marker dizinine gidin.
  3. Xcode çalışma alanınızın kapalı olduğundan emin olun ve aşağıdaki komutları çalıştırın: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
rm Podfile
rm map-with-marker.xcworkspace
    .
  4. Xcode projenizi açın ve kapsül dosyasını silin.
  5. Dosya > Paket Bağımlılıkları Ekleyin.
  6. URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girin, paketi almak için Enter'a basın ve Paket Ekle'yi tıklayın.
  7. Dosya > Paketler > Paket Önbelleğini Sıfırla.

CocoaPods'u kullanma

  1. Xcode'u indirip yükleyin 15.0 veya daha yeni bir sürüme sahip olmanız gerekir.
  2. Henüz CocoaPods'unuz yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin: 
    sudo gem install cocoapods
  3. tutorials/map-with-marker dizinine gidin.
  4. pod install komutunu çalıştırın. Bu işlem, Podfile içinde belirtilen Haritalar SDK'sını ve bağımlılıklarını yükler.
  5. Yüklü kapsül sürümünü yeni güncellemelerle karşılaştırmak için pod outdated komutunu çalıştırın. Yeni bir sürüm algılanırsa Podfile uygulamasını güncellemek ve en son SDK'yı yüklemek için pod update komutunu çalıştırın. Daha ayrıntılı bilgi için CocoaPods Kılavuzu'nu inceleyin.
  6. Projenin map-with-marker.xcworkspace dosyasını açın (çift tıklayın) dosyasını Xcode'da açın. Projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

API anahtarı alın ve gerekli API'leri etkinleştirin

Bu eğiticiyi tamamlamak için yetkili bir Google API anahtarı gerekir: iOS için Haritalar SDK'sını kullanmalıdır. Aşağıdaki düğmeyi tıklayarak bir anahtar ile API'yi etkinleştirin.

. Başlarken

Daha fazla bilgi için bkz. API anahtarı alın.

API anahtarını uygulamanıza ekleyin

API anahtarınızı AppDelegate.swift cihazınıza aşağıdaki şekilde ekleyin:

  1. Aşağıdaki içe aktarma ifadesinin dosyaya eklendiğini unutmayın: 
    import GoogleMaps
    .
  2. Aşağıdaki satırı application(_:didFinishLaunchingWithOptions:) içinde düzenleyin yöntemi yerine YOUR_API_KEY ifadesini API anahtarınızla değiştirin: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Uygulamanızı derleyip çalıştırma

  1. Bilgisayarınıza bir iOS cihazı bağlayın veya bir simülatör "Xcode şeması" menüsünden seçim yapabilirsiniz.
  2. Bir cihaz kullanıyorsanız konum hizmetlerinin etkinleştirildiğinden emin olun. Simülasyon aracı kullanıyorsanız Özellikler bölümünden bir konum seçin. tıklayın.
  3. Xcode'da Product/Run (Ürün/Çalıştır) menü seçeneğini tıklayın (veya düğme simgesi).
    • Xcode uygulamayı oluşturur ve ardından cihazda veya simülatörde çalıştırır.
    • Bu sayfadaki resme benzer şekilde, Avustralya'nın doğu kıyısında Sidney'in ortasında bir işaretçinin olduğu bir harita göreceksiniz.

Sorun Giderme:

  • Harita görmüyorsanız bir API anahtarı edinip eklediğinizden emin olun. önceden açıklandığı gibi uygulamaya koymanız gerekir. Kontrol et API anahtarıyla ilgili hata mesajları için Xcode'un hata ayıklama konsolu.
  • API anahtarını iOS paket tanımlayıcısıyla kısıtladıysanız tuşunu kullanın: com.google.examples.map-with-marker
  • Kablosuz veya GPS bağlantınızın iyi olduğundan emin olun.
  • Xcode hata ayıklama araçlarını kullanın günlükler görüntüleyebilir ve uygulamada hata ayıklayabilirsiniz.

Kodu anlama

  1. Bir harita oluşturun ve viewDidLoad() içindeki görünüm olarak ayarlayın.

    Swift

    // Create a GMSCameraPosition that tells the map to display the
// coordinate -33.86,151.20 at zoom level 6.
let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
view = mapView

    Objective-C

    // Create a GMSCameraPosition that tells the map to display the
// coordinate -33.86,151.20 at zoom level 6.
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                        longitude:151.20
                                                             zoom:6.0];
GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
self.view = mapView;
  2. viewDidLoad() bölgesindeki haritaya bir işaretçi ekleyin.

    Swift

    // Creates a marker in the center of the map.
let marker = GMSMarker()
marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
marker.title = "Sydney"
marker.snippet = "Australia"
marker.map = mapView

    Objective-C

    // Creates a marker in the center of the map.
GMSMarker *marker = [[GMSMarker alloc] init];
marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
marker.title = @"Sydney";
marker.snippet = @"Australia";
marker.map = mapView;

iOS için Haritalar SDK'sı varsayılan olarak bilginin içeriğini gösterir. kullanıcı bir işaretçiye dokunduğunda gösterilecek. Gerekirse bir tıklama işleyici eklemeniz varsayılan davranışı kullanmaktan memnunsanız işaretçiyi tıklayın.

Tebrikler! Bir Google haritasında görüntülenen ve işaretçi içerir. iOS için Haritalar SDK'sı

Sonraki adımlar

Harita nesnesi ve bu nesnel işaretçilerle yapabilirsiniz.