Dokumentacja klasy GMSMapView


Opis

Jest to główna klasa pakietu SDK Map Google na iOS i punkt wejścia wszystkich metod związanych z mapą.

Utwórz instancję mapy za pomocą jednego z konstruktorów -init lub -initWithOptions:.

Widok GMSMapView można odczytywać i modyfikować tylko w wątku głównym, podobnie jak w przypadku wszystkich obiektów UIKit. Wywołanie tych metod z innego wątku spowoduje wyjątek lub niezdefiniowane zachowanie.

Publiczne funkcje członków

(typ instancji)- init
 Inicjuje z użyciem CGRectZero i opcji domyślnych.
(typ instancji)initWithOptions:
 Tworzy nowy widok mapy z podanymi opcjami.
(typ instancji)initWithFrame:
(typ instancji)initWithCoder:
(typ instancji)initWithFrame:camera:
 Tworzy i zwraca widok mapy z ramką i celem kamery.
(typ instancji)- initWithFrame:mapID:camera:
 Tworzy i zwraca widok mapy z ramką, identyfikatorem mapy i celem kamery.
(void) startRendering
 Informuje tę mapę, aby zasiliła mechanizm renderowania.
(void) stopRendering
 Informuje tę mapę, że ma wyłączyć mechanizm renderowania.
(void) - wyczyść
 Usuwa wszystkie znaczniki dodane do mapy, w tym znaczniki, linie łamane i warstwy nad powierzchnią.
(void) setMinZoom:maxZoom:
 Ustawia minZoom i maxZoom.
(nullable GMSCameraPosition *) cameraForBounds:insets:
 Utwórz element GMSCameraPosition, który prezentuje bounds z padding.
(void) moveCamera:
 Zmienia aparat zgodnie z trybem update.
(BOOL) - areEqualForRenderingPosition:position:
 Biorąc pod uwagę poziom dokładności i przekształcenia stosowane wewnętrznie, sprawdź, czy dane położenie kamery w praktyce spowodowałoby wyrenderowanie jej w taki sam sposób.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
featureLayerOfFeatureType:
 Zwraca warstwę cech określonego typu.
(void) - animateToCameraPosition:
 Wyświetla aparat tej mapy na cameraPosition.
(void) animateToLocation:
 Jako animateToCameraPosition: ale zmienia tylko położenie kamery (tj. z bieżącej lokalizacji na location).
(void) animateToZoom:
 Jako animateToCameraPosition:, ale zmienia tylko poziom powiększenia kamery.
(void) animateToBearing:
 Jako animateToCameraPosition:, ale zmienia tylko kąt padania kamery (w stopniach).
(void) - animateToViewingAngle:
 Jako animateToCameraPosition: ale zmienia tylko kąt widzenia kamery (w stopniach).
(void) animateWithCameraUpdate:
 Stosuje parametr cameraUpdate do bieżącego aparatu, a następnie używa wyniku zgodnie z parametrem animateToCameraPosition:.

Statyczne publiczne funkcje członkowskie

(typ instancji)+ mapWithFrame:camera:
 Tworzy i zwraca widok mapy z ramką i celem kamery.
(typ instancji)+ mapWithFrame:mapID:camera:
 Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery.

Usługi

IBOutlet id< GMSMapViewDelegate >przekazać
 Delegat GMSMapView.
GMSCameraPositionaparat
 Steruje aparatem i określa sposób orientacji mapy.
GMSProjectionodwzorowanie
 Zwraca obiekt GMSProjection, którego można używać do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej.
BOOLmyLocationEnabled
 Określa, czy ma być włączona kropka i kółko dokładności Moja lokalizacja.
CLLocation * myLocation
 Jeśli Moja lokalizacja jest włączona, pokazuje, gdzie rysowana jest kropka lokalizacji urządzenia.
GMSMarkerselectedMarker
 wybrany znacznik.
BOOLtrafficEnabled
 Określa, czy mapa ma pobierać dane o ruchu drogowym, jeśli są dostępne.
GMSMapViewTypemapType
 Określa typ kafelków mapy, które mają być wyświetlane.
GMSMapStylemapStyle
 Określa styl mapy.
float minZoom
 Minimalne powiększenie (największe powiększenie kamery).
float maxZoom
 Maksymalne powiększenie (najbliżej Ziemi).
BOOLbuildingsEnabled
 Jeśli to ustawienie jest włączone, budynki 3D będą wyświetlane (o ile są dostępne).
BOOLindoorEnabled
 Określa, czy mają być wyświetlane mapy obiektów, jeśli są dostępne.
GMSIndoorDisplayindoorDisplay
 Pobiera wystąpienie GMSIndoorDisplay, które umożliwia obserwowanie i kontrolowanie różnych aspektów wyświetlania danych dotyczących wnętrz.
GMSUISettingsustawienia
 Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy.
UIEdgeInsetsdopełnienie
 Określa „widoczny” obszar widoku.
GMSMapViewPaddingAdjustmentBehavior,paddingAdjustmentBehavior
 Określa sposób dodawania bezpiecznych obszarów do wartości dopełnienia.
BOOLaccessibilityElementsHidden
 Domyślna wartość to YES (TAK).
GMSMapLayerWarstwa
 Metoda dostępu do niestandardowego typu CALayer używanego w warstwie.
GMSFrameRatepreferredFrameRate
 Określa liczbę klatek renderowania.
GMSCoordinateBoundscameraTargetBounds
 Jeśli wartość nie jest zerowa, ogranicza cel kamery, tak aby gesty nie mogły jej opuścić określonych granic.
GMSMapCapabilityFlagsmapCapabilities
 Wszystkie funkcje dostępne warunkowo (zależne od mapID lub innych ustawień mapy), które są dostępne w bieżącym momencie.

(uwaga: nie są to funkcje członkowskie).

NSString *constkGMSAccessibilityCompass
 Identyfikator ułatwień dostępu przycisku kompasu.
NSString *constkGMSAccessibilityMyLocation
 Identyfikator ułatwień dostępu dla przycisku „Moja lokalizacja”.
NSString *constkGMSAccessibilityOutOfQuota
 Identyfikator ułatwień dostępu etykiety błędu „wyczerpano limit”.

Dokumentacja funkcji członka grupy

- (instancetype) init

Inicjuje z użyciem CGRectZero i opcji domyślnych.

- (instancetype) initWithOptions: (nienull GMSMapViewOptions *) opcje

Tworzy nowy widok mapy z podanymi opcjami.

Wartość obiektu options jest kopiowana przez tę metodę.

– (instancetype) initWithFrame: (CGRect) ramka
– (instancetype) initWithCoder: (NSCoder *) koder
+ (typ instancji) mapWithFrame: (CGRect) ramka
aparat: (GMSCameraPosition *) camera

Tworzy i zwraca widok mapy z ramką i celem kamery.

+ (typ instancji) mapWithFrame: (CGRect) ramka
identyfikator mapy: (GMSMapID *) mapID
aparat: (GMSCameraPosition *) camera

Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery.

– (instancetype) initWithFrame: (CGRect) ramka
aparat: (GMSCameraPosition *) camera

Tworzy i zwraca widok mapy z ramką i celem kamery.

Uwaga:
Ta funkcja została wycofana. Zamiast tego użyj -init lub -initWithOptions:.
– (instancetype) initWithFrame: (CGRect) ramka
identyfikator mapy: (GMSMapID *) mapID
aparat: (GMSCameraPosition *) camera

Tworzy i zwraca widok mapy z ramką, identyfikatorem mapy i celem kamery.

Uwaga:
Ta funkcja została wycofana. Zamiast tego użyj -init lub -initWithOptions:.
– (void) startRendering

Informuje tę mapę, aby zasiliła mechanizm renderowania.

Jest opcjonalny i idempotentny.

Uwaga:
Ta funkcja została wycofana. Ta metoda jest przestarzała i zostanie usunięta w przyszłej wersji.
– (void) stopRendering

Informuje tę mapę, że ma wyłączyć mechanizm renderowania.

Jest opcjonalny i idempotentny.

Uwaga:
Ta funkcja została wycofana. Ta metoda jest przestarzała i zostanie usunięta w przyszłej wersji.
- (void) wyczyść

Usuwa wszystkie znaczniki dodane do mapy, w tym znaczniki, linie łamane i warstwy nad powierzchnią.

Nie spowoduje to usunięcia widocznej kropki lokalizacji ani zresetowania bieżącego typu mapy.

- (void): setMinZoom: (float)  minZoom
maxZoom: (float)  maxZoom

Ustawia minZoom i maxZoom.

Ta metoda oczekuje, że minimalna wartość będzie mniejsza od wartości maksymalnej lub jej równa. W przeciwnym razie wystąpi wyjątek o nazwie NSRangeWyjątek.

- (nullable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) granice
wstawki: (UIEdgeInsets) insets

Utwórz element GMSCameraPosition, który prezentuje bounds z padding.

Kamera będzie mieć ustawiony zerowy kierunek oraz przechylenie (czyli skierowany na północ i bezpośrednio na Ziemię). Uwzględniana jest ramka i dopełnienie tego obiektu GMSMapView.

Jeśli granica jest nieprawidłowa, ta metoda zwróci wartość kamery nil.

– (void) moveCamera: (GMSCameraUpdate *) aktualizacja

Zmienia aparat zgodnie z trybem update.

Zmiana kamery jest natychmiastowa (bez animacji).

- (BOOL) areEqualForRenderingPosition: (GMSCameraPosition *) position
pozycja: (GMSCameraPosition *) otherPosition

Biorąc pod uwagę poziom dokładności i przekształcenia stosowane wewnętrznie, sprawdź, czy dane położenie kamery w praktyce spowodowałoby wyrenderowanie jej w taki sam sposób.

Zwraca warstwę cech określonego typu.

Warstwy cech trzeba skonfigurować w konsoli Cloud.

Jeśli warstwa określonego typu nie istnieje na tej mapie, styl oparty na danych jest wyłączony lub nie jest używana platforma renderowania Metal, utworzona warstwa „Dostępna” będzie miała wartość NO i nie będzie odpowiadać na żadne wywołania.

Wymaga mechanizmu renderowania Metal. Informacje o włączaniu Metalu znajdziesz na stronie https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Wyświetla aparat tej mapy na cameraPosition.

– (void) animateToLocation: (CLLocationCoordinate2D)  lokalizacja

Jako animateToCameraPosition: ale zmienia tylko położenie kamery (tj. z bieżącej lokalizacji na location).

– (void) animateToZoom: (float)  powiększenie

Jako animateToCameraPosition:, ale zmienia tylko poziom powiększenia kamery.

Ta wartość jest ograniczana przez [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) maszyna

Jako animateToCameraPosition:, ale zmienia tylko kąt padania kamery (w stopniach).

0 oznacza rzeczywistą północ.

- (nieważny) animateToViewingAngle: (liczba zmiennoprzecinkowa) viewingAngle

Jako animateToCameraPosition: ale zmienia tylko kąt widzenia kamery (w stopniach).

Wartość ta jest ograniczona do zera (tzn. pionowo w dół) i od 30 do 45 stopni w kierunku horyzontu, w zależności od względnej odległości od Ziemi.

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) cameraUpdate

Stosuje parametr cameraUpdate do bieżącego aparatu, a następnie używa wyniku zgodnie z parametrem animateToCameraPosition:.


– (NSString* const) kGMSAccessibilityCompass [related]

Identyfikator ułatwień dostępu przycisku kompasu.

– (NSString* const) kGMSAccessibilityMyLocation [related]

Identyfikator ułatwień dostępu dla przycisku „Moja lokalizacja”.

– (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identyfikator ułatwień dostępu etykiety błędu „wyczerpano limit”.


Dokumentacja właściwości

– (IBOutlet id<GMSMapViewDelegate>) delegate [read, write, assign]

Delegat GMSMapView.

– (GMSCameraPosition*) aparat [read, write, copy]

Steruje aparatem i określa sposób orientacji mapy.

Modyfikacja tej właściwości jest natychmiastowa.

- (GMSProjection*) projekcja [read, assign]

Zwraca obiekt GMSProjection, którego można używać do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej.

To zdjęcie przedstawiające bieżącą projekcję. Nie jest automatycznie aktualizowane, gdy kamera się porusza. Reprezentuje ona ostatnią narysowaną klatkę GMSMapView albo kolejną klatkę (w przypadku gdy kamera została wyraźnie ustawiona lub właśnie utworzona mapa). Nigdy nie będzie nil.

– (BOOL) myLocationEnabled [read, write, assign]

Określa, czy ma być włączona kropka i kółko dokładności Moja lokalizacja.

Wartość domyślna to NO.

– (CLLocation*) myLocation [read, assign]

Jeśli Moja lokalizacja jest włączona, pokazuje, gdzie rysowana jest kropka lokalizacji urządzenia.

Jeśli funkcja jest wyłączona lub jest włączona, ale dane o lokalizacji nie są dostępne, wartość jest pusta. Tę właściwość można obserwować za pomocą KVO.

- (GMSMarker*) selectedMarker [read, write, assign]

wybrany znacznik.

Ustawienie tej właściwości powoduje wybranie określonego znacznika, który wyświetla okno informacyjne. Jeśli właściwość nie ma wartości zerowej, ustawienie jej na wartość nil powoduje odznaczenie znacznika i ukrycie okna informacyjnego. Tę właściwość można obserwować za pomocą KVO.

- (BOOL) trafficEnabled [read, write, assign]

Określa, czy mapa ma pobierać dane o ruchu drogowym, jeśli są dostępne.

Zależy to od dostępności danych o ruchu. Wartość domyślna to NO.

– (GMSMapViewType) mapType [read, write, assign]

Określa typ kafelków mapy, które mają być wyświetlane.

Wartość domyślna to kGMSTypeNormal.

– (GMSMapStyle*) mapStyle [read, write, assign]

Określa styl mapy.

Wartość inna niż nil mapStyle zostanie zastosowana tylko wtedy, gdy atrybut mapType ma wartość Normal.

– (liczba zmiennoprzecinkowa) minZoom [read, assign]

Minimalne powiększenie (największe powiększenie kamery).

Wartość domyślna to kGMSMinZoomLevel. Zmodyfikowano -setMinZoom:maxZoom:.

- (liczba zmiennoprzecinkowa) maxZoom [read, assign]

Maksymalne powiększenie (najbliżej Ziemi).

Wartość domyślna to kGMSMaxZoomLevel. Zmodyfikowano -setMinZoom:maxZoom:.

- (BOOL) buildingsEnabled [read, write, assign]

Jeśli to ustawienie jest włączone, budynki 3D będą wyświetlane (o ile są dostępne).

Domyślna wartość to YES (TAK).

Może to być przydatne podczas dodawania do mapy niestandardowej warstwy kafelków, aby było ona wyraźniejsza przy dużym powiększeniu. Zmiana tej wartości spowoduje chwilowe unieważnienie wszystkich kafelków.

– (BOOL) indoorEnabled [read, write, assign]

Określa, czy mają być wyświetlane mapy obiektów, jeśli są dostępne.

Domyślna wartość to YES (TAK).

Jeśli zasada ma wartość NIE, pamięć podręczna dla danych dotyczących wnętrz może zostać trwale wyczyszczona, a każde piętro aktualnie wybrane przez użytkownika może zostać zresetowane.

– (GMSIndoorDisplay*) indoorDisplay [read, assign]

Pobiera wystąpienie GMSIndoorDisplay, które umożliwia obserwowanie i kontrolowanie różnych aspektów wyświetlania danych dotyczących wnętrz.

- (GMSUISettings*) ustawienia [read, assign]

Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy.

- (UIEdgeInsets) dopełnienie [read, write, assign]

Określa „widoczny” obszar widoku.

Dzięki zastosowaniu dopełnienia można utworzyć obszar wokół krawędzi widoku, który będzie zawierał dane mapy, ale nie będzie zawierał elementów interfejsu.

Jeśli dopełnienie nie będzie zrównoważone, wizualny środek widoku przesunie się odpowiednio. Dopełnienie wpłynie na właściwość projection, więc widoczny region nie będzie zawierał dopełnienia. Funkcja GMSCameraUpdate FitToBounds będzie mieć pewność, że będzie uwzględnione zarówno to dopełnienie, jak i wszelkie jego żądanie.

Ta właściwość może być animowana w bloku animacji opartym na UIView.

Określa sposób dodawania bezpiecznych obszarów do wartości dopełnienia.

Podobnie jak dopełnienie, bezpieczny obszar nakłada elementy sterujące mapą, np. kompas, przycisk lokalizacji i selektor podłogi w bezpiecznym obszarze urządzenia.

Wartość domyślna to kGMSMapViewPadding AdjustBehavior.

- (BOOL) accessibilityElementsHidden [read, write, assign]

Domyślna wartość to YES (TAK).

Jeśli zasada ma wartość NIE, GMSMapView generuje elementy ułatwień dostępu dla obiektów nakładek, takich jak GMSMarker i GMSPolyline.

Ta właściwość jest zgodna z nieformalnym protokołem UIAccessibility - z wyjątkiem domyślnej wartości YES.

- (GMSMapLayer*) warstwa [read, retain]

Metoda dostępu do niestandardowego typu CALayer używanego w warstwie.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Określa liczbę klatek renderowania.

Wartość domyślna to kGMSFrameRateMax.

– (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Jeśli wartość nie jest zerowa, ogranicza cel kamery, tak aby gesty nie mogły jej opuścić określonych granic.

– (GMSMapCapabilityFlags) mapCapabilities [read, assign]

Wszystkie funkcje dostępne warunkowo (zależne od mapID lub innych ustawień mapy), które są dostępne w bieżącym momencie.

Nie uwzględnia zawsze dostępnych funkcji.