Kurulum ve Demo

Platform seçin: Android iOS

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

Bu yardımcı programları denemek için:

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

iOS için Haritalar SDK'sı Yardımcı Kitaplığı'nı Xcode projesine ekleme

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

Swift Package Manager'ı kullanma

1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmeye yeni başladıysanız yeni bir proje oluşturun ve iOS uygulaması şablonunu seçin. Xcode 11.7 veya daha eski sürümlerde Tek Görünümlü Uygulama oluşturun.)
2. iOS için Haritalar SDK'sını bağımlılık olarak ekleyin. Seçenekler için SDK'yı yükleme bölümüne bakın.
3. Xcode projenizde Dosya -> Swift Paketleri -> Paket Bağımlısı Ekle'ye gidin.
4. Gösterilen pencerede iOS için Haritalar SDK'sı Utility Library depo URL'sini girinhttps://github.com/googlemaps/google-maps-ios-utils ve Sonraki'yi seçin.
• Bu noktada, GitHub hesabınızla kimlik doğrulamanız istenebilir. İşleme devam etmek için GitHub kişisel erişim jetonu oluşturma talimatlarını uygulayın.
5. Sonraki pencerede Sürüm radyo seçeneğini, açılır listeden Sonraki Ana Sürüme Kadar'ı seçin ve iOS Utility Library için Haritalar SDK'sının en son sürümünü girin (ör. "6.0.0").
6. Projeye Ekle'nin yanındaki açılır menüyü tıklayın, projenizi seçin ve Paket Ekle'yi seçin.

CocoaPods'u kullanma

1. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmeye yeni başladıysanız Tek Görünümlü Uygulama 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 pod 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 örnek aşağıda verilmiştir:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   end

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

Not: İşaretçi kümeleme yardımcı programı dörtlü ağaca bağlıdır ancak dörtlü ağacı işaretçi kümeleme olmadan da kullanabilirsiniz. Yalnızca dörtlü ağaç yardımcı programını kullanmak istiyorsanız pod dosyanızda pod 'Google-Maps-iOS-Utils' değerini 'Google-Maps-iOS-Utils/QuadTree' olarak değiştirebilirsiniz.

API anahtarını uygulamanıza ekleme

API anahtarı oluşturma ve Xcode projenize ekleme talimatları için Xcode projesi oluşturma başlıklı makaleyi inceleyin.

Projeyi derleyip çalıştırma

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

Uygulamanızda bir yardımcı program kullanın

Her yardımcı programın uygulamanızda kullanımıyla ilgili daha fazla bilgi için ilgili dokümanları inceleyin:

• İşaretçi gruplandırması
• Quadtree
• KML oluşturma
• GeoJSON oluşturma
• Isıtma haritası

Demo uygulamasını yükleyip çalıştırma

Yardımcı program kitaplığında, yükleyip her yardımcı programı denemeniz için bir demo uygulama bulunur.

Demo uygulamayı yükleyin:

GitHub'daki dosyaları kullanma

1. GitHub'dan kod örneği arşivini indirin ve arşivi açın.
2. Bir terminal penceresi açın, örnek dosyaların genişletildiği dizine gidin ve kullanmak istediğiniz dile ait uygun örnekler dizine gidin:
   • Swift için cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • Objective-C için cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. Aşağıdaki komutu çalıştırın:
   

   pod install

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

API anahtarını demo uygulamasına ekleme

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

Not: API anahtarınızda uygulama kısıtlaması kullanılıyorsa anahtara uygulamanızın paket tanımlayıcısını eklediğinizden emin olun. Örneğin, demo uygulamayı çalıştırıyorsanız paket tanımlayıcısı com.google.gmsutils.DemoApp'tür. Anahtarları kısıtlama hakkında daha fazla bilgi için API anahtarı alma başlıklı makaleyi inceleyin.

Swift

API anahtarınızı AppDelegate.swift'nize aşağıdaki gibi ekleyin:

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

   import GoogleMaps

2. API anahtarınızı çift tırnak içine 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'nize aşağıdaki gibi ekleyin:

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

   @import GoogleMaps;

2. API anahtarınızı çift tırnak içine 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 uygulamayı derleyip çalıştırma

API anahtarını ekledikten sonra projeyi derleyin ve çalıştırın:

• Demo'nun Swift sürümünü çalıştırıyorsanız uygulamada hangi yardımcı programın görüntüleneceğini seçebilirsiniz.
• Demo'nun 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. Ardından, her yardımcı programı denemek için demo'nun 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üne bakın.