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. | |
GMSCameraPosition * | aparat |
Steruje aparatem i określa sposób orientacji mapy. | |
GMSProjection * | odwzorowanie |
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. | |
BOOL | myLocationEnabled |
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. | |
GMSMarker * | selectedMarker |
wybrany znacznik. | |
BOOL | trafficEnabled |
Określa, czy mapa ma pobierać dane o ruchu drogowym, jeśli są dostępne. | |
GMSMapViewType | mapType |
Określa typ kafelków mapy, które mają być wyświetlane. | |
GMSMapStyle * | mapStyle |
Określa styl mapy. | |
float | minZoom |
Minimalne powiększenie (największe powiększenie kamery). | |
float | maxZoom |
Maksymalne powiększenie (najbliżej Ziemi). | |
BOOL | buildingsEnabled |
Jeśli to ustawienie jest włączone, budynki 3D będą wyświetlane (o ile są dostępne). | |
BOOL | indoorEnabled |
Określa, czy mają być wyświetlane mapy obiektów, jeśli są dostępne. | |
GMSIndoorDisplay * | indoorDisplay |
Pobiera wystąpienie GMSIndoorDisplay, które umożliwia obserwowanie i kontrolowanie różnych aspektów wyświetlania danych dotyczących wnętrz. | |
GMSUISettings * | ustawienia |
Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy. | |
UIEdgeInsets | dopełnienie |
Określa „widoczny” obszar widoku. | |
GMSMapViewPaddingAdjustmentBehavior, | paddingAdjustmentBehavior |
Określa sposób dodawania bezpiecznych obszarów do wartości dopełnienia. | |
BOOL | accessibilityElementsHidden |
Domyślna wartość to YES (TAK). | |
GMSMapLayer * | Warstwa |
Metoda dostępu do niestandardowego typu CALayer używanego w warstwie. | |
GMSFrameRate | preferredFrameRate |
Określa liczbę klatek renderowania. | |
GMSCoordinateBounds * | cameraTargetBounds |
Jeśli wartość nie jest zerowa, ogranicza cel kamery, tak aby gesty nie mogły jej opuścić określonych granic. | |
GMSMapCapabilityFlags | mapCapabilities |
Wszystkie funkcje dostępne warunkowo (zależne od mapID lub innych ustawień mapy), które są dostępne w bieżącym momencie. | |
Powiązane funkcje | |
(uwaga: nie są to funkcje członkowskie). | |
NSString *const | kGMSAccessibilityCompass |
Identyfikator ułatwień dostępu przycisku kompasu. | |
NSString *const | kGMSAccessibilityMyLocation |
Identyfikator ułatwień dostępu dla przycisku „Moja lokalizacja”. | |
NSString *const | kGMSAccessibilityOutOfQuota |
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.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
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:.
Dokumentacja funkcji znajomych i powiązanych
– (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.