Kurulum

Bu sayfada, iOS için Haritalar 3D SDK'sı ile geliştirmeye başlamak üzere yapmanız gerekenler açıklanmaktadır. Kurulum sürecinde, SDK ile kullanılacak bir Google Cloud projesi ve API'si yapılandırılır, ardından bir Xcode projesi oluşturulur. Uygulamanıza ilk 3D haritanızı eklemeden önce bu adımları tamamlayın.

Ön koşullar

iOS için Haritalar 3D SDK'sını kullanmak istiyorsanız projenizin ve hedef cihazlarınızın aşağıdaki koşulları karşılaması gerekir:

  • Minimum iOS sürümü: iOS 16.0 veya sonraki sürümleri hedefleyin.
  • Xcode: Xcode sürüm 16.0 veya sonraki sürümler.

Google Cloud projesi ve API anahtarı oluşturma

iOS için Haritalar 3D SDK'sı ile uygulama geliştirmeye başlamadan önce aşağıdaki adımları tamamlayarak iOS için Haritalar 3D SDK'sı ile kullanacağınız bir Google Cloud projesi ve API anahtarı oluşturmanız gerekir:

1. Adım

Konsol

  1. Google Cloud Console'daki proje seçici sayfasında, yeni bir Cloud projesi oluşturmaya başlamak için Proje Oluştur'u tıklayın.

    Proje seçici sayfasına gidin

  2. Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Projeniz için faturalandırmanın etkinleştirildiğini onaylayın.

    Google Cloud, ücretsiz deneme sürümü sunar. Deneme süresi, 90 günün sonunda veya hesapta 300 ABD doları tutarında ücret tahakkuk ettiğinde (hangisi önce gerçekleşirse) sona erer. İstediğiniz zaman iptal edebilirsiniz. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma başlıklı makaleleri inceleyin.

Google Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

2. Adım

Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.

Bazı entegrasyonlar için birden fazla API/SDK etkinleştirmeniz gerektiğini unutmayın. Hangi API'leri veya SDK'ları etkinleştirmeniz gerektiğinden emin değilseniz Özellikler Gezgini'ni kullanmayı deneyin veya kullanmak istediğiniz API/SDK ile ilgili belgelere bakın.

Bir veya daha fazla API ya da SDK'yı etkinleştirmek için:

Konsol

  1. Cloud Console'da Haritalar API Kitaplığı sayfasına giderek etkinleştirebileceğiniz Google Haritalar Platformu API'lerini ve SDK'larını görebilirsiniz:

    Maps API Kitaplığı sayfasına gidin.

  2. Etkinleştirmek istediğiniz API'yi veya SDK'yı tıklayın.
    • Düğmede ETKİNLEŞTİR yazıyorsa API'yi veya SDK'yı etkinleştirmek için düğmeyi tıklayın.
    • Düğmede YÖNET yazıyorsa API veya SDK zaten etkindir ve başka bir işlem yapmanız gerekmez.
    • Düğmelerden birini tıkladığınızda API veya SDK'nın kontrol paneli gösterilir. (API veya SDK'yı bu projeden kaldırmak için DEVRE DIŞI BIRAK düğmesini tıklayın.)

Google Cloud SDK

Aşağıdaki komut tüm Maps, Routes ve Places API'lerini etkinleştirir:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

Environment API'leri etkinleştirmek için şu komutu kullanın:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

3. Adım

Bu adımda yalnızca API anahtarı oluşturma işlemi açıklanmaktadır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Ürüne özel API Anahtarlarını Kullanma sayfasında daha fazla bilgi bulabilirsiniz.

API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkili en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

  1. Google Haritalar Platformu > Kimlik bilgileri sayfasına gidin.

    Kimlik Bilgileri sayfasına gidin.

  2. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
    (Üretimde kullanmadan önce API anahtarını kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

SDK'yı etkinleştirmek için Google Cloud Console'daki iOS için Haritalar 3D SDK'sı sayfasına bakın. Bu adımları tamamlama hakkında daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Xcode projesi oluşturma

Bu bölümde, iOS için Haritalar 3D SDK'sı ile kullanılacak bir Xcode projesinin nasıl oluşturulacağı ve yapılandırılacağı açıklanmaktadır.

Faturalandırmayı etkinleştirip API anahtarı oluşturduktan sonra, uygulamanızı geliştirmek için kullandığınız Xcode projesini oluşturmaya hazır olursunuz.

1. adım: Gerekli yazılımı yükleyin

iOS için Haritalar 3D SDK'sını kullanarak proje oluşturmak istiyorsanız şunları indirip yüklemeniz gerekir:

  • Xcode 16.0 veya sonraki bir sürüm

2. adım: Xcode projesini oluşturun ve iOS için Haritalar 3D SDK'sını yükleyin

Swift Package Manager

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

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

  • Xcode project veya workspace dosyanızı açın, ardından File (Dosya) > Add Package Dependencies (Paket Bağımlılıkları Ekle) bölümüne gidin.
  • URL olarak https://github.com/googlemaps/ios-maps-3d-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) tıklayın.
  • Paket Ürünleri Seçin penceresinde, GoogleMaps3D ürününün belirlediğiniz ana hedefe ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.
  • Yüklemenizi doğrulamak için hedefinizin Genel bölmesine gidin. Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde, yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için Project Navigator'ın Package Dependencies bölümünü de görüntüleyebilirsiniz.

3. adım: API anahtarını uygulamanıza ekleyin

Swift Package Manager

API anahtarınızı uygulamanızın ana giriş noktasına (veya harita yüklenmeden önce herhangi bir zamanda) aşağıdaki gibi ekleyin.

  1. Aşağıdaki içe aktarma ifadesini ekleyin: 
    import GoogleMaps3D
  2. Aşağıdaki yöntemi ekleyin. YOUR_API_KEY kısmını API anahtarınızla değiştirin. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

4. adım (isteğe bağlı): Apple gizlilik manifesti dosyasını inceleyin

Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar.

Apple gizlilik manifest dosyası, SDK'nın kaynak paketine dahildir. Gizlilik manifest dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Sonraki adımlar

iOS için Haritalar 3D SDK'sı ile kullanılmak üzere ayarlanmış bir Google Cloud projeniz, API anahtarınız ve Xcode projeniz olduğuna göre artık uygulamanıza 3D harita ekleyebilirsiniz.