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: kurucularından biri aracılığıyla örneklenmelidir.
GMSMapView, tüm UIKit nesnelerinde olduğu gibi 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ı, istisnaya veya tanımlanmamış davranışa neden olur.
Herkese Açık Üye İşlevleri | |
(ornektype) | - init |
CGRectZero ve varsayılan seçeneklerle başlar. | |
(ornektype) | - initWithOptions: |
Verilen seçeneklerle yeni bir harita görünümü oluşturur. | |
(ornektype) | - initWithFrame: |
(ornektype) | - initWithCoder: |
(ornektype) | - initWithFrame:camera: |
Bir çerçeve ve kamera hedefi içeren harita görünümü oluşturur ve döndürür. | |
(ornektype) | - initWithFrame:mapID:camera: |
Ç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şturucuyu açmasını söyler. | |
(void) | - stopRendering |
Bu haritaya, oluşturucusunu kapatmasını söyler. | |
(void) | - temiz |
İşaretçiler, çoklu çizgiler ve zemin bindirmeleri de dahil olmak üzere haritaya eklenmiş tüm işaretlemeleri temizler. | |
(void) | - setMinZoom:maxZoom: |
minZoom ve maxZoom olarak ayarlanır. | |
(nullable GMSCameraPosition *) | - cameraForBounds:insets: |
bounds hizmetini padding ile sunan bir GMSCameraPosition oluşturun. | |
(void) | - moveKamera: |
Kamerayı update cihazına göre değiştirir. | |
(BOOL) | - areEqualForRenderingPosition:position: |
Belirtilen kamera konumlarının, dahili olarak kullanılan kesinlik düzeyini ve dönüştürmeleri göz önünde bulundurarak kameranın aynı şekilde oluşturulmasına neden olup olmayacağını kontrol edin. | |
(GMSFeatureLayer < GMSPlaceFeature * > *) | - featurelayerOfFeatureType: |
Belirtilen türde bir özellik katmanı döndürür. | |
(void) | - animateTocameraPosition: |
Bu haritanın kamerasına cameraPosition animasyonunu ekler. | |
(void) | - animateToLocation: |
Canlandırma Konumu olarak: ancak yalnızca kameranın konumunu değiştirir (örneğin, geçerli konumdan location konumuna). | |
(void) | - animateToZoom: |
AnimasyonuKameraKonumu olarak: ancak yalnızca kameranın yakınlaştırma düzeyini değiştirir. | |
(void) | - animateToBearing: |
AnimasyonuKameraKonumu olarak: ancak yalnızca kameranın yönünü değiştirir (derece cinsinden). | |
(void) | - animateToViewingAngle: |
AnimasyonuKameraKonumu olarak: ancak yalnızca kameranın görüntüleme açısını değiştirir (derece cinsinden). | |
(void) | - animateWithcameraUpdate: |
Geçerli kameraya cameraUpdate değerini uygular ve daha sonra, sonucu animasyon ToKameraKonumuna göre kullanır. | |
Statik Herkese Açık Üye İşlevleri | |
(ornektype) | + mapWithFrame:camera: |
Çerçeve ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür. | |
(ornektype) | + mapWithFrame:mapID:camera: |
Çerçeve, harita kimliği ve kamera hedefi içeren bir harita görünümü oluşturmak ve döndürmek için kullanışlı başlatıcı. | |
Mülkler | |
IBOutlet kimliği< GMSMapViewDelegate > | yetki ver |
GMSMapView yetkisini verin. | |
GMSCameraPosition * | kamera |
Haritanın yönünü tanımlayan 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ı ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder. | |
CLLocation * | myLocation |
Konumum özelliği etkinse cihaz konum noktasının çizildiği yeri gösterir. | |
GMSMarker * | selectedMarker |
Seçilen işaretçi. | |
BOOL | trafficEnabled |
Haritanın trafik verilerini çekip çekmediğini (varsa) kontrol eder. | |
GMSMapViewType | mapType |
Görüntülenmesi gereken harita karolarının türünü kontrol eder. | |
GMSMapStyle * | mapStyle |
Haritanın stilini kontrol eder. | |
float | minZoom |
Minimum yakınlaştırma (kameranın uzaklaştırabileceği en uzak mesafe). | |
float | maxZoom |
Maksimum yakınlaştırma (kamera Dünya'ya en yakın olabilir). | |
BOOL | buildingsEnabled |
Ayarlanırsa, uygun olduğu durumlarda 3D binalar gösterilir. | |
BOOL | indoorEnabled |
Kullanılabilir olduğunda iç mekan haritalarının gösterilip gösterilmeyeceğini ayarlar. | |
GMSIndoorDisplay * | indoorDisplay |
İç mekan veri görüntüleme ö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. | |
UIEdgeInset'leri | dolgu |
Görünümün "görünür" bölgesini denetler. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
Güvenli alan eklerinin, dolgu değerlerine nasıl ekleneceğini kontrol eder. | |
BOOL | accessibilityElementsHidden |
Varsayılan olarak YES'e (EVET) ayarlanır. | |
GMSMapLayer * | katman |
Katman için kullanılan özel CAtier türü erişimci. | |
GMSFrameRate | preferredFrameRate |
Oluşturma kare hızını kontrol eder. | |
GMSCoordinateBounds * | cameraTargetBounds |
Sıfır değilse kamera hedefini, hareketler belirlenen sınırların dışına çıkmasına neden olmayacak şekilde daraltır. | |
GMSMapCapabilityFlags | mapCapabilities |
Şu anda mevcut olan ve koşullu olarak kullanılabilen (mapID'ye veya diğer harita ayarlarına bağlı olarak) 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
- (ornektype) init |
CGRectZero ve varsayılan seçeneklerle başlar.
- (ornek türü) initWithOptions: | (null 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.
- (örnek türü) initWithFrame: | (CGRect) | çerçeve |
- (örnek türü) initWithCoder: | (NSCoder *) | kodlayıcı |
+ (ornek türü)mapWithFrame: | (CGRect) | çerçeve | |
kamera: | (GMSCameraPosition *) | kamera | |
Çerçeve ve kamera hedefi içeren bir harita görünümü oluşturur ve döndürür.
+ (ornek türü)mapWithFrame: | (CGRect) | çerçeve | |
harita kimliği: | (GMSMapID *) | mapID | |
kamera: | (GMSCameraPosition *) | kamera | |
Çerçeve, harita kimliği ve kamera hedefi içeren bir harita görünümü oluşturmak ve döndürmek için kullanışlı başlatıcı.
- (örnek türü) initWithFrame: | (CGRect) | çerçeve | |
kamera: | (GMSCameraPosition *) | kamera | |
Bir çerçeve ve kamera hedefi içeren harita görünümü oluşturur ve döndürür.
- Not:
- Bu özellik kullanımdan kaldırılmıştır. Bunun yerine -init veya -initWithOptions: kullanın.
- (örnek türü) initWithFrame: | (CGRect) | çerçeve | |
harita kimliği: | (GMSMapID *) | mapID | |
kamera: | (GMSCameraPosition *) | kamera | |
Ç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 özellik kullanımdan kaldırılmıştır. Bunun yerine -init veya -initWithOptions: kullanın.
- (void) startRendering |
Bu haritaya, oluşturucuyu açmasını söyler.
Bu, isteğe bağlıdır ve eş anlamlıdır.
- Not:
- Bu özellik kullanımdan kaldırılmıştır. Bu yöntem artık kullanılmamaktadır ve gelecekteki bir sürümde kaldırılacaktır.
- (geçersiz) stopRendering |
Bu haritaya, oluşturucusunu kapatmasını söyler.
Bu, isteğe bağlıdır ve eş anlamlıdır.
- Not:
- Bu özellik kullanımdan kaldırılmıştır. Bu yöntem artık kullanılmamaktadır ve gelecekteki bir sürümde kaldırılacaktır.
- (geçersiz) clear |
İşaretçiler, çoklu çizgiler ve zemin bindirmeleri de dahil olmak üzere haritaya eklenmiş tüm işaretlemeleri temizler.
Bu işlem, görünür konum noktasını silmez veya geçerli MapType değerini sıfırlamaz.
- (geçersiz) setMinZoom: | (float) | minZoom | |
maxZoom: | (float) | maxZoom | |
minZoom
ve maxZoom
olarak ayarlanır.
Bu yöntem, minimum değerin maksimum değerden küçük veya maksimum değere eşit olmasını bekler ve aksi takdirde NSRangeException adlı bir istisna oluşturur.
- (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | sınırlar | |
ekler: | (UIEdgeInsets) | insets | |
bounds
hizmetini padding
ile sunan bir GMSCameraPosition oluşturun.
Kamera sıfır yöne ve eğimli olacaktır (yani, kuzeye bakıp doğrudan Dünya'ya bakmalıdır). Bu işlem, GMSMapView öğesinin çerçevesini ve dolgusunu dikkate alır.
Sınırlar geçersizse bu yöntem nil kamera döndürür.
- (void) moveKamera: | (GMSCameraUpdate *) | güncelleme |
Kamerayı update
cihazına göre değiştirir.
Kamera değişikliği anlıktır (animasyon olmadan).
- (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | konum | |
konum: | (GMSCameraPosition *) | otherPosition | |
Belirtilen kamera konumlarının, dahili olarak kullanılan kesinlik düzeyini ve dönüştürmeleri göz önünde bulundurarak kameranın aynı şekilde oluşturulmasına neden olup olmayacağını kontrol edin.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featurelayerOfFeatureType: | (GMSFeatureType) | featureType |
Belirtilen türde bir özellik katmanı döndürür.
Özellik katmanları Cloud Console'da yapılandırılmalıdır.
Bu haritada belirtilen türde bir katman yoksa veya veriye dayalı stil etkinleştirilmemişse ya da Metal oluşturma çerçevesi kullanılmıyorsa elde edilen katmanın isAvailable'ı NO
olur ve hiçbir çağrıya yanıt vermez.
Metal oluşturucu gerektirir. Metal'i nasıl etkinleştireceğinizi öğrenmek için https://developers.google.com/maps/documentation/ios-sdk/config#use-metal adresini ziyaret edin.
- (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Bu haritanın kamerasına cameraPosition
animasyonunu ekler.
- (geçersiz) animateToLocation: | (CLLocationCoordinate2D) | konum |
canlandırmaKonumu olarak: ancak yalnızca kameranın konumunu değiştirir (örneğin, geçerli konumdan location
konumuna).
- (geçersiz) animateToZoom: | (float) | yakınlaştırma |
AnimasyonuKameraKonumu olarak: ancak yalnızca kameranın yakınlaştırma düzeyini değiştirir.
Bu değer [kGMSMinZoomLevel, kGMSMaxZoomLevel] tarafından sınırlanır.
- (geçersiz) animateToBearing: | (CLLocationDirection) | rol |
AnimasyonuKameraKonumu olarak: ancak yalnızca kameranın yönünü değiştirir (derece cinsinden).
Sıfır, gerçek kuzeyi belirtir.
- (geçersiz) animateToViewingAngle: | (çift) | viewingAngle |
AnimasyonuKameraKonumu 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 dümdüz aşağı bakacak şekilde) ve ufuk çizgisine doğru 30 ile 45 derece arasında sabitlenir.
- (geçersiz) animateWith CameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Geçerli kameraya cameraUpdate
değerini uygular ve daha sonra, sonucu animasyon ToKameraKonumuna göre kullanır.
Arkadaşlar ve İlgili İşlevler Dokümanları
- (NSString* kurucu) kGMSAccessibilityCompass [related] |
Pusula düğmesi için erişilebilirlik tanımlayıcısı.
- (NSString* tutarlı) kGMSAccessibilityMyLocation [related] |
"Konumum" düğmesi için erişilebilirlik tanımlayıcısı.
- (NSString* tutarlı) kGMSAccessibilityOutOfQuota [related] |
"Kota doldu" hata etiketi için erişilebilirlik tanımlayıcısı.
Gayrimenkul Dokümanları
- (IBOutlet id<GMSMapViewDelegate>) yetki ver [read, write, assign] |
GMSMapView yetkisini verin.
- (GMSCameraPosition*) kamera [read, write, copy] |
Haritanın yönünü tanımlayan kamerayı kontrol eder.
Bu özellik anında 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 anlık görüntüsüdür ve kamera hareket ettiğinde otomatik olarak güncellenmez. Ya son çizilen GMSMapView çerçevesinin projeksiyonunu veya kameranın açıkça ayarlandığı ya da haritanın henüz yeni oluşturulduğu karenin projeksiyonunu temsil eder. Asla boş olmaz.
- (BOOL) myLocationEnabled [read, write, assign] |
Konumum noktası ve doğruluk dairesinin etkinleştirilip etkinleştirilmediğini kontrol eder.
Varsayılan olarak NO değerine ayarlanır.
- (CLLocation*) myLocation [read, assign] |
Konumum özelliği etkinse cihaz konum noktasının çizildiği yeri gösterir.
Devre dışıysa veya etkinleştirilmişse ancak konum verisi yoksa bu değer boş olacaktır. Bu mülk, KVO kullanılarak gözlemlenebilir.
- (GMSMarker*) selectedMarker [read, write, assign] |
Seçilen işaretçi.
Bu özellik ayarlandığında, bilgi penceresi gösteren belirli bir işaretçi seçilir. Bu özellik boş değilse, sıfır 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] |
Haritanın trafik verilerini çekip çekmediğini (varsa) kontrol eder.
Bu, trafik verilerinin kullanılabilirliğine bağlıdır. Varsayılan olarak NO değerine ayarlanır.
- (GMSMapViewType) mapType [read, write, assign] |
Görüntülenmesi gereken harita karolarının türünü kontrol eder.
Varsayılan olarak kGMSTypeNormal'dir.
- (GMSMapStyle*) mapStyle [read, write, assign] |
Haritanın stilini kontrol eder.
Sıfır olmayan bir MapStyle yalnızca, matchType Normal ise uygulanır.
- (kayan) minZoom [read, assign] |
Minimum yakınlaştırma (kameranın uzaklaştırabileceği en uzak mesafe).
Varsayılan olarak kGMSMinZoomLevel değerine ayarlanı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 değerine ayarlanır. -setMinZoom:maxZoom: ile değiştirildi.
- (BOOL) buildingsEnabled [read, write, assign] |
Ayarlanırsa, uygun olduğu durumlarda 3D binalar gösterilir.
Varsayılan olarak YES'e (EVET) ayarlanır.
Bu, haritaya bir özel karo katmanı eklerken, yüksek yakınlaştırma düzeylerinde daha net olması 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] |
Kullanılabilir olduğunda iç mekan haritalarının gösterilip gösterilmeyeceğini ayarlar.
Varsayılan olarak YES'e (EVET) ayarlanır.
Bu ayar HAYIR olarak ayarlanırsa iç mekan verilerine ait önbellekler silinebilir ve son kullanıcı tarafından o sırada seçilmiş olan tüm katlar sıfırlanabilir.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
İç mekan veri görüntüleme ö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 denetler.
Görünümün kenarına dolgu uygulanarak harita verilerini içerecek ancak kullanıcı arayüzü kontrollerini 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 dolgunun hem de istenen dolgunun dikkate alınmasını sağlar.
Bu özellik, UIView tabanlı bir animasyon bloğu içinde canlandırılabilir.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Güvenli alan eklerinin, dolgu değerlerine nasıl ekleneceğini kontrol eder.
Dolgu gibi, güvenli alan da pusula, konum düğmesi ve kat seçici gibi harita kontrollerini cihazın güvenli alanına ayarlar.
Varsayılan olarak kGMSMapViewPaddingSettingBehavior Always değerine ayarlanır.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Varsayılan olarak YES'e (EVET) ayarlanır.
HAYIR 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 UIAccessibility protokolünü uygular.
- (GMSMapLayer*) katman [read, retain] |
Katman için kullanılan özel CAtier türü erişimci.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Oluşturma kare hızını kontrol eder.
Varsayılan değer, kGMSFrameRateMax'tır.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Sıfır değilse kamera hedefini, hareketler belirlenen sınırların dışına çıkmasına neden olmayacak şekilde daraltır.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Şu anda mevcut olan ve koşullu olarak kullanılabilen (mapID'ye veya diğer harita ayarlarına bağlı olarak) tüm özellikler.
Her zaman kullanılabilen özellikleri içermez.