Genel bakış
Bu, iOS için Google Haritalar SDK'sının ana sınıfıdır ve haritayla ilgili tüm yöntemler için giriş noktasıdır.
Harita, kolaylık kurucusu [GMSMapViewmapWithFrame:camera:] aracılığıyla örneklenmelidir. Ayrıca, varsayılan [[GMSMapView alloc] initWithFrame:] yöntemiyle de oluşturulabilir (burada kamerası varsayılan bir konuma ayarlanır).
GMSMapView, tüm UIKit nesnelerine benzer şekilde yalnızca ana iş parçacığından okunabilir ve değiştirilebilir. Bu yöntemlerin başka bir ileti dizisinden çağrılması, bir istisnaya veya tanımsız davranışa neden olur.
Herkese Açık Üye İşlevleri | |
(ornektürü) | - initWithFrame:camera: |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
(ornektü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şturma'yı başlatma |
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 dahil olmak üzere haritaya eklenen tüm işaretlemeleri temizler. | |
(geçersiz) | - setMinZoom:maxZoom: |
minZoom ve maxZoom değerlerini ayarlar. | |
(null GMSKameraPosition *) | - cameraForBounds:insets: |
bounds değerini padding ile sunan bir GMSKameraPosition oluşturun. | |
(geçersiz) | - moveKamera: |
Kamerayı update ayarına göre değiştirir. | |
(BOOL) | - areEqualForCreationPosition:konum: |
Belirli bir kamera konumunun pratikte aynı kameranın oluşturulmasına neden olup olmayacağını, dahili olarak kullanılan doğruluk düzeyini ve dönüşümleri göz önünde bulundurarak kontrol edin. | |
(geçersiz) | - animateToKameraKonumu: |
Bu haritanın kamerasına cameraPosition animasyonu. | |
(geçersiz) | - animateToLocation: |
animasyonToKameraKonumu olarak: Yalnızca kameranın konumunu değiştirir (ör. geçerli konumdan location değerine). | |
(geçersiz) | - animateToZoom: |
animasyonluToKameraPosition olarak: ancak kameranın yalnızca yakınlaştırma düzeyini değiştirir. | |
(geçersiz) | - animateToBearing: |
AnimasyonToKameraKonumu olarak: ancak kameranın konumunu değiştirir (derece cinsinden). | |
(geçersiz) | - animateToViewingAngle: |
AnimasyonToKameraKonumu olarak: ancak kameranın yalnızca görüş açısını değiştirir (derece cinsinden). | |
(geçersiz) | - animateWithKameraUpdate: |
cameraUpdate öğesini geçerli kameraya uygular ve daha sonra sonucu animasyonu ToToPosition konumuna göre kullanır: | |
Statik Genel Üye İşlevleri | |
(ornektürü) | + mapWithFrame:camera: |
Çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
(ornektürü) | + mapWithFrame:mapID:camera: |
Çerçeve, harita kimliği ve kamera hedefiyle bir harita görünümü oluşturup döndürmek için kullanışlı başlatıcı. | |
Özellikler | |
IBOutlet kimliği< GMSMapViewAuth > | yetki ver |
GMSMapView yetkilisi. | |
GMSKameraKonumu * | kamera |
Haritanın yönü olan kamerayı kontrol eder. | |
GMSProjection * | projeksiyon |
Ekran koordinatları ve enlem/boylam koordinatları arasında geçiş yapmak için kullanabileceğiniz bir GMSProjection nesnesi döndürür. | |
ARA | myLocationEnabled |
Konumum noktasının ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder. | |
CLLocation * | Konumum |
Konumum özelliği etkinse cihazın konum noktasının nerede çekildiğini gösterir. | |
GMSMarker * | seçili Marker |
Seçili işaretçi. | |
ARA | trafficEnabled |
Varsa, trafik verilerini çekip çekmediğini kontrol eder. | |
GMSMapViewType | eşleme türü |
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 (kameranın en uzak olabileceği nokta). | |
kayan noktalı | maksZoom |
Maksimum yakınlaştırma (kameraya en yakın kamera olabilir). | |
ARA | binalar Etkin |
Ayarlanırsa 3D binalar mümkün olduğunda gösterilir. | |
ARA | indoorEnabled |
Kullanılabilir olduğunda iç mekan haritalarının gösterilip gösterilmeyeceğini belirler. | |
GMSIndoorDisplay * | iç mekan ekranı |
İç mekan verilerinin görüntülenmesinin belirli yönlerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır. | |
GMSUISettings * | ayarlar |
Haritanın 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. | |
GMSMapViewPusingadjustBehavior | filladjustBehavior |
Dolgu alanlarına güvenli alan girişlerinin nasıl ekleneceğini kontrol eder. | |
ARA | accessibilityElementsHidden |
Varsayılan olarak YES değerine ayarlanır. | |
GMSMap Katman * | katman |
Katman için kullanılan özel CAKatman türünün erişimcisi. | |
GMSFrameRate | tercih edilen kare hızı |
Oluşturma kare hızını kontrol eder. | |
GMSordBounds * | cameraTargetBounds |
Boş değilse kamera hedefini sınırlandırarak hareketlerin belirtilen sınırları bırakmasına neden olmaz. | |
GMSMapCapabilityFlags | mapCapabilities |
Geçerli olarak o an için kullanılabilen tüm koşullu olarak kullanılabilen (mapID veya diğer harita ayarlarına bağlıdır) özellikler. | |
İlgili İşlevler | |
(Bunların üye işlevleri olmadığını unutmayın.) | |
NSString *konst. | kGMSAccessibilityCompass |
Pusula düğmesinin erişilebilirlik tanımlayıcısı. | |
NSString *konst. | kGMSAccessibilityMyLocation |
"Konumum" düğmesinin erişilebilirlik tanımlayıcısı. | |
NSString *konst. | kGMSAccessibilityOutOfQuota |
"Kota kalmadı" hata etiketi için erişilebilirlik tanımlayıcısı. |
Üye İşlevi Dokümanları
+ (örnek 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.
+ (örnek türü)mapWithFrame: | (CGRect) | çerçeve | |
eşleme kimliği: | (GMSMapID *) | eşleme kimliği | |
kamera: | (GMSKameraKonumu *) | kamera | |
Çerçeve, harita kimliği ve kamera hedefiyle bir harita görünümü oluşturup döndürmek için kullanışlı başlatıcı.
- (ornektype) 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.
- (ornektype) initWithFrame: | (CGRect) | çerçeve | |
eşleme kimliği: | (GMSMapID *) | eşleme kimliği | |
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) Startrender |
Bu haritaya oluşturucuyu açmasını söyler.
Bu işlem isteğe bağlıdır ve aynıdır.
- Not:
- Bu özellik kullanımdan kaldırılmıştır. Bu yöntem artık kullanılmıyor ve gelecekteki bir sürümde kaldırılacak.
- (geçersiz) Oluşturmayı durdur |
Bu haritaya oluşturucuyu kapatmasını söyler.
Bu işlem isteğe bağlıdır ve aynıdır.
- Not:
- Bu özellik kullanımdan kaldırılmıştır. Bu yöntem artık kullanılmıyor ve gelecekteki bir sürümde kaldırılacak.
- (geçersiz) açık |
İşaretçiler, çoklu çizgiler ve zemin bindirmeleri dahil olmak üzere haritaya eklenen tüm işaretlemeleri temizler.
Bu işlem, görünür 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
değerlerini ayarlar.
Bu yöntem, minimum değerin maksimum değerden küçük veya maksimum değere eşit olmasını bekler ve aksi halde NSRangeException adında bir istisna oluşturur.
- (null GMSKameraPosition *) CameraForBounds: | (GMSordBounds *) | sınırlar | |
girintiler: | (UIEdgeInsets) | içedeler | |
bounds
değerini padding
ile sunan bir GMSKameraPosition oluşturun.
Kameranın sıfır eğimi ve eğimi olur (yani, kuzeye bakar ve doğrudan Dünya'ya bakar). Burada, bu GMSMapView'ın çerçevesi ve dolgusu dikkate alınır.
Sınırlar geçersizse bu yöntem boş bir kamera döndürür.
- (geçersiz) moveKamera: | (GMSKameraUpdate *) | güncelle |
Kamerayı update
ayarına göre değiştirir.
Kamera değişikliği anında (animasyonsuz).
- (BOOL) areEqualForrenderPosition: | (GMSKameraKonumu *) | konumu | |
konum: | (GMSKameraKonumu *) | otherPosition | |
Belirli bir kamera konumunun pratikte aynı kameranın oluşturulmasına neden olup olmayacağını, dahili olarak kullanılan doğruluk düzeyini ve dönüşümleri göz önünde bulundurarak kontrol edin.
- (geçersiz) animateToKameraPosition: | (GMSKameraKonumu *) | cameraKonumu |
Bu haritanın kamerasına cameraPosition
animasyonu.
- (geçersiz) animateToLocation: | (CLLocationord2D) | 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ırma |
animasyonluToKameraPosition olarak: ancak kameranın yalnızca yakınlaştırma düzeyini değiştirir.
Bu değer, [kGMSMinZoomLevel, kGMSMaxZoomLevel] tarafından sabitlenir.
- (geçersiz) animateToBearing: | (CLLocationDirection) | taşımak |
AnimasyonToKameraKonumu olarak: ancak kameranın konumunu değiştirir (derece cinsinden).
Sıfır, gerçek kuzeyi belirtir.
- (geçersiz) animateToViewingAngle: | (çift) | Görüntüleme Angle |
AnimasyonToKameraKonumu olarak: ancak kameranın yalnızca görüş açısını değiştirir (derece cinsinden).
Bu değer, dünyaya göre göreli yakınlığına bağlı olarak, en az sıfıra (ör. tam aşağı) ve ufuk boyunca 30-45 derece arasında olacak şekilde sabitlenir.
- (geçersiz) animateWithKameraUpdate: | (GMSKameraUpdate *) | cameraUpdate |
cameraUpdate
öğesini geçerli kameraya uygular ve daha sonra sonucu animasyonu ToToPosition konumuna göre kullanır:
Arkadaşlar ve İlgili İşlev Dokümanları
- (NSString* const) kGMSAccessibilityCompass [related] |
Pusula düğmesinin erişilebilirlik tanımlayıcısı.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
"Konumum" düğmesinin erişilebilirlik tanımlayıcısı.
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
"Kota kalmadı" hata etiketi için erişilebilirlik tanımlayıcısı.
Mülk Dokümanları
- (IBOutlet kimliği<GMSMapViewAuth>) yetki verin [read, write, assign] |
GMSMapView yetkilisi.
- (GMSKameraPosition*) kamera [read, write, copy] |
Haritanın yönü olan kamerayı kontrol eder.
Bu özelliğin değiştirilmesi anında gerçekleşir.
- (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 simge, son çizilen GMSMapView çerçevesinin projeksiyonunu veya kameranın açıkça ayarlandığı ya da haritanın yeni oluşturulduğu kareyi temsil eder. Asla nötr olmaz.
- (BOOL) myLocationEnabled [read, write, assign] |
Konumum noktasının ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder.
Varsayılan olarak hayır değerine ayarlanır.
- (CLLocation*) benim konumum [read, assign] |
Konumum özelliği etkinse cihazın konum noktasının nerede çekildiğini gösterir.
Bu özellik devre dışıysa veya etkinse ancak konum verisi yoksa bu durum geçerli olmaz. Bu mülk, KVO kullanılarak gözlemlenebilir.
- (GMSMarker*) selectMarker [read, write, assign] |
Seçili işaretçi.
Bu özelliğin ayarlanması belirli bir işaretçiyi seçer ve bunun üzerinde bir bilgi penceresi gösterir. Bu özellik nil değilse, nil değerine ayarlanırsa işaretçinin seçimi kaldırılır ve bilgi penceresi gizlenir. Bu mülk, KVO kullanılarak gözlemlenebilir.
- (BOOL) trafficEnabled [read, write, assign] |
Varsa, trafik verilerini çekip çekmediğini kontrol eder.
Bu durum, trafik verilerinin kullanılabilirliğine tabidir. Varsayılan olarak hayır 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 (kameranın en uzak olabileceği nokta).
Varsayılan olarak kGMSMinZoomLevel'a ayarlanır. -setMinZoom:maxZoom: ile değiştirildi.
- (kayan) maxZoom [read, assign] |
Maksimum yakınlaştırma (kameraya en yakın kamera olabilir).
Varsayılan olarak kGMSMaxZoomLevel'a ayarlanır. -setMinZoom:maxZoom: ile değiştirildi.
- (BOOL) binalar etkinleştirildi [read, write, assign] |
Ayarlanırsa 3D binalar mümkün olduğunda gösterilir.
Varsayılan olarak YES değerine ayarlanır.
Bu, yüksek yakınlaştırma düzeylerinde daha net olması için haritaya özel bir karo katmanı eklerken yararlı olabilir. Bu değerin değiştirilmesi tüm karoların kısa bir 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 belirler.
Varsayılan olarak YES değerine ayarlanır.
Bu ayar 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 verilerinin görüntülenmesinin belirli yönlerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır.
- (GMSUISettings*) ayarlar [read, assign] |
Haritanın 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 verilerini içeren ancak kullanıcı arayüzü kontrollerini içermeyen bir alan oluşturulabilir.
Dolgu dengeli değilse görünümün görsel merkezi uygun şekilde hareket eder. Dolgu, projection
özelliğini de etkiler. Bu nedenle, görünür bölge, dolgu alanını içermez. GMSKameraUpdate fitToBounds hem bu dolgunun hem de istenen herhangi bir dolgunun dikkate alınmasını sağlar.
Bu özellik, UIView tabanlı bir animasyon bloğu içinde animasyonlu olabilir.
- (GMSMapViewPusingadjustBehavior) filladjustBehavior [read, write, assign] |
Dolgu alanlarına güvenli alan girişlerinin nasıl ekleneceğini kontrol eder.
Dolgu gibi güvenli alanlar da pusula, konum düğmem ve cihaz güvenli alanındaki yer seçici gibi harita kontrollerini konumlandırır.
Varsayılan olarak kGMSMapViewPusingadjustBehaviorBehaviorHer zaman olarak ayarlanır.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Varsayılan olarak YES 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 hariç olmak üzere, resmi olmayan Kullanıcı Arayüzü Erişilebilirlik protokolüne uyar.
- (GMSMapLayer*) katman [read, retain] |
Katman için kullanılan özel CAKatman türünün erişimcisi.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Oluşturma kare hızını kontrol eder.
Varsayılan değer kGMSFrameRateMax.
- (GMSordBounds*) cameraTargetBounds [read, write, assign] |
Boş değilse kamera hedefini sınırlandırarak hareketlerin belirtilen sınırları bırakmasına neden olmaz.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Geçerli olarak o an için kullanılabilen tüm koşullu olarak kullanılabilen (mapID veya diğer harita ayarlarına bağlıdır) özellikler.
Her zaman kullanılabilen özellikleri içermez.