Uygulamanıza 3D harita ekleme

Platform seçin: Android iOS JavaScript

Bu ürün veya özellik deneyseldir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Bu sayfada, iOS için Haritalar 3D SDK'sı kullanılarak iOS uygulamasına temel bir 3D haritanın nasıl ekleneceğiyle ilgili bir örnek açıklanmaktadır. Bu sayfadaki talimatlarda, Kurulum sayfasındaki adımları tamamladığınız ve aşağıdakilere sahip olduğunuz varsayılır:

• iOS için Haritalar 3D SDK'sının etkin olduğu bir Google Cloud projesi
• iOS için Haritalar 3D SDK'sı API anahtarı
• iOS için Haritalar 3D SDK'sı paketinin eklendiği Xcode 16.0 sürümü veya sonraki sürümler.

Bu ön koşullar hakkında daha fazla bilgi edinmek için Kurulum bölümüne bakın.

Daha gelişmiş bir Codelab'i takip edin.

Daha fazla kod örneği için GitHub'a göz atın.

1. Bölüm: Temel bir SwiftUI uygulaması oluşturma

1. Xcode'da yeni bir uygulama oluşturun.
2. Ürün Adınızı Hello3DWorld olarak, kuruluş tanımlayıcısını ise com.example olarak ayarlayın. Paket adı com.example.Hello3DWorld olmalıdır.
3. SwiftUI arayüzünü seçin.
4. Haritalar 3D kitaplığını uygulamanıza ekleyin. Kurulum bölümündeki talimatları inceleyin.

2. Bölüm: Harita ekleme

1. ContentView.swift adlı dosyayı açın. Bu, uygulamanızın giriş noktası ve ana gezinme menüsüdür.

2. SwiftUI ve GoogleMaps3D paketini içe aktarın.

3. body beyanı içindeki tüm kodu Map(mode: .hybrid) ile değiştirin.

   Bir Map'ü başlatmak için sağlamanız gereken minimum ilk yapılandırma MapMode'dur:

   • .hybrid veya
   • .satellite

   ContentView.swift dosyanız şu şekilde görünmelidir:

   import SwiftUI
   import GoogleMaps3D
   
   struct ContentView: View {
     var body: some View {
       Map(mode: .hybrid)
     }
   }
   
   #Preview {
     ContentView()
   }
   

3. Bölüm: API anahtarınızı ayarlayın.

1. API anahtarı, harita başlatılmadan önce ayarlanmalıdır. Bunu, haritayı içeren View bileşeninin init() etkinlik işleyicisinde Map.apiKey ayarlayarak yapabilirsiniz.

   Uyarı: API anahtarını harici veya herkese açık kaynak denetimine eklemeyin

   import SwiftUI
   import GoogleMaps3D
   
   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
   
     var body: some View {
       Map(mode: .hybrid)
     }
   }
   

4. Bölüm: Harita görünümünü kontrol etmek için kamera kullanma

3D harita görünümleri Camera sınıfı tarafından kontrol edilir. Bu adımda, harita görünümünü özelleştirmek için konumu, irtifayı, yönü, eğimi, yuvarlanmayı ve menzili nasıl belirteceğinizi öğreneceksiniz.

1. Map() işlev çağrısını, initialCamera özelliğini içerecek şekilde değiştirin. Manhattan'ın merkezindeki bir manzarayı göstermek için initialCamera değişkenini başlatın.

   Not: Parametre sırası önemlidir. Kamera, önce enlem, ardından boylam sağlanarak başlatılır. Özellikle başka bir kaynaktan yapıştırırken her biri için doğru değerleri belirttiğinizden emin olun. Aksi takdirde kamera beklenmedik bir konum gösterebilir.

   import SwiftUI
   import GoogleMaps3D
   
   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
     var body: some View {
       Map(initialCamera: .init(
         latitude: 40.748339,
         longitude: -73.985912,
         altitude: 211.1,
         heading: 52,
         tilt: 68,
         range: 1039
       ), mode: .hybrid)
     }
   }
   

Yukarıdaki kodda aşağıdaki parametreler için değerler ayarlanır:

• heading: Kameranın kuzeyden hangi yöne bakacağını gösteren derece cinsinden yön.
• tilt: Eğme açısının derece cinsinden değeri. 0 doğrudan başınızın üzerinde, 90 ise yatay olarak baktığınız anlamına gelir.
• roll: Kameranın dikey düzlemi etrafında derece cinsinden yan kayma açısı.
• range: Kameranın enlem, boylam konumuna olan mesafesi (metre cinsinden)
• altitude: Kameranın deniz seviyesinden yüksekliği.

Bu ek parametrelerden hiçbirini sağlamazsanız varsayılan bir değer kullanılır.

Not: Kameranın rakımı mutlak bir değerdir. Zemin seviyesinin deniz seviyesinin çok üzerinde olduğu yerlerde, zemin seviyesinden daha düşük bir yükseklik ayarlamak garip görsel efektlere neden olabilir.

Not: Eğim ve menzil ayarlarını kullanarak kameranın göreceli yüksekliğini de ayarlayabilirsiniz.

Kamera görünümünde daha fazla 3D veri gösterilmesini sağlamak için ilk parametreleri daha yakın ve eğik bir görünüm gösterecek şekilde ayarlayın.

6. Bölüm: Uygulamanızı önizleme ve çalıştırma

1. Xcode önizlemesi ekleme

   Önizlemeler, Simülatör'ü veya harici bir cihazı kullanmak zorunda kalmadan uygulamanızı görmenize ve uygulamanızla etkileşime geçmenize olanak tanıyan güçlü bir XCode özelliğidir.

   Önizleme eklemek için yapınızın dışına bir #Preview {} kod bloğu ekleyin.

   #Preview {
     CameraDemo()
   }
   

2. Uygulamayı çalıştırma

Uygulamayı derleyip çalıştırın.

Tebrikler!

Uygulamaya 3D harita eklediniz.

Ardından, iOS için Haritalar 3D SDK'sının kamera yolu animasyonları, 3D işaretçiler veya poligonlar gibi daha gelişmiş özelliklerini keşfedebilirsiniz.