Kurulum ve Demo

Platform seçin: Android iOS

Bu sayfada, yardımcı program kitaplığı Haritalar SDK'sı için.

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

Xcode projesine iOS Kamu Hizmeti Kitaplığı için Haritalar SDK'sını ekleme

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

Swift Package Manager'ı kullanma

  1. Henüz bir Xcode projeniz yoksa şimdi bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmede yeniyseniz yeni bir proje oluşturun ve iOS uygulamasını seçin şablonunu seçin. Xcode 11.7 veya daha eski sürümlerde bir Tek Görünüm Uygulaması oluşturun.)
  2. Bağımlılık olarak iOS için Haritalar SDK'sını ekleyin. Görüntüleyin Seçenekler için SDK'yı yükleme.
  3. Xcode projenizde File (Dosya) -> yolunu izleyin. Swift Paketleri -> Paket Bağımlısı ekleyin.
  4. Gösterilen pencerede, iOS Yardımcı Programı Kitaplığı için Haritalar SDK'sı depo URL'sini girin https://github.com/googlemaps/google-maps-ios-utils tıklayın ve İleri'yi seçin.
    • Bu noktada GitHub hesabınızla kimlik doğrulaması yapmanız istenebilir. Şunu izleyin: oluşturmak için talimatları GitHub kişisel erişim jetonunu kullanın.
  5. Sonraki pencerede Sürüm radyo seçeneğini belirleyin ve 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 (örneğin, "6.0.0").
  6. Projeye Ekle'nin yanındaki açılır menüyü tıklayın, projenizi ve Paket Ekle'yi seçin.

CocoaPods'u kullanma

  1. Henüz bir Xcode projeniz yoksa şimdi bir tane oluşturun ve yerel makinenize bakın. (iOS geliştirmede yeniyseniz, bir Tek Uygulamayı Görüntüle'yi tıklayın.)
  2. Projeniz için halihazırda bir kapsül dosyanız yoksa dosya oluşturun Podfile olarak adlandırılmıştır. Bu dosya, ve projenin bağımlılıklarını konuşacağız.
  3. Projenizin kapsül dosyasını düzenleyin ve Google-Maps-iOS-Utils kapsülü. Burada bağımlılıklarını içeren bir örnek iOS için Haritalar SDK'sı ve yardımcı program kitaplığı:
    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.0.0' # x-release-please-version
    end
    .
  4. pod install çalıştır.
  5. Xcode'u kapatın ve ardından projenizin klasörünü açın (çift tıklayın) .xcworkspace dosyasını kullanarak Xcode'u başlatın. Bu andan itibaren, projeyi açmak için .xcworkspace dosyasını kullanmalıdır.

Not: İşaretçi kümeleme yardımcı programı Ancak quadtree'yi işaretçi kümeleme olmadan kullanabilirsiniz. Şunu istiyorsanız: quadtree yardımcı programını, pod 'Google-Maps-iOS-Utils' - Kapsül dosyanızda 'Google-Maps-iOS-Utils/QuadTree'.

API anahtarını uygulamanıza ekleyin

Oluşturmayla ilgili talimatlar için Xcode Projesi oluşturma bölümüne bakın Xcode projenize eklemek için bir anahtar oluşturun.

Projeyi derleyin ve çalıştırın

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

Uygulamanızda yardımcı program kullanma

Uygulamanızda kullanma hakkında daha fazla bilgi edinmek için ilgili yardımcı programlarla ilgili dokümanlara bakın:

Demo uygulamayı yükleyip çalıştırma

Yardımcı program kitaplığı, her bir yardımcı programı yükleyip deneyebileceğiniz bir demo uygulaması içerir.

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

GitHub'daki dosyaları kullan

  1. İndir kod örnek arşivini GitHub arşivin paketini açın.
  2. Bir terminal penceresi açın, örnek dosyaları genişlettiğiniz dizine gidin ve kullanmak istediğiniz dil için uygun örnekler dizinine gidin:
    • Swift için cd google-maps-ios-utils-master/samples/SwiftDemoApp komutunu çalıştırın
    • Objective-C için cd google-maps-ios-utils-master/samples/ObjCDemoApp komutunu çalıştırın
  3. Aşağıdaki komutu çalıştırın:
    pod install
  4. Xcode'u kapatın ve ardından projenizin klasörünü açın (çift tıklayın) .xcworkspace dosyasını kullanarak Xcode'u başlatın. Bu andan itibaren, projeyi açmak için .xcworkspace dosyasını kullanmalıdır.

CocoaPods 1.6.1 sürümünü kullanın

  1. Bir terminal penceresi açın ve 1.6.1 sürümünü yükleyin:
    sudo gem install cocoapods -v1.6.1
    .
  2. Cocoapods'u kullanarak Google Haritalar dosyalarını getirin:
    pod try Google-Maps-iOS-Utils
    .

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

API anahtarını demo uygulamaya ekleyin

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

Swift

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

  1. Aşağıdaki içe aktarma deyimini ekleyin:
    import GoogleMaps
    .
  2. API anahtarınızı çift tırnak işaretleri 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 aşağıdaki şekilde ekleyin:

  1. Aşağıdaki içe aktarma deyimini ekleyin:
    @import GoogleMaps;
    .
  2. API anahtarınızı çift tırnak işaretleri 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 uygulamayı derleme ve çalıştırma

API anahtarını ekledikten sonra projeyi derleyip ç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 İşaretçi kümeleme yardımcı programı. 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üne bakın.