Genel bakış
Bu, iOS için Google Haritalar SDK'sının ana sınıfıdır ve haritayla ilgili tüm yöntemlerin giriş noktasıdır.
Harita, kolaylık kurucusu [GMSMapView MapWithFrame:camera:] aracılığıyla örneklenmelidir. Ayrıca, varsayılan [[GMSMapView alloc] initWithFrame:] yöntemiyle de oluşturulabilir (burada kamera varsayılan bir konum olarak ayarlanır).
GMSMapView, tüm UIKit nesnelerine benzer şekilde yalnızca ana ileti dizisinden okunabilir ve değiştirilebilir. Bu yöntemlerin başka bir mesaj dizisinden çağrılması, bir istisnaya veya tanımsız davranışa neden olur.
Genel Üye İşlevleri | |
(ornek türü) | - initWithFrame:camera: |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
(ornek türü) | - initWithFrame:mapID:camera: |
Çerçeve, harita kimliği ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
(geçersiz) | - Oluşturmaya başlayın |
Bu haritaya oluşturucuyu açmasını söyler. | |
(geçersiz) | - Oluşturmayı durdur |
Bu haritaya oluşturucuyu kapatmasını söyler. | |
(geçersiz) | - açık |
İşaretçiler, çoklu çizgiler ve zemin bindirmeleri de dahil olmak üzere haritaya eklenen tüm işaretlemeleri temizler. | |
(geçersiz) | - setMinZoom:maxZoom: |
minZoom ve maxZoom özelliklerini ayarlar. | |
(null, GMSKameraPosition *) | - cameraForBounds:insets: |
padding ile bounds sunan bir GMSKameraKonumu oluşturun. | |
(geçersiz) | - moveKamera: |
Kamerayı şu şekilde değiştirir: update | |
(BOOL) | - areEqualForrenderPosition:position: |
Belirtilen kamera konumlarının, dahili olarak kullanılan kesinlik düzeyini ve dönüşümleri dikkate alarak kameranın neredeyse aynı şekilde oluşturulmasına neden olup olmayacağını kontrol edin. | |
(geçersiz) | - animateToKameraKonumu: |
Bu haritanın kamerasına cameraPosition animasyon uygular. | |
(geçersiz) | - animateToLocation: |
animasyonToKameraKonumu: Yalnızca kameranın konumunu değiştirir (ör. geçerli konumdan location değerine). | |
(geçersiz) | - animateToZoom: |
animasyonToKameraKonumu: olarak yalnızca kameranın yakınlaştırma düzeyini değiştirir. | |
(geçersiz) | - animateToBearing: |
animasyonToKameraKonumu olarak: Ancak yalnızca kameranın konumunu değiştirir (derece cinsinden). | |
(geçersiz) | - animateToViewingAngle: |
animasyonToKameraKonumu olarak: Yalnızca kameranın görüntüleme açısını (derece cinsinden) değiştirir. | |
(geçersiz) | - animateWithKameraUpdate: |
cameraUpdate öğesini geçerli kameraya uygular ve daha sonra, sonucu animasyonToKameraKonumu'na göre kullanır: | |
Statik Genel Üye İşlevleri | |
(ornek türü) | + mapWithFrame:camera: |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
(ornek türü) | + mapWithFrame:mapID:camera: |
Çerçeve, harita kimliği ve kamera hedefine sahip bir harita görünümü oluşturup döndürmek için uygun başlatıcı. | |
Tesisler | |
IBOutlet kimliği< GMSMapViewAuth > | yetki ver |
GMSMapView yetkisini verin. | |
GMSKameraKonumu * | kamera |
Haritayı nasıl yönlendirdiğini tanımlayan kamerayı kontrol eder. | |
GMSProjection * | projek |
Ekran koordinatları ve enlem/boylam koordinatları arasında geçiş yapmak için kullanabileceğiniz bir GMSProjection nesnesi döndürür. | |
BOL | myLocationEnabled |
Konumum noktasının ve doğruluk çemberinin etkinleştirilip etkinleştirilmediğini kontrol eder. | |
CLLocation * | yerim |
Konumum özelliği etkinse kullanıcı konum noktasının nerede çizildiğini gösterir. | |
GMSMarker * | selectMarker |
Seçilen işaretçi. | |
BOL | trafficEnabled |
Varsa, haritanın trafik verilerini çekip çekmediğini kontrol eder. | |
GMSMapViewType | mapType |
Görüntülenmesi gereken harita bloklarının türünü kontrol eder. | |
GMSMapStyle * | mapStyle |
Haritanın stilini kontrol eder. | |
kayan noktalı | minZoom |
Minimum yakınlaştırma (kamera en uzak olabilir). | |
kayan noktalı | maxZoom |
Maksimum yakınlaştırma (kamera, Dünya'ya en yakın olabilir). | |
BOL | binalar Etkin |
Ayarlanırsa 3D binalar mümkün olduğunda gösterilir. | |
BOL | içerişim Etkin |
Kullanılabilir olduğunda iç mekan haritalarının gösterilip gösterilmeyeceğini ayarlar. | |
GMSIndoorDisplay * | iç mekan görüntülü reklamcılık |
İç mekan veri görünümünün özelliklerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır. | |
GMSUISettings * | ayarlar |
Haritaya ilişkin kullanıcı arayüzü ayarlarını kontrol eden GMSUISettings nesnesini alır. | |
UIEdgeInsets | dolgu |
Görünümün "görünür" bölgesini kontrol eder. | |
GMSMapViewP tanınma Ayarlaması | DolguDüzenleme Davranışı |
Dolgu değerlerine güvenli alan uzantılarının nasıl ekleneceğini kontrol eder. | |
BOL | accessibilityElementsHidden |
Varsayılan olarak EVET değerine ayarlanır. | |
GMSMapKatman * | katman |
Katman için kullanılan özel CAKatman türüne yönelik erişimci. | |
GMSFrameRate | preferredFrameRate |
Oluşturma kare hızını kontrol eder. | |
GMSKoordinatörler * | kameraHedefBound'ları |
Sıfır değilse kamera hedefini, hareketlerin belirtilen sınırlardan ayrılmasına neden olmayacak şekilde kısıtlar. | |
İlgili İşlevler | |
(Bunların üye işlevleri olmadığını unutmayın.) | |
NSString *konsol | kGMSAccessibilityMyLocation |
"Konumum" düğmesinin erişilebilirlik tanımlayıcısı. |
Üye İşlevi Belgeleri
+ (ornek türü) MapWithFrame: | (CGRect) | çerçeve | |
kamera: | (GMSKameraKonumu *) | kamera | |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür.
+ (ornek türü) MapWithFrame: | (CGRect) | çerçeve | |
eşleme kimliği: | (GMSMapID *) | mapID | |
kamera: | (GMSKameraKonumu *) | kamera | |
Çerçeve, harita kimliği ve kamera hedefine sahip bir harita görünümü oluşturup döndürmek için uygun başlatıcı.
- (ornek türü) initWithFrame: | (CGRect) | çerçeve | |
kamera: | (GMSKameraKonumu *) | kamera | |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür.
- (ornek türü) initWithFrame: | (CGRect) | çerçeve | |
eşleme kimliği: | (GMSMapID *) | mapID | |
kamera: | (GMSKameraKonumu *) | kamera | |
Çerçeve, harita kimliği ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür.
- (geçersiz) oluşturmaya başlama |
Bu haritaya oluşturucuyu açmasını söyler.
Bu işlem isteğe bağlıdır ve aynı değildir.
- Not:
- Bu kullanımdan kaldırılmıştır. Bu yöntem eskidir ve gelecekteki bir sürümde kaldırılacaktır.
- (geçersiz) Oluşturmayı durdurma |
Bu haritaya oluşturucuyu kapatmasını söyler.
Bu işlem isteğe bağlıdır ve aynı değildir.
- Not:
- Bu kullanımdan kaldırılmıştır. Bu yöntem eskidir ve gelecekteki bir sürümde kaldırılacaktır.
- (geçersiz) açık |
İşaretçiler, çoklu çizgiler ve zemin bindirmeleri de dahil olmak üzere haritaya eklenen tüm işaretlemeleri temizler.
Bu işlem, görünen konum noktasını temizlemez veya mevcut eşleme türünü sıfırlamaz.
- (geçersiz) setMinZoom: | (kayan) | minZoom | |
maxZoom: | (kayan) | maxZoom | |
minZoom
ve maxZoom
özelliklerini ayarlar.
Bu yöntem, minimum değerin maksimum değerden küçük veya bu değere eşit olmasını bekler. Aksi takdirde, NSRangeException adında bir istisna oluşturur.
- (null GMSKameraPosition *) kameraForBounds: | (GMS KoordinatörBound'ları *) | sınırlar | |
ekler: | (UIEdgeInsets) | iç içe | |
padding
ile bounds
sunan bir GMSKameraKonumu oluşturun.
Kameranın yatağı ve eğimleri sıfır olur (yani kuzeye doğru bakıp doğrudan Dünya'ya bakabilir). Bu, bu GMSMapView'un çerçevesini ve dolgusunu dikkate alır.
Sınırlar geçersizse bu yöntem boş bir kamera döndürür.
- (geçersiz) moveKamera: | (GMSKameraGüncelleme *) | güncelle |
Kamerayı şu şekilde değiştirir: update
Kamera değişikliği anında (animasyon olmadan).
- (BOOL) areEqualForrenderPosition: | (GMSKameraKonumu *) | konumu | |
konum: | (GMSKameraKonumu *) | otherPosition | |
Belirtilen kamera konumlarının, dahili olarak kullanılan kesinlik düzeyini ve dönüşümleri dikkate alarak kameranın neredeyse aynı şekilde oluşturulmasına neden olup olmayacağını kontrol edin.
- (geçersiz) animateToKameraPosition: | (GMSKameraKonumu *) | kamera konumu |
Bu haritanın kamerasına cameraPosition
animasyon uygular.
- (geçersiz) animateToLocation: | (CLLocation Koordinatör2D) | konum |
animasyonToKameraKonumu olarak: Yalnızca kameranın konumunu değiştirir (ör. geçerli konumdan location
değerine).
- (geçersiz) animateToZoom: | (kayan) | yakınlaştır |
animasyonToKameraKonumu: olarak yalnızca kameranın yakınlaştırma düzeyini değiştirir.
Bu değer, [kGMSMinZoomLevel, kGMSMaxZoomLevel] tarafından sabitlenmiş.
- (geçersiz) animateToBearing: | (CLLocationDirection) | kuzu |
animasyonToKameraKonumu olarak: Ancak yalnızca kameranın konumunu değiştirir (derece cinsinden).
Sıfır, gerçek kuzeyi belirtir.
- (geçersiz) animateToViewingAngle: | (çift) | anlama |
animasyonToKameraKonumu olarak: Yalnızca kameranın görüntüleme açısını (derece cinsinden) değiştirir.
Bu değer, dünyaya göre göreli yakınlığına bağlı olarak en az sıfıra (yani düz aşağı bakacak şekilde) ve ufuk için 30 ila 45 derece sabitlenir.
- (geçersiz) animateWithKameraUpdate: | (GMSKameraGüncelleme *) | cameraUpdate |
cameraUpdate
öğesini geçerli kameraya uygular ve daha sonra, sonucu animasyonToKameraKonumu'na göre kullanır:
Arkadaşlar ve İlgili İşlev Dokümanları
- (NSString* const) kGMSAccessibilityMyLocation [related] |
"Konumum" düğmesinin erişilebilirlik tanımlayıcısı.
Mülk Dokümanları
- (IBOutlet kimliği<GMSMapViewAuth>) yetki ver [read, write, assign] |
GMSMapView yetkisini verin.
- (GMSKameraKonumu*) kamera [read, write, copy] |
Haritayı nasıl yönlendirdiğini tanımlayan kamerayı kontrol eder.
Bu mülkte anında değişiklik yapıldı.
- (GMSProjection*) projeksiyon [read, assign] |
Ekran koordinatları ve enlem/boylam koordinatları arasında geçiş yapmak için kullanabileceğiniz bir GMSProjection nesnesi döndürür.
Bu, mevcut projeksiyonun anlık görüntüsüdür ve kamera hareket ettiğinde otomatik olarak güncellenmez. Bu tablo, son çizilen GMSMapView çerçevesinin tahminini ya da kameranın açıkça ayarlandığı veya harita oluşturulan yeni kareyi temsil eder. Hiçbir zaman boş kalamaz.
- (BOOL) myLocationEnabled [read, write, assign] |
Konumum noktasının ve doğruluk çemberinin etkinleştirilip etkinleştirilmediğini kontrol eder.
Varsayılan olarak HAYIR değerine ayarlanır.
- (CLLocation*) myLocation [read, assign] |
Konumum özelliği etkinse kullanıcı konum noktasının nerede çizildiğini gösterir.
Bu özellik devre dışıysa veya etkinleştirilmişse ancak konum verileri yoksa boş. Bu mülk, KVO kullanılarak gözlemlenebilir.
- (GMSMarker*) selectMarker [read, write, assign] |
Seçilen işaretçi.
Bu özelliğin ayarlanması belirli bir işaretçiyi seçer ve işaretçiyi üzerinde bilgi penceresi gösterir. Bu özellik nil değilse, değerin sıfır olarak ayarlanması işaretçinin seçimini kaldırarak bilgi penceresini gizler. Bu mülk, KVO kullanılarak gözlemlenebilir.
- (BOOL) trafficEnabled [read, write, assign] |
Varsa, haritanın trafik verilerini çekip çekmediğini kontrol eder.
Bu durum, trafik verilerinin kullanılabilirliğine bağlıdır. Varsayılan olarak HAYIR değerine ayarlanır.
- (GMSMapViewType) mapType [read, write, assign] |
Görüntülenmesi gereken harita bloklarının türünü kontrol eder.
Varsayılan olarak kGMSTypeNormal değerine ayarlanır.
- (GMSMapStyle*) mapStyle [read, write, assign] |
Haritanın stilini kontrol eder.
Sıfır olmayan eşleme stili yalnızca eşleme türü Normal ise uygulanır.
- (kayan) minZoom [read, assign] |
Minimum yakınlaştırma (kamera en uzak olabilir).
Varsayılan olarak kGMSMinZoomLevel'dır. -setMinZoom:maxZoom: ile değiştirildi.
- (kayan) maxZoom [read, assign] |
Maksimum yakınlaştırma (kamera, Dünya'ya en yakın olabilir).
Varsayılan olarak kGMSMaxZoomLevel'dır. -setMinZoom:maxZoom: ile değiştirildi.
- (BOOL) binalar Etkin [read, write, assign] |
Ayarlanırsa 3D binalar mümkün olduğunda gösterilir.
Varsayılan olarak EVET değerine ayarlanır.
Bu, yüksek yakınlaştırma düzeylerinde daha net olması için haritaya özel karo katmanı eklerken yararlı olabilir. Bu değerin değiştirilmesi tüm blokların kısa süre önce geçersiz kılınmasına neden olur.
- (BOOL) indoorEnabled [read, write, assign] |
Kullanılabilir olduğunda iç mekan haritalarının gösterilip gösterilmeyeceğini ayarlar.
Varsayılan olarak EVET değerine ayarlanır.
Bu değer NO değerine ayarlanırsa iç mekan verilerinin önbellekleri tamamen silinebilir ve son kullanıcı tarafından seçili olan tüm tabanlar sıfırlanabilir.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
İç mekan veri görünümünün özelliklerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır.
- (GMSUISettings*) ayarlar [read, assign] |
Haritaya ilişkin kullanıcı arayüzü ayarlarını kontrol eden GMSUISettings nesnesini alır.
- (UIEdgeInsets) dolgu [read, write, assign] |
Görünümün "görünür" bölgesini kontrol eder.
Dolgu uygulandığında, görünümün kenarının çevresinde bir alan oluşturulabilir. Bu alan, harita verilerini içerir ancak kullanıcı arayüzü kontrollerini içermez.
Dolgu dengeli değilse görünümün görsel merkezi uygun şekilde hareket eder. Dolgu, projection
özelliğini de etkilediğinden görünür bölge, dolgu alanını içermez. GMSKameraUpdate fitToBounds, hem bu dolgunun hem de istenen dolgunun dikkate alınmasını sağlar.
Bu özellik, UIView tabanlı bir animasyon bloğu içinde animasyonlu olabilir.
- (GMSMapViewP tanınma Ayarlaması Davranışı) filladjustDavranış [read, write, assign] |
Dolgu değerlerine güvenli alan uzantılarının nasıl ekleneceğini kontrol eder.
Dolgu gibi, güvenli alan da pusula, konum düğmem ve cihaz güvenli alanı içindeki kat seçici gibi konum haritası denetimlerini içerir.
Varsayılan olarak kGMSMapViewP tanınma Ayarlaması Her Zaman değerine ayarlanır.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Varsayılan olarak EVET değerine ayarlanır.
Hayır değerine ayarlanırsa GMSMapView, GMSMarker ve GMSPolyline gibi yer paylaşımlı nesneler için erişilebilirlik öğeleri oluşturur.
Bu özellik, varsayılan YES değeri dışında gayriresmi UIAcessibility protokolüne göre hazırlanmıştır.
- (GMSMapLayer*) katman [read, retain] |
Katman için kullanılan özel CAKatman türüne yönelik erişimci.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Oluşturma kare hızını kontrol eder.
Varsayılan değer kGMSFrameRateMaksimum'dır.
- (GMS KoordinatörBound*) cameraTargetBounds [read, write, assign] |
Sıfır değilse kamera hedefini, hareketlerin belirtilen sınırlardan ayrılmasına neden olmayacak şekilde kısıtlar.