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, -init veya -initWithOptions: oluşturucularından biriyle örneklenmelidir.
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 iş parçacığından çağrılması, bir istisnaya veya tanımlanmamış davranışa neden olur.
Ortak Üye İşlevleri | |
| (instancetype) | - init |
| CGRectZero ve varsayılan seçenekler ile başlar. | |
| (instancetype) | - initWithOptions: |
| Verilen seçeneklerle yeni bir harita görünümü oluşturur. | |
| (instancetype) | - initWithFrame: |
| (nullable örnek türü) | - initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| Bir çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| Bir çerçeve, harita kimliği ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür. | |
| (void) | - startRendering |
| Bu haritaya, oluşturucusunu güçlendirmesini söyler. | |
| (void) | - stopRendering |
| Bu haritaya oluşturucuyu kapatmasını söyler. | |
| (void) | - temiz |
| İşaretçiler, çoklu çizgiler ve zemin bindirmeleri dahil olmak üzere haritaya eklenen tüm işaretlemeleri temizler. | |
| (void) | - setMinZoom:maxZoom: |
minZoom ve maxZoom ayarlarını yapar. | |
| (nullable GMSCameraPosition *) | - cameraForBounds:insets: |
bounds öğesini padding ile sunan bir GMSCameraPosition oluşturun. | |
| (void) | - moveKamera: |
Kamerayı update politikasına göre değiştirir. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Belirtilen kamera konumlarının kameranın pratikte aynı şekilde oluşturulmasına neden olup olmadığını kontrol edin. Dahili olarak kullanılan hassasiyet düzeyi ve dönüştürme işlemleri hesaba katılır. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureKatmanOfFeatureType: |
| Belirtilen türden bir özellik katmanı döndürür. | |
| (GMSDatasetFeatureLayer *) | - datasetFeaturelayerOfDatasetID: |
| Belirtilen veri kümesinin veri kümesi özellik katmanını döndürür. | |
| (void) | - animateToCameraPosition: |
Bu haritanın kamerasını cameraPosition konumuna getirir. | |
| (void) | - animateToLocation: |
animasyonluToKameraKonumu olarak: ancak yalnızca kameranın konumunu değiştirir (ör. geçerli konumdan location olarak). | |
| (void) | - animateToZoom: |
| AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın yakınlaştırma düzeyini değiştirir. | |
| (void) | - animateToBearing: |
| AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın yer yönünü değiştirir (derece cinsinden). | |
| (void) | - animateToViewingAngle |
| AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın görüntüleme açısını değiştirir (derece cinsinden). | |
| (void) | - animateWithCameraUpdate: |
Geçerli kameraya cameraUpdate uygular ve ardından, sonucuGIFTo CameraPosition: parametresine göre kullanır. | |
Statik Genel Üye İşlevleri | |
| (instancetype) | + mapWithFrame:camera: |
| Bir çerçeve ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür. | |
| (instancetype) | + 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ı. | |
Mülkler | |
| IBOutlet kimliği< GMSMapViewDelegate > | yetki ver |
| GMSMapView temsilcisi. | |
| GMSCameraPosition * | kamera |
| Haritanın yönünü belirleyen kamerayı kontrol eder. | |
| GMSProjection * | projeksiyon |
| Ekran koordinatları ile enlem/boylam koordinatları arasında dönüştürme yapmak için kullanabileceğiniz bir GMSProjection nesnesi döndürür. | |
| BOOL | myLocationEnabled |
| Konumum noktasının ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder. | |
| CLLocation * | myLocation |
| Konumum etkinse cihaz konum noktasının nerede çizildiğini gösterir. | |
| GMSMarker * | selectedMarker |
| Seçilen işaretçi. | |
| BOOL | trafficEnabled |
| Haritanın (varsa) trafik verileri çizip çizdiğini kontrol eder. | |
| GMSMapViewType | mapType |
| Görüntülenmesi gereken harita parçalarının türünü denetler. | |
| GMSMapStyle * | mapStyle |
| Haritanın stilini kontrol eder. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Haritayı istediğiniz UIUserInterfaceStyle olarak değiştirin. | |
| float | minZoom |
| Minimum yakınlaştırma (kameranın uzaklaştırılabileceği en uzak mesafe). | |
| float | maxZoom |
| Maksimum yakınlaştırma (kamera, Dünya'ya en yakın olabilir). | |
| BOOL | buildingsEnabled |
| Ayarlanırsa, mümkün olduğunda 3D binalar gösterilir. | |
| BOOL | indoorEnabled |
| İç mekan haritalarının (kullanılabilir olduğunda) gösterilip gösterilmeyeceğini ayarlar. | |
| GMSIndoorDisplay * | indoorDisplay |
| İç mekan veri ekranının özelliklerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır. | |
| GMSUISettings * | ayarlar |
| Harita için 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. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Güvenli alan eklerinin dolgu değerlerine nasıl ekleneceğini kontrol eder. | |
| BOOL | accessibilityElementsHidden |
| Varsayılan olarak EVET değerine ayarlanır. | |
| GMSMapLayer * | katman |
| Katman için kullanılan özel CAKatman türüne erişimci. | |
| GMSFrameRate | preferredFrameRate |
| Oluşturma kare hızını kontrol eder. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Sıfır değilse kamera hedefini, hareketler belirtilen sınırların dışına çıkmasına neden olmayacak şekilde kısıtlar. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Şu anda geçerli olan ve koşullu olarak kullanılabilen (mapID'ye veya diğer harita ayarlarına bağlıdır) tüm özellikler. | |
İlgili İşlevler | |
(Bunların üye işlevleri olmadığını unutmayın.) | |
| NSString *const | kGMSAccessibilityCompass |
| Pusula düğmesi için erişilebilirlik tanımlayıcısı. | |
| NSString *const | kGMSAccessibilityMyLocation |
| "Konumum" düğmesi için erişilebilirlik tanımlayıcısı. | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| "Kota doldu" hata etiketi için erişilebilirlik tanımlayıcısı. | |
Üye İşlevi Belgeleri
| - (instancetype) init |
CGRectZero ve varsayılan seçenekler ile başlar.
| - (instancetype) initWithOptions: | (boş olmayan GMSMapViewOptions *) | seçenekler |
Verilen seçeneklerle yeni bir harita görünümü oluşturur.
Seçenekler nesnesinin değeri bu yöntem tarafından kopyalanır.
| - (instancetype) initWithFrame: | (TMM) | çerçeve |
| - (nullable örnek türü) initWithCoder: | (NSCoder *) | kodlayıcı |
| + (instancetype) MapWithFrame: | (TMM) | çerçeve | |
| kamera: | (GMSCameraPosition *) | kamera | |
Bir çerçeve ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür.
| + (instancetype) MapWithFrame: | (TMM) | çerçeve | |
| harita kimliği: | (GMSMapID *) | mapID | |
| kamera: | (GMSCameraPosition *) | 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ı.
| - (instancetype) initWithFrame: | (TMM) | çerçeve | |
| kamera: | (GMSCameraPosition *) | kamera | |
Bir çerçeve ve kamera hedefiyle bir harita görünümü oluşturur ve döndürür.
- Not:
- Bu kullanımdan kaldırıldı. Bunun yerine -init veya -initWithOptions: kullanın.
| - (instancetype) initWithFrame: | (TMM) | çerçeve | |
| harita kimliği: | (GMSMapID *) | mapID | |
| kamera: | (GMSCameraPosition *) | kamera | |
Bir çerçeve, harita kimliği ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür.
- Not:
- Bu kullanımdan kaldırıldı. Bunun yerine -init veya -initWithOptions: kullanın.
| - (geçersiz) startRendering |
Bu haritaya, oluşturucusunu güçlendirmesini söyler.
Bu, isteğe bağlıdır ve anlamlıdır.
- Not:
- Bu kullanımdan kaldırıldı. Bu yöntem eski ve gelecekteki bir sürümde kaldırılacaktır.
| - (geçersiz) stopRendering |
Bu haritaya oluşturucuyu kapatmasını söyler.
Bu, isteğe bağlıdır ve anlamlıdır.
- Not:
- Bu kullanımdan kaldırıldı. Bu yöntem eski ve gelecekteki bir sürümde kaldırılacaktır.
| - (geçersiz) temiz |
İş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ı silmez veya geçerli MapsType'ı sıfırlamaz.
| - (geçersiz) setMinZoom: | (float) | minZoom | |
| maxZoom: | (float) | maxZoom | |
minZoom ve maxZoom ayarlarını yapar.
Bu yöntem, minimum değerin maksimum değerden küçük veya maksimum değere eşit olmasını bekler ve aksi takdirde NSRangeException adı ile bir istisna oluşturur.
| - (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | sınırlar | |
| eks: | (UIEdgeInsets) | insets | |
bounds öğesini padding ile sunan bir GMSCameraPosition oluşturun.
Kamera sıfır yatağı ve eğimi olacaktır (yani, kuzeye bakacak ve doğrudan Dünya'ya bakacaktır). Bu işlemde, bu GMSMapView öğesinin çerçevesi ve dolgusu hesaba katılır.
Sınırlar geçersizse bu yöntem bir boş kamera döndürür.
| - (geçersiz) moveKamera: | (GMSCameraUpdate *) | güncelle |
Kamerayı update politikasına göre değiştirir.
Kamera değişikliği anlık olarak yapılır (animasyon olmadan).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
| konum: | (GMSCameraPosition *) | otherPosition. | |
Belirtilen kamera konumlarının kameranın pratikte aynı şekilde oluşturulmasına neden olup olmadığını kontrol edin. Dahili olarak kullanılan hassasiyet düzeyi ve dönüştürme işlemleri hesaba katılır.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureKatmanOfFeatureType: | (GMSFeatureType) | featureType |
Belirtilen türden bir özellik katmanı döndürür.
Özellik katmanları Cloud Console'da yapılandırılmalıdır.
Bu haritada belirtilen türden bir katman yoksa veya veriye dayalı stil etkin değilse ya da Metal oluşturma çerçevesi kullanılmıyorsa ortaya çıkan katmanın kullanılabilir durumu NO olur ve hiçbir çağrıya yanıt vermez.
Metal oluşturucu gerekir. Metal'i nasıl etkinleştireceğinizi https://developers.google.com/maps/documentation/ios-sdk/config#use-metal adresinden öğrenebilirsiniz.
| - (GMSDatasetFeatureLayer *) datasetFeaturelayerOfDatasetID: | (NSString *) | datasetID |
Belirtilen veri kümesinin veri kümesi özellik katmanını döndürür.
Veri kümesi kimlikleri Cloud Console'da yapılandırılmalıdır.
Belirtilen kimliğe sahip bir veri kümesi bu haritada yoksa veya veriye dayalı stil etkinleştirilmediyse elde edilen katmanın isAvailable değeri NO olur ve hiçbir çağrıya yanıt vermez.
| - (geçersiz) animateToKameraPosition: | (GMSCameraPosition *) | cameraPosition |
Bu haritanın kamerasını cameraPosition konumuna getirir.
| - (geçersiz) animateToLocation: | (CLLocationKoordinatörü2D) | konum |
animasyonluToKameraKonumu olarak: ancak yalnızca kameranın konumunu değiştirir (ör. geçerli konumdan location olarak).
| - (geçersiz) animateToZoom: | (float) | yakınlaştırma |
AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın yakınlaştırma düzeyini değiştirir.
Bu değer, [kGMSMinZoomLevel, kGMSMaxZoomLevel] ile sınırlanır.
| - (geçersiz) animateToBearing | (CLLocationDirection) | rün |
AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın yer yönünü değiştirir (derece cinsinden).
Sıfır, gerçek kuzeyi belirtir.
| - (geçersiz) animateToViewingAngle | (çift) | viewingAngle |
AnimasyonToKameraKonumu olarak: ancak yalnızca kameranın görüntüleme açısını değiştirir (derece cinsinden).
Bu değer, dünyaya göreceli yakınlığa bağlı olarak en az sıfıra (yani dik bir şekilde aşağıya bakacak şekilde) ve ufukta 30 ile 45 derece arasında olacak şekilde ayarlanır.
| - (geçersiz) animateWith CameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Geçerli kameraya cameraUpdate uygular ve ardından, sonucuGIFTo CameraPosition: parametresine göre kullanır.
Arkadaşlar ve İlgili İşlev Dokümanları
- (NSString* const) kGMSAccessibilityCompass [related] |
Pusula düğmesi için erişilebilirlik tanımlayıcısı.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
"Konumum" düğmesi için erişilebilirlik tanımlayıcısı.
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
"Kota doldu" hata etiketi için erişilebilirlik tanımlayıcısı.
Mülk Belgeleri
- (IBOutlet kimliği<GMSMapViewDelegate>) yetki ver [read, write, assign] |
GMSMapView temsilcisi.
- (GMSCameraPosition*) kamera [read, write, copy] |
Haritanın yönünü belirleyen kamerayı kontrol eder.
Bu özellik anlık olarak değiştirilir.
- (GMSProjection*) projeksiyon [read, assign] |
Ekran koordinatları ile enlem/boylam koordinatları arasında dönüştürme yapmak için kullanabileceğiniz bir GMSProjection nesnesi döndürür.
Bu, mevcut projeksiyonun bir anlık görüntüsüdür ve kamera hareket ettiğinde otomatik olarak güncellenmez. Çizilen son GMSMapView çerçevesinin projeksiyonunu veya kameranın açıkça ayarlandığı ya da haritanın yeni oluşturulduğu sıradaki kareyi temsil eder. Hiçbir zaman boş olmayacak.
- (BOOL) myLocationEnabled [read, write, assign] |
Konumum noktasının ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder.
Varsayılan olarak HAYIR.
- (CLLocation*) myLocation [read, assign] |
Konumum etkinse cihaz konum noktasının nerede çizildiğini gösterir.
Devre dışıysa veya etkinse ancak konum verisi mevcut değilse bu değer boş olacaktır. Bu özellik, KVO kullanılarak gözlemlenebilir.
- (GMSMarker*) selectedMarker [read, write, assign] |
Seçilen işaretçi.
Bu özellik ayarlandığında, üzerinde bir bilgi penceresi gösteren belirli bir işaretçi seçilir. Bu özellik nil değilse, nil değerine ayarlanması işaretçinin seçimini kaldırarak bilgi penceresini gizler. Bu özellik, KVO kullanılarak gözlemlenebilir.
- (BOOL) trafficEnabled [read, write, assign] |
Haritanın (varsa) trafik verileri çizip çizdiğini kontrol eder.
Bu, trafik verilerinin kullanılabilirliğine bağlıdır. Varsayılan olarak HAYIR.
- (GMSMapViewType) mapType [read, write, assign] |
Görüntülenmesi gereken harita parçalarının türünü denetler.
Varsayılan olarak kGMSTypeNormal kullanılır.
- (GMSMapStyle*) mapStyle [read, write, assign] |
Haritanın stilini kontrol eder.
nil olmayan bir MapStyle yalnızca MapType Normal değerine sahipse uygulanır.
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Haritayı istediğiniz UIUserInterfaceStyle olarak değiştirin.
Bu, varsayılan UIKit davranışını geçersiz kılar ve geriye dönük uyumluluk sağlamak için varsayılan olarak UIUserInterfaceStyleLight'ı kullanır. Bu, Normal ve Arazi harita türlerinin renk şemasını etkiler.
- (kayan) minZoom [read, assign] |
Minimum yakınlaştırma (kameranın uzaklaştırılabileceği en uzak mesafe).
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) buildingsEnabled [read, write, assign] |
Ayarlanırsa, mümkün olduğunda 3D binalar gösterilir.
Varsayılan olarak EVET değerine ayarlanır.
Bu, haritaya özel bir karo katmanı eklerken, yüksek yakınlaştırma düzeylerinde daha net hale getirmek için yararlı olabilir. Bu değerin değiştirilmesi tüm karoların kısa süreliğine geçersiz kılınmasına neden olur.
- (BOOL) indoorEnabled [read, write, assign] |
İç mekan haritalarının (kullanılabilir olduğunda) gösterilip gösterilmeyeceğini ayarlar.
Varsayılan olarak EVET değerine ayarlanır.
Bu politika HAYIR olarak ayarlanırsa iç mekan verilerinin önbellekleri temizlenebilir ve son kullanıcı tarafından hâlihazırda seçilmiş olan katlar sıfırlanabilir.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
İç mekan veri ekranının özelliklerini gözlemlemeye veya kontrol etmeye olanak tanıyan GMSIndoorDisplay örneğini alır.
- (GMSUISettings*) ayarlar [read, assign] |
Harita için 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 uygulayarak görünümün kenarında, harita verilerini içerecek ancak kullanıcı arayüzü denetimlerini içermeyecek 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 etkilediğinden görünür bölge dolgu alanını içermez. GMSCameraUpdate fitToBounds, hem bu dolgu hem de istenen tüm dolguların dikkate alınmasını sağlar.
Bu özellik, UIView tabanlı bir animasyon bloğu içinde animasyonlu olabilir.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Güvenli alan eklerinin dolgu değerlerine nasıl ekleneceğini kontrol eder.
Dolgu gibi güvenli alan da, cihaz güvenli alanındaki pusula, konumum düğmesi ve kat seçici gibi konum haritası kontrollerini ekler.
Varsayılan olarak kGMSmapViewPaddingsettingBehavior Always'dır.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Varsayılan olarak EVET değerine ayarlanır.
HAYIR olarak ayarlanırsa GMSMapView, GMSMarker ve GMSPolyline gibi yer paylaşımlı nesneler için erişilebilirlik öğeleri oluşturur.
Bu özellik, varsayılan EVET değeri haricinde genel UIAccessibility protokolüne uyar.
- (GMSMapLayer*) katman [read, retain] |
Katman için kullanılan özel CAKatman türüne erişimci.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Oluşturma kare hızını kontrol eder.
Varsayılan değer kGMSFrameRateMax'tir.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Sıfır değilse kamera hedefini, hareketler belirtilen sınırların dışına çıkmasına neden olmayacak şekilde kısıtlar.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Şu anda geçerli olan ve koşullu olarak kullanılabilen (mapID'ye veya diğer harita ayarlarına bağlıdır) tüm özellikler.
Her zaman kullanılabilen özellikleri içermez.