İşaretçili Harita Ekleme

Bu eğitim, iOS uygulamanıza nasıl Google haritası ekleyeceğinizi gösterir. Harita, belirli bir konumu belirtmek için raptiye olarak da adlandırılan bir işaretçi içerir.

Kodu alma

GitHub'dan Google Haritalar iOS örnek deposunu klonlayın veya indirin.

/*
 * 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
  }
}

/*
* 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

Geliştirme projenizi oluşturma

iOS için Haritalar SDK'sını yüklemek üzere şu adımları uygulayın:

1. Xcode 13.0 veya sonraki bir sürümü indirip yükleyin.
2. Henüz CocoaPods'unuz yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin:

   sudo gem install cocoapods

3. Google Haritalar iOS örnek deposunu klonlayın veya indirin.
4. tutorials/map-with-marker dizinine gidin.
5. pod install komutunu çalıştırın. Bu işlem, Podfile öğesinde belirtilen API'leri ve sahip olabileceği bağımlıları yükleyecek.
6. Yüklü kapsül sürümünü tüm yeni güncellemelerle karşılaştırmak için pod outdated komutunu çalıştırın. Yeni bir sürüm tespit edilirse Podfile sürümünü güncellemek ve en son SDK sürümünü yüklemek için pod update eklentisini çalıştırın. Daha fazla bilgi için CocoaPods Rehberi'ne bakın.
7. Projeyi kod ile açmak için işaretçi.xcworkspace dosyasını Xcode'da açın (çift tıklayın). Projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

API anahtarı alma ve gerekli API'leri etkinleştirme

Bu eğiticiyi tamamlamak için, iOS için Haritalar SDK'sını kullanma yetkisi olan bir Google API anahtarı gerekir. Anahtar almak ve API'yi etkinleştirmek için aşağıdaki düğmeyi tıklayın.

Daha fazla bilgi için API anahtarı alma bölümüne göz atın.

Uygulamanıza API anahtarı ekleme

API anahtarınızı AppDelegate.swift bölümüne şu şekilde ekleyin:

1. Aşağıdaki içe aktarma ifadesi dosyaya eklendi:

   import GoogleMaps

2. Aşağıdaki yöntemi application(_:didFinishLaunchingWithOptions:) yönteminizde düzenleyin, API_KEY'inizi API anahtarınızla değiştirin:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Uygulamanızı oluşturma ve çalıştırma

1. Bilgisayarınıza bir iOS cihaz bağlayın veya Xcode şeması pop-up menüsünden bir simülatör seçin.
2. Cihaz kullanıyorsanız konum hizmetlerinin etkinleştirildiğinden emin olun. Simülasyon aracı kullanıyorsanız Özellikler menüsünden bir konum seçin.
3. Xcode'da Product/Run menü seçeneğini (veya oynat düğmesi simgesini) tıklayın.
• Xcode, uygulamayı derleyip 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'de bulunan bir işaretçiyle bir harita görmeniz gerekir.

Sorun giderme:

• Harita görmüyorsanız bir API anahtarı edinip yukarıda açıklandığı gibi uygulamaya eklediğinizden emin olun. API anahtarıyla ilgili hata mesajları için Xcode'un hata ayıklama konsolunu kontrol edin.
• API anahtarını iOS paket tanımlayıcısıyla kısıtladıysanız uygulamanın paket tanımlayıcısını eklemek için anahtarı düzenleyin: com.google.examples.map-with-marker.
• Kablosuz veya GPS bağlantınızın iyi olduğundan emin olun.
• Günlükleri görüntülemek ve uygulamada hata ayıklamak için Xcode hata ayıklama araçlarını kullanın.

Kodu anlama

1. Bir harita oluşturun ve loadView() görünümünde bunu 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. loadView() içinde 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, kullanıcı bir işaretçiye dokunduğunda bilgi penceresinin içeriğini görüntüler. Varsayılan davranışı kullanmaktan memnunsanız işaretçi için bir tıklama dinleyici eklemeniz gerekmez.

Tebrikler! Belirli bir konumu belirtmek için işaretçiyle birlikte bir Google haritası görüntüleyen bir iOS uygulaması oluşturdunuz. Ayrıca, iOS için Haritalar SDK'sını nasıl kullanacağınızı öğrendiniz.

Sonraki adımlar

Harita nesnesi ve işaretçilerle neler yapabileceğiniz hakkında daha fazla bilgi edinin.