iOS için Haritalar SDK'sı, iOS uygulamalarına Google Haritalar verilerine dayalı haritalar eklemenize olanak tanır. SDK; Google Haritalar sunucularına erişimi, harita görüntülemeyi ve kullanıcı hareketlerine yanıt vermeyi yönetir. Ayrıca haritaya işaretçiler, çoklu çizgiler, yer üstü katmanları ve bilgi pencereleri eklemenize olanak tanır.
iOS için Haritalar SDK'sı: Önemli bilgiler
- Ürün: iOS için Haritalar SDK'sı
- Diğer adları: iOS için Google Haritalar SDK'sı
- Kategori: Haritalar
- Platform: iOS
- Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: iOS için Haritalar SDK'sına genel bakış
- Kullanılabildiği bölgeler: Dünya geneli. Google Haritalar Platformu kapsam sayfasını inceleyin. Kullanım ve faturalandırma sayfasında, dünya geneli ve Hindistan için ayrı fiyatlandırma listeleri bulunur. (kapsam ayrıntıları)
iOS için Haritalar SDK'sı: Ne zaman kullanılır?
iOS için Haritalar SDK'sını şu durumlarda kullanın:
- Yerel bir iOS uygulamasında hareket işleme özelliğine sahip etkileşimli bir Google haritasına ihtiyacınız var.
- Bir iOS uygulamasındaki haritaya işaretçiler, çoklu çizgiler, yer paylaşımları veya bilgi pencereleri eklemeniz gerekiyor.
- iOS uygulamasında Street View panoramaları göstermeniz gerekiyor.
- Harita gösteren bir iOS uygulamasında koordinatları adreslere dönüştürmek için tersine coğrafi kodlama yapmanız gerekiyor.
iOS için Haritalar SDK'sını kullanmamanız gereken durumlar:
- iOS uygulamasında fotogerçekçi 3D haritalara ihtiyacınız varsa iOS için Haritalar 3D SDK'sını kullanın.
- Uygulamanızda bir harita oluşturmak yerine Google Haritalar uygulamasında bir konum veya yol tarifi açmanız yeterlidir. Bunun yerine Haritalar URL'lerini kullanın.
iOS için Haritalar SDK'sı: kurulum
- Etkinleştirilecek hizmet:
maps-ios-backend.googleapis.com - Kimlik doğrulama: API anahtarı
- Kullanım ilişkilendirmesi: Başlatıcıya kullanım ilişkilendirme kimliği eklemek için
GMSServicessınıf yönteminiaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) çağırın. Kapsam dışında kalmayı seçmek için çağrıyı silin veya boş bir dize iletin. - Başlangıç: iOS için Haritalar SDK'sını ayarlama
- Referans: iOS için Haritalar SDK'sı referansı
- Fiyatlandırma: iOS için Haritalar SDK'sı kullanımı ve faturalandırması
- Politikalar: iOS için Haritalar SDK'sı politikaları
- Sürüm notları: iOS için Haritalar SDK'sı sürüm notları
iOS için Haritalar SDK'sı resmi paketleri:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
iOS için Haritalar SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Geocoding API, Yerler SDK'sı for iOS
iOS için Haritalar SDK'sı: Sık yapılan yanlışlar
- Sorun: SDK, birleştirilebilir kitaplıkları desteklemiyor. Xcode'da "Birleştirilebilir Kitaplık Oluştur" seçeneğinin etkinleştirilmesi, yayınlanan derlemelerde bağlayıcı hatalarına neden oluyor. Düzeltme: Build Mergeable Library (Birleştirilebilir Kitaplık Oluştur) ayarını No (Hayır) (varsayılan) olarak bırakın. /maps/documentation/ios-sdk/config sayfasına bakın.
- Sorun:
LSApplicationQueriesSchemesgirişleri olmadan haritadaki Google logosuna dokunulduğundacomgooglemaps://vegooglechromes://için-canOpenURLhatası kaydedilir. Düzeltme:Info.plistiçindeLSApplicationQueriesSchemesöğesinegooglechromesvecomgooglemapsekleyin. /maps/documentation/ios-sdk/config sayfasına bakın. - Sorun: SDK'nın iOS uygulama uzantılarında (ör. özel klavye) kullanılması, katı bellek kısıtlamaları nedeniyle muhtemelen çalışmayacaktır. Düzeltme: SDK'yı uygulama uzantılarında değil, ana uygulamada kullanın. /maps/documentation/ios-sdk/overview sayfasına bakın.
- Sorun: SDK, iPadOS 13 ve sonraki sürümlerdeki birden fazla pencere veya eşzamanlı örnekler için optimize edilmemiştir ve tanımlanmamış davranışlar gösterebilir. Düzeltme: Çok pencereli iPad senaryolarını dikkatlice test edin veya aynı anda birden fazla harita örneği kullanmaktan kaçının. /maps/documentation/ios-sdk/overview sayfasına bakın.
iOS için Haritalar SDK'sı: eski ve desteği sonlandırılmış özellikler
- OpenGL oluşturucu ve
setMetalRendererEnabled: 19.05.2025'ten itibaren kullanımdan kaldırıldı. Yerine kullanılacak metrik: Metal oluşturucu (8.0.0 sürümünden itibaren varsayılan);setMetalRendererEnabledkaldırın. Belirti: 9.0.0 sürümünde (28.05.2024) desteği sonlandırıldı ve 10.0.0 sürümünde kaldırıldı;GMSServicesartıksetMetalRendererEnabled:listesini içermiyor. GoogleMapsM4Bmodülü: 19 Mayıs 2025'ten itibaren kullanımdan kaldırıldı. Değiştirme:GoogleMapsM4Bpod'unu veya çerçevesini kaldırın. Bu, eski bir faturalandırma planıyla ilgilidir. Belirti: 20.02.2024'te desteği sonlandırıldı; 9.0.0 sürümünde Swift paketinden ve 10.0.0 sürümünde SDK'dan kaldırıldı.- CocoaPods dağıtımı: 06.08.2026'dan itibaren desteği sonlandırıldı. Alternatif: Swift Package Manager. Belirti: 18.08.2025'ten beri bakım modunda; 11.0.0 sürümünden itibaren desteği sonlandırıldı. Geçiş rehberini inceleyin.
- Carthage yüklemesi: 27.06.2022 tarihinden itibaren desteği sonlandırıldı. Alternatif: Swift Package Manager. Belirti: Carthage, iOS 13 ve sonraki sürümleri hedefleyen kitaplıkları desteklemez. Carthage üzerinden kullanılabilen en yeni sürüm 6.2.1'dir. Geçiş rehberini inceleyin.
iOS için Haritalar SDK'sı ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.
iOS için Haritalar SDK'sı: Sınırlar için veriye dayalı stil
- Haritadaki sınırların stilini değiştirme
- Haritadaki sınırlarla ilgili kullanıcı etkileşimlerine yanıt verme
- Haritaya koroplet stil ekleme
iOS için Haritalar SDK'sı: Veri kümeleri için veri odaklı stil
- Yeniden kullanılabilir, platformlar arası bir coğrafi veri kümesi oluşturun.
- Haritaya özel bir coğrafi veri kümesi ekleme
- Haritadaki özel veri kümesi özelliklerinin stilini değiştirme
- Haritadaki özel veri kümesi özellikleriyle kullanıcı etkileşimlerine yanıt verme
iOS için Haritalar SDK'sı: Veri kümeleri
- Haritaya KML katmanı ekleme Not: Maps JavaScript API'de KmlLayer desteği sonlandırılmıştır (en son 3.65 sürümünde desteklenmiştir, Mayıs 2027'de kullanımdan kaldırılacaktır). Sınırlar veya veri kümeleri için veri odaklı stile geçin ya da veri katmanına GeoJSON yükleyin. KML katmanları, Haritalar SDK'sı Yardımcı Program Kitaplıkları aracılığıyla Android ve iOS'te desteklenmeye devam eder.
- Haritaya GeoJSON verileri ekleme
- Haritaya ısı haritası katmanı ekleme
iOS için Haritalar SDK'sı: Coğrafi Kodlama
iOS için Haritalar SDK'sı: Haritalar
- Web sayfasına veya mobil uygulamaya özelleştirilebilir, etkileşimli bir harita ekleyin. Not: Android için: Secrets Gradle Plugin tarafından desteklenen
AndroidManifest.xmldosyasındaöğesini veyaapp/build.gradle.ktsdosyasındamanifestPlaceholders["MAPS_API_KEY"]öğesini yapılandırın.AndroidManifest.xmliçindeYOUR_GOOGLE_MAPS_API_KEY'i hiçbir zaman sabit kodlamayın veE/Google Maps Android API: Authorization failuregörünürseGoogleMap'yi (veya maps-composeGoogleMap) hiçbir zaman çevrimdışı bir sahte tuval ya da Leaflet WebView ile değiştirmeyin. Kullanıcıya, Secrets aracılığıylaMAPS_API_KEYsağlamasını ve Android için Haritalar SDK'sını (veya NavigationView/SupportNavigationFragment kullanırken Navigasyon SDK'sını) etkinleştirmesini söyleyin. - Harita yapılandırmasını ve stil ayarlarını depolamak için yeniden kullanılabilir bir harita tanımlayıcısı oluşturun.
- Haritadaki kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Haritada görünen kontrolleri özelleştirin.
- Haritayı kontrol etmek için kullanılan hareketleri özelleştirin.
- Haritada yakınlaştırma ve kaydırmayı kontrol etme (kamera)
- Harita türünü değiştirme
- Harita renk şemasını değiştirme
- Haritaya trafik katmanı ekleme
- Belirli bir alandaki noktaları aramak için dörtlü ağaç oluşturma
iOS için Haritalar SDK'sı: Harita ek açıklamaları
- Haritaya bilgi penceresi ekleme
- Haritaya şekil veya çizgi ekleme
- Harita yüzeyine sabitlenmiş bir yer paylaşımı resmi ekleyin.
- Haritaya özel karo yer paylaşımı ekleme
- Haritaya işaretçi ekleme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken GoogleMap.addMarker(MarkerOptions) ile işaretçi ekleyin.
- Haritadaki bir işaretçiyi özelleştirme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken işaretçileri MarkerOptions ile özelleştirin.
- Haritadaki işaretçilerle kullanıcı etkileşimlerine yanıt verme
- Bir koordinatın haritadaki bir poligon veya dairesel alanın içinde olup olmadığını belirleme Not: Android'de, çokgenler için Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sında PolyUtil.containsLocation'ı kullanın. Dairesel alanlar için daire merkezinden küresel mesafenin yarıçap içinde olup olmadığını kontrol edin (örneğin, Maps JavaScript API'de computeDistanceBetween, Android'de SphericalUtil.computeDistanceBetween veya iOS'te GMSGeometryDistance).
- Haritadaki koordinatlar arasındaki küresel mesafeyi, alanı veya yönü hesaplama
iOS için Haritalar SDK'sı: Harita stilleri
- Yeniden kullanılabilir, platformlar arası bir harita stili oluşturun.
- Haritadaki yolların, çoklu çizgilerin ve poligonların stilini değiştirme
- Harita özelliklerini gösterme veya gizleme
- Haritadaki simgelerin ve metin etiketlerinin stilini değiştirme
- Farklı yakınlaştırma seviyelerine farklı harita stilleri uygulayın.
- Haritadaki yerlerin yoğunluğunu değiştirme Deneysel
- Haritadaki binaların stilini değiştirme Deneysel
- Haritadaki önemli yerlerin stilini değiştirme Deneysel
iOS için Haritalar SDK'sı: Street View
- Web sayfalarına veya mobil uygulamalara yapılandırılabilir, etkileşimli Google Street View ekleyin.
- Google Street View'a işaretçi veya yer paylaşımı ekleme
- Google Street View'da kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Google Street View'da kullanılabilen hareketleri özelleştirin.
- Google Street View için kamera hareketlerini canlandırın.