Przegląd
Jest to główna klasa pakietu SDK Map Google na iOS i punkt wejścia wszystkich metod związanych z mapą.
Wystąpienie mapy należy utworzyć za pomocą wygodnego konstruktora [GMSMapView mapWithFrame:camera:]. Można je też utworzyć przy użyciu domyślnej metody [[GMSMapView alloc] initWithFrame:] (w której kamera jest ustawiona na lokalizację domyślną).
Obiekt 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 wystąpienie wyjątku lub niezdefiniowane zachowanie.
Publiczne funkcje członków | |
| (typ instancji) | - initWithFrame:aparat: |
| Tworzy i zwraca widok mapy z ramką i celem kamery. | |
| (typ instancji) | - initWithFrame:mapID:aparat: |
| Tworzy i zwraca widok mapy z ramką, identyfikatorem mapy i celem kamery. | |
| (nieważna) | – startRendering |
| Informuje tę mapę, że ma włączyć mechanizm renderowania. | |
| (nieważna) | – stopRendering |
| Informuje tę mapę, że ma wyłączyć mechanizm renderowania. | |
| (nieważna) | - wyczyść |
| Usuwa wszystkie znaczniki dodane do mapy, w tym znaczniki, linie łamane i warstwy nad powierzchnią. | |
| (nieważna) | – setMinZoom:maxZoom: |
Ustawia minZoom i maxZoom. | |
| (wartość null GMSCameraPosition *) | - cameraForBounds:insets: |
Utwórz element GMSCameraPosition, który prezentuje bounds z padding. | |
| (nieważna) | - moveCamera: |
Zmienia aparat zgodnie z tym ustawieniem: update. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Weź pod uwagę poziom dokładności i przekształcenia stosowane wewnętrznie, aby sprawdzić, czy dane położenie kamery nie spowodowałoby wyrenderowania kamery w taki sam sposób. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | – featureLayerOfFeatureType: |
| Zwraca warstwę cech podanego typu. | |
| (nieważna) | - animateToCameraPosition: |
Aktywuje aparat tej mapy na cameraPosition. | |
| (nieważna) | – animateToLocation: |
Jako animateToCameraPosition: ale zmienia tylko położenie kamery (tj. z bieżącej lokalizacji na location). | |
| (nieważna) | – animateToZoom: |
| Jako animateToCameraPosition:, ale zmienia tylko poziom powiększenia kamery. | |
| (nieważna) | – animateToBearing: |
| Jako animateToCameraPosition: ale zmienia tylko kąt nachylenia kamery (w stopniach). | |
| (nieważna) | - animateToViewingAngle: |
| jako animateToCameraPosition:, ale zmienia tylko kąt patrzenia kamery (w stopniach). | |
| (nieważna) | – animateWithCameraUpdate: |
Stosuje właściwość cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób określony przez parametr animateToCameraPosition:. | |
Statyczne publiczne funkcje członków | |
| (typ instancji) | + mapWithFrame:camera: |
| Tworzy i zwraca widok mapy z ramką i celem kamery. | |
| (typ instancji) | + mapWithFrame:mapID:aparat: |
| Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery. | |
Usługi | |
| IBOutlet id< GMSMapViewOwnership > | przekazać |
| GMSMapView. | |
| GMSCameraPosition * | aparat |
| Steruje aparatem i określa orientację mapy. | |
| GMSProjection * | odwzorowanie |
| Zwraca obiekt GMSProjection, którego można użyć do przekształcenia współrzędnych ekranu na współrzędne geograficzne. | |
| BOOL | myLocationEnabled |
| Określa, czy kropka i kółko dokładności Moja lokalizacja są włączone. | |
| CLLocation * | moja_lokalizacja |
| Jeśli Moja lokalizacja jest włączona, pokazuje miejsce, w którym rysowana jest kropka lokalizacji urządzenia. | |
| GMSMarker * | selectedMarker |
| wybrany znacznik. | |
| BOOL | trafficEnabled |
| Określa, czy mapa ma przedstawiać dane o natężeniu ruchu, jeśli są dostępne. | |
| GMSMapViewType. | Typ mapy |
| Określa typ kafelków mapy, które mają być wyświetlane. | |
| GMSMapStyle * | mapStyle, |
| Określa styl mapy. | |
| liczba zmiennoprzecinkowa | minZoom. |
| Minimalne powiększenie (największa odległość od kamery). | |
| liczba zmiennoprzecinkowa | maxZoom. |
| Maksymalne powiększenie (najbliższe oddalenie kamery od Ziemi). | |
| BOOL | BuildsEnabled |
| Po ustawieniu tej opcji 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). | |
| Wyświetlacz GMSIndoorDisplay * | wyświetlacz wewnętrzny |
| Pobiera wystąpienie GMSIndoorDisplay, które umożliwia obserwację lub kontrolowanie różnych aspektów wyświetlania danych dotyczących wnętrz. | |
| GMSUISettings * | ustawienia |
| Pobiera obiekt GMSUISettings, który zarządza ustawieniami interfejsu mapy. | |
| UIEdgeInsets | dopełnienie, |
| Określa „widoczny” obszar widoku. | |
| GMSMapViewPaddingAdjustBehavior | dost.AdjustBehavior. |
| Kontroluje sposób dodawania bezpiecznych obszarów do wartości dopełnienia. | |
| BOOL | accessibilityElementsUkryte |
| Wartość domyślna to TAK. | |
| GMSMapLayer * | Warstwa |
| Metoda dostępu niestandardowego typu warstwy CALayer używanego w warstwie. | |
| GMSFrameRate | PreferredFrameRate |
| Steruje liczbą klatek renderowania. | |
| GMSCoordinateBounds * | Obszary docelowe kamery |
| Jeśli wartość nie jest określona, ogranicza cel kamery, tak aby gesty nie mogły opuścić określonych granic. | |
| GMSMapCapabilityFlags | Możliwości map |
| Wszystkie funkcje dostępne warunkowo (w zależności od identyfikatora mapy lub innych ustawień mapy), które są obecnie dostępne. | |
Powiązane funkcje | |
(nie są to funkcje składowe). | |
| 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
| + (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 *) | Identyfikator mapy | |
| aparat: | (GMSCameraPosition *) | camera | |
Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery.
| - (typ instancji) initWithFrame: | (CGRect) | ramka | |
| aparat: | (GMSCameraPosition *) | camera | |
Tworzy i zwraca widok mapy z ramką i celem kamery.
| - (typ instancji) initWithFrame: | (CGRect) | ramka | |
| identyfikator mapy: | (GMSMapID *) | Identyfikator mapy | |
| aparat: | (GMSCameraPosition *) | camera | |
Tworzy i zwraca widok mapy z ramką, identyfikatorem mapy i celem kamery.
| - (void) startRendering |
Informuje tę mapę, że ma włączyć mechanizm renderowania.
Jest to opcjonalne i idempotentne.
- 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 to opcjonalne i idempotentne.
- Uwaga:
- Ta funkcja została wycofana. Ta metoda jest przestarzała i zostanie usunięta w przyszłej wersji.
| - (nieważny) wyczyść |
Usuwa wszystkie znaczniki dodane do mapy, w tym znaczniki, linie łamane i warstwy nad powierzchnią.
Nie spowoduje to usunięcia widocznej kropki z lokalizacją ani zresetowania bieżącego typu mapy.
| - (void) setMinZoom: | (liczba zmiennoprzecinkowa) | minZoom. | |
| maxZoom: | (liczba zmiennoprzecinkowa) | maxZoom. | |
Ustawia minZoom i maxZoom.
Ta metoda oczekuje, że minimalna wartość będzie mniejsza od maksymalnej wartości lub jej równa. W przeciwnym razie zgłosi wyjątek o nazwie NSRangeWyjątek.
| – (wartość null: GMSCameraPosition *) CameraForBounds: | (GMSCoordinateBounds *) | granice | |
| wstawki: | (UIEdgeInsets) | insets | |
Utwórz element GMSCameraPosition, który prezentuje bounds z padding.
Kamera będzie miała zerowe kąty nachylenia i nachylenie (tzn. będzie skierowana na północ, prosto na Ziemię). Uwzględnia ramkę i dopełnienie tego obiektu GMSMapView.
Jeśli zakres jest nieprawidłowy, ta metoda zwraca aparat nil.
| - (void) moveCamera: | (GMSCameraUpdate *) | aktualizacja |
Zmienia aparat zgodnie z tym ustawieniem: update.
Zmiana kamery jest natychmiastowa (bez animacji).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
| pozycja: | (GMSCameraPosition *) | otherPosition (inne pozycje) | |
Weź pod uwagę poziom dokładności i przekształcenia stosowane wewnętrznie, aby sprawdzić, czy dane położenie kamery nie spowodowałoby wyrenderowania kamery w taki sam sposób.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | typ cechy |
Zwraca warstwę cech podanego typu.
Warstwy cech należy skonfigurować w konsoli Cloud.
Jeśli warstwa określonego typu nie istnieje na tej mapie, styl oparty na danych nie jest włączony lub jeśli platforma renderowania Metal nie jest używana, utworzona warstwa isAvailable ma wartość NO i nie będzie odpowiadać na żadne wywołania.
Wymaga mechanizmu renderowania Metal. Dowiedz się, jak włączyć Metal: https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
| - (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition (Pozycja aparatu) |
Aktywuje 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: | (liczba zmiennoprzecinkowa) | powiększenie |
Jako animateToCameraPosition:, ale zmienia tylko poziom powiększenia kamery.
Ta wartość jest ograniczana przez [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationDirection) | znośność |
Jako animateToCameraPosition: ale zmienia tylko kąt nachylenia kamery (w stopniach).
Zero wskazuje prawdziwą północ.
| - (void) animateToViewingAngle: | (liczba zmiennoprzecinkowa) | kąt widzenia |
jako animateToCameraPosition:, ale zmienia tylko kąt patrzenia kamery (w stopniach).
Wartość ta jest ograniczana do minimum 0 (tzn. prosto 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 właściwość cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób określony przez parametr 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<GMSMapViewOwnership>) delegate [read, write, assign] |
– (GMSCameraPosition*) aparat [read, write, copy] |
Steruje aparatem i określa orientację mapy.
Modyfikacja tej właściwości jest natychmiastowa.
- Odwzorowanie (GMSProjection*) [read, assign] |
Zwraca obiekt GMSProjection, którego można użyć do przekształcenia współrzędnych ekranu na współrzędne geograficzne.
To jest zrzut bieżącego widoku. Nie jest ono automatycznie aktualizowane, gdy kamera się porusza. Reprezentuje ono albo projekcję ostatniej narysowanej klatki GMSMapView, albo (w przypadku gdy kamera została ustawiona bezpośrednio lub nowo utworzona mapa), tzn. nadchodzącą klatką. Nigdy nie będzie zero.
– (BOOL) myLocationEnabled [read, write, assign] |
Określa, czy kropka i kółko dokładności Moja lokalizacja są włączone.
Wartość domyślna to NIE.
– (CLLocation*) myLocation [read, assign] |
Jeśli Moja lokalizacja jest włączona, pokazuje miejsce, w którym rysowana jest kropka lokalizacji urządzenia.
Jeśli to ustawienie jest wyłączone lub jest włączone, ale dane o lokalizacji nie są dostępne, ta wartość będzie 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 i wyświetlenia w nim okna informacyjnego. Jeśli właściwość jest inna niż zero, ustawienie wartości nil powoduje usunięcie zaznaczenia 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 przedstawiać dane o natężeniu ruchu, jeśli są dostępne.
Zależy to od dostępności danych o ruchu. Wartość domyślna to NIE.
– (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ść nil mapStyle jest stosowana tylko wtedy, gdy typ mapy ma wartość Normalny.
- (liczba zmiennoprzecinkowa) minZoom [read, assign] |
Minimalne powiększenie (największa odległość od kamery).
Wartość domyślna to kGMSMinZoomLevel. Zmodyfikowano za pomocą -setMinZoom:maxZoom:.
- (liczba zmiennoprzecinkowa) maxZoom [read, assign] |
Maksymalne powiększenie (najbliższe oddalenie kamery od Ziemi).
Wartość domyślna to kGMSMaxZoomLevel. Zmodyfikowano za pomocą -setMinZoom:maxZoom:.
– (BOOL) buildingsEnabled [read, write, assign] |
Po ustawieniu tej opcji budynki 3D będą wyświetlane, o ile są dostępne.
Wartość domyślna to TAK.
Może to być przydatne podczas dodawania do mapy niestandardowej warstwy kafelków, ponieważ zwiększa jej przejrzystość 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).
Wartość domyślna to TAK.
Jeśli zasada ma wartość NIE, pamięć podręczna danych z pomieszczenia może zostać opróżniona, 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 obserwację lub kontrolowanie różnych aspektów wyświetlania danych dotyczących wnętrz.
- (GMSUISettings*) ustawienia [read, assign] |
Pobiera obiekt GMSUISettings, który zarządza ustawieniami interfejsu mapy.
- Dopełnienie [read, write, assign] (UIEdgeInsets) |
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 jest zrównoważone, wizualne centrum widoku przesunie się odpowiednio. Dopełnienie będzie miało wpływ również na właściwość projection, więc widoczny region nie będzie zawierał dopełnienia. GMSCameraUpdate określa dopełnienie, które będzie uwzględniało zarówno to dopełnienie, jak i wszelkie jego żądane dopełnienia.
Ta właściwość może być animowana w bloku animacji opartym na UIView.
– (GMSMapViewPaddingAdjustBehavior) dopełnienie_Dopasowania [read, write, assign] |
Kontroluje sposób dodawania bezpiecznych obszarów do wartości dopełnienia.
Podobnie jak dopełnienie, bezpieczny obszar wprowadza elementy sterujące mapą, takie jak kompas, przycisk mojej lokalizacji i selektor podłogi w bezpiecznym obszarze urządzenia.
Wartość domyślna to kGMSMapViewPaddingAdjustBehaviorzawsze.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Wartość domyślna to TAK.
Jeśli 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.
– warstwa [read, retain] (GMSMapLayer*) |
Metoda dostępu niestandardowego typu warstwy CALayer używanego w warstwie.
– (GMSFrameRate) PreferredFrameRate [read, write, assign] |
Steruje liczbą klatek renderowania.
Wartość domyślna to kGMSFrameRateMaks.
– (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Jeśli wartość nie jest określona, ogranicza cel kamery, tak aby gesty nie mogły opuścić określonych granic.
– (GMSMapCapabilityFlags) Możliwości map [read, assign] |
Wszystkie funkcje dostępne warunkowo (w zależności od identyfikatora mapy lub innych ustawień mapy), które są obecnie dostępne.
Nie obejmuje zawsze dostępnych funkcji.