Kurulum ve Demo

Platform seçin: Android iOS

Bu sayfada, iOS için Haritalar SDK'sı için yardımcı program kitaplığının nasıl ayarlanacağı açıklanmaktadır.

Bu yardımcı programları deneyebilirsiniz:

• Demo uygulamasını yükleyip çalıştırın. Demo uygulaması, yardımcı programları denemek için gereken tüm kodları içeren bağımsız bir projedir.
• Yardımcı kitaplığı mevcut bir Xcode projesine yükleyin. Bu yardımcı programları kendi projenize ekleyin.

İsteğe bağlı olarak, CocoaPods'u yükleyin

Yardımcı program kitaplığı, Google-Maps-iOS-Utils adlı bir CocoaPods kapsülü olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projelerinin açık kaynak bağımlılık yöneticisidir.

Henüz CocoaPods aracınız yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin:

sudo gem install cocoapods

Ayrıntılı bilgi için CocoaPods Başlangıç Kılavuzu'na bakın.

Demo uygulamasını yükleyin ve çalıştırın

Hizmet kitaplığında, yükleyebileceğiniz ve her bir yardımcı programı deneyebileceğiniz bir demo uygulaması bulunur.

CocoaPods sürümünde 'pod try' ile ilgili bilinen bir sorun var 1.8.1 ve sonraki sürümler. Dosyaları CocoaPods kullanarak getirmek istiyorsanız CocoaPods sürüm 1.6.1'i kullanmanızı öneririz. Alternatif olarak, GitHub'daki örnek dosyaları da indirebilirsiniz.

Aşağıdaki iki yöntemden birini kullanarak demo uygulamasını yükleyin:

GitHub dosyalarını kullan

1. GitHub'dan kod örnek arşivini indirip arşivden çıkarın.
2. Bir terminal penceresi açın, örnek dosyaları genişlettiğiniz dizine gidin ve kullanmak istediğiniz dilin uygun örnek dizinini ayrıntılı olarak inceleyin:
   • Swift için cd google-maps-ios-utils-master/samples/SwiftDemoApp çalıştırın
   • Objective-C için cd google-maps-ios-utils-master/samples/ObjCDemoApp öğesini çalıştırın
3. Şu komutu çalıştırın:
   

   pod install

4. Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını çift tıklayın (çift tıklayın). Bu tarihten itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekecek.

CocoaPods sürüm 1.6.1'i kullanma

1. Bir terminal penceresi açın ve sürüm 1.6.1'i yükleyin:

   sudo gem install cocoapods -v1.6.1

2. Cocoapod'ları kullanarak Google Haritalar dosyalarını getirin:

   pod try Google-Maps-iOS-Utils

   Sorulduğunda Swift veya Objective-C'yi seçin. CocoaPods, spesifikasyon depolarınızı günceller, ardından demoyu SwiftDemoApp.xcodeproj veya ObjCDemoApp.xcodeproj adlı geçici bir Xcode projesinde açar.

Demo uygulamasına API anahtarını ekleme

API anahtarı al bölümünde, uygulamanız için bir API anahtarı oluşturursunuz. Şimdi bu anahtarı demo uygulaması için Xcode projesine ekleyin.

Not: API anahtarınız bir Uygulama kısıtlaması kullanıyorsa uygulamanızın paket tanımlayıcısını anahtara eklediğinizden emin olun. Örneğin, demo uygulamasını çalıştırıyorsanız paket tanımlayıcısı com.google.gmsutils.DemoApp şeklindedir. Anahtarın kısıtlanması hakkında daha fazla bilgi için API anahtarı alma bölümüne bakın.

Swift

API anahtarınızı AppDelegate.swift cihazınıza şu şekilde ekleyin:

1. Aşağıdaki içe aktarma ifadesini ekleyin:

   import GoogleMaps

2. API anahtarınızı çift tırnak arasına eklemek için aşağıdaki satırı düzenleyin:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

API anahtarınızı AppDelegate.m cihazınıza şu şekilde ekleyin:

1. Aşağıdaki içe aktarma ifadesini ekleyin:

   @import GoogleMaps;

2. API anahtarınızı çift tırnak arasına eklemek için aşağıdaki satırı düzenleyin:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

Demo uygulaması oluşturun ve çalıştırın

API anahtarını ekledikten sonra projeyi oluşturup çalıştırın:

• Demonun Swift sürümünü çalıştırıyorsanız uygulamada hangi yardımcı programın görüntüleneceğini seçebilirsiniz.
• Demonun Objective-C sürümünü çalıştırıyorsanız, işaretçi kümeleme yardımcı programının demosunu görürsünüz. Daha sonra, her bir yardımcı programı denemek için demonun Objective-C sürümünü düzenleyebilirsiniz. Daha fazla bilgi için aşağıdaki Uygulamanıza yardımcı program ekleme bölümünü inceleyin.

Hizmet kitaplığını Xcode projesi olarak yükleyin

Hizmet kitaplığını Xcode çalışma alanınıza eklemek için aşağıdaki adımları uygulayın:

CocoaPods kullan

1. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız Tek Görünüm Uygulaması oluşturun.)
2. Projeniz için kapsül dosyanız yoksa proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.
3. Projenizin kapsül dosyasını düzenleyin ve Google-Maps-iOS-Utils kapsülüne bağımlılık ekleyin. iOS için Haritalar SDK'sı ve yardımcı program kitaplığı için ihtiyaç duyduğunuz bağımlılıkları içeren bir örneği burada bulabilirsiniz:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '10.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '4.0.0'
     pod 'Google-Maps-iOS-Utils', '3.4.0'
   end

4. pod install çalıştırın.
5. Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını çift tıklayın (çift tıklayın). Bu tarihten itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekecek.

Not: İşaretçi kümeleme yardımcı programı dörde göre değişir, ancak dörtlü ağacı işaretçi kümeleme olmadan kullanabilirsiniz. Yalnızca quadtree yardımcı programını kullanmak isterseniz kapsül dosyanızda pod 'Google-Maps-iOS-Utils' öğesini 'Google-Maps-iOS-Utils/QuadTree' olarak değiştirebilirsiniz.

Carthage'ı kullan

1. Carthage'ı yükle. Birkaç yöntem vardır. Bu nedenle, tam adımlar için Carthage README dosyasına bakın.
2. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız yeni bir proje oluşturun ve iOS Uygulama şablonunu seçin. Xcode 11.7 veya önceki sürümlerde bir Tek Görünüm Uygulaması oluşturun.)
3. Proje dizininizde Cartfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.
4. Cartfile düzenleyin ve iOS Yardımcı Program Kitaplığı bağımlılığı için Haritalar SDK'sını ekleyin:
   

   github "googlemaps/google-maps-ios-utils"

5. Cartfile kaydedin.
6. Bir terminal penceresinde Cartfile:
   

   cd <path-to-project>

   değerini içeren dizine gidin
7. Güncelleme komutunu çalıştırın:
   

   carthage update --platform iOS

   
   Bu işlem, Cartfile sayfasında belirtilen API'leri ve sahip olabilecekleri bağımlıları yükleyecektir.
8. Finder'da, proje dizininizde, Carthage/Build/iOS altındaki indirilen çerçeve dosyalarına gidin.
9. Aşağıdaki paketleri projenize sürükleyerek iOS için Haritalar SDK'sını ekleyin. (İstendiğinde Öğeleri gerekirse kopyalayın seçeneğini belirleyin.)
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
   Premium Plan müşterileri de GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework içermelidir.
10. Projenizde GoogleMaps.framework simgesini sağ tıklayın ve Finder'da Göster'i seçin.
11. Resources klasöründen Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle öğesini projenize sürükleyin. Sizden istendiğinde, Öğeleri hedef gruba kopyala<#39;s klasörünün seçili seçili olmadığından emin olun.
12. Project Navigator uygulamasından projenizi ve uygulamanızın hedefini seçin.
13. Uygulamanızın hedefi için Aşama Aşamaları sekmesini açın ve İkili Kitaplıkları Bağla alanına aşağıdaki çerçeveleri ekleyin:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümüne -ObjC ekleyin. Bu ayarlar görünmüyorsa Oluşturma Ayarları çubuğundaki Temel filtresini Tümü olarak değiştirin.

Swift Package Manager kullan

1. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin. Xcode 11.7 veya önceki sürümlerde bir Tek Görünüm Uygulaması oluşturun.)
2. iOS için Haritalar SDK'sını bağımlı olarak ekleyin. Seçenekler için SDK'yı yükleme bölümüne bakın.
3. Xcode projenizde File -> Swift Packages -> Add Package Dependency (Paket Bağımlısı Ekle) seçeneğine gidin.
4. Açılan pencerede, iOS Yardımcı Program Kitaplığı depo URL'sini (https://github.com/googlemaps/google-maps-ios-utils) girin ve Next'i (Sonraki) seçin.
• Bu aşamada GitHub hesabınızla kimlik doğrulaması yapmanız istenebilir. İşleme devam etmek için GitHub kişisel erişim jetonu oluşturma talimatlarını uygulayın.
5. Bir sonraki pencerede, Sürüm radyo seçeneğini belirleyin, açılır listeden Tam seçeneğini belirleyin, iOS Yardımcı Program Kitaplığı için Haritalar SDK'sının en son sürümünü girin (ör. "3.4.0") ve İleri'yi seçin.

Uygulamanıza API anahtarını ekleme

API anahtarı oluşturma ve Xcode projenize ekleme talimatları için Xcode Projesi oluşturma bölümüne bakın.

Projeyi oluşturun ve çalıştırın

API anahtarını ekledikten sonra projeyi oluşturup çalıştırın.

Uygulamanıza yardımcı program ekleme

Uygulamanızda kullanma hakkında daha fazla bilgi için her yardımcı programın dokümanlarına bakın:

• İşaretçi kümeleme
• Çeşme
• KML oluşturma
• GeoJSON oluşturma
• İlgi çekici