Omówienie
To główna klasa pakietu SDK Map Google na iOS i punkt początkowy wszystkich metod związanych z mapą.
Mapę należy utworzyć za pomocą jednego z konstruktorów -init lub -initWithOptions:.
Obiekt GMSMapView można odczytywać i modyfikować tylko z wątku głównego, 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 | |
| (instancetype) | - init |
| Inicjuje się przy użyciu CGRectZero i opcji domyślnych. | |
| (instancetype) | – initWithOptions: |
| Tworzy nowy widok mapy z podanymi opcjami. | |
| (instancetype) | – initWithFrame: |
| (dopuszczalny typ instancji) | – initWithCoder: |
| (instancetype) | – initWithFrame:camera: |
| Tworzy i zwraca widok mapy z ramką i celem kamery. | |
| (instancetype) | – initWithFrame:mapID:camera: |
| 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ę o wyłączeniu mechanizmu renderowania. | |
| (Nieważna) | - wyczyść |
| Usuwa wszystkie znaczniki, które zostały dodane do mapy, w tym znaczniki, linie łamane i nakładki na teren. | |
| (Nieważna) | – setMinZoom:maxZoom: |
Ustawia minZoom i maxZoom. | |
| (dopuszczalna wartość null w polu GMSCameraPosition *) | - cameraForBounds:insets: |
Utwórz funkcję GMSCameraPosition, która przedstawia bounds z parametrem padding. | |
| (Nieważna) | - moveCamera: |
Zmienia działanie kamery zgodnie z zasadą update. | |
| (wartość logiczna) | – areEqualForRenderingPosition:position: |
| Weź pod uwagę poziom dokładności i przekształcenia używane wewnętrznie, aby sprawdzić, czy dane ustawienie kamery spowodowałoby takie samo wyrenderowanie obrazu. | |
| (GMSFeatureLayer < GMSPlaceFeature* > *). | – featureLayerOfFeatureType: |
| Zwraca warstwę cech określonego typu. | |
| (GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
| Zwraca warstwę cech określonego zbioru danych. | |
| (Nieważna) | - animateToCameraPosition: |
Powoduje animowanie kamery mapy na cameraPosition. | |
| (Nieważna) | – animateToLocation: |
Jako animacjaToCameraPosition:, 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 położenie kamery (w stopniach). | |
| (Nieważna) | – animateToViewingAngle: |
| Jako animateToCameraPosition:, ale zmienia tylko kąt patrzenia kamery (w stopniach). | |
| (Nieważna) | – animateWithCameraUpdate: |
Stosuje metodę cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób zgodny z animmateToCameraPosition:. | |
Statyczne funkcje publiczne | |
| (instancetype) | + mapWithFrame:camera: |
| Tworzy i zwraca widok mapy z ramką i celem kamery. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery. | |
Właściwości | |
| Identyfikator IBOutlet< GMSMapViewDelegate > | przekazanie |
| Delegat GMSMapView. | |
| GMSCameraPosition * | 64 Mpix |
| Kontroluje kamerę, która określa orientację mapy. | |
| GMSProjection * | prognoza |
| Zwraca obiekt GMSProjection, którego można użyć do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej. | |
| WARTOŚĆ | myLocationEnabled |
| Określa, czy punkt Moja lokalizacja i okrąg dokładności mają być włączone. | |
| CLLocation * | myLocation |
| Jeśli włączona jest funkcja Moja lokalizacja, można sprawdzić, gdzie rysowana jest kropka lokalizacji urządzenia. | |
| GMSMarker * | selectedMarker |
| wybrany znacznik. | |
| WARTOŚĆ | trafficEnabled |
| Określa, czy na mapie są pokazywane dane o natężeniu ruchu (jeśli są dostępne). | |
| GMSMapViewType | mapType |
| Określa typ fragmentów mapy, które powinny być wyświetlane. | |
| GMSMapStyle * | mapStyle |
| Określa styl mapy. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Zmień mapę na odpowiedni [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc). | |
| liczba zmiennoprzecinkowa | minZoom |
| Minimalny zoom (może być oddalony, jeśli kamera jest oddalona) | |
| liczba zmiennoprzecinkowa | maxZoom |
| Maksymalne powiększenie (najbliższa kamera znajduje się najbliżej Ziemi). | |
| WARTOŚĆ | buildingsEnabled |
| Jeśli jest skonfigurowana, budynki 3D będą wyświetlane tam, gdzie są dostępne. | |
| WARTOŚĆ | indoorEnabled |
| Określa, czy mają być wyświetlane mapy obiektów (jeśli są dostępne). | |
| GMSIndoorDisplay * | indoorDisplay |
| Pobiera instancję GMSIndoorDisplay, która umożliwia obserwowanie aspektów wyświetlania danych wewnętrznych lub sterowanie nimi. | |
| GMSUISettings * | ustawienia |
| Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy. | |
| UIEdgeInsets | dopełnienie |
| Kontroluje widoczność obszaru widoku. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Kontroluje sposób dodawania wektorów bezpiecznego obszaru do wartości dopełnienia. | |
| WARTOŚĆ | accessibilityElementsHidden |
| Wartość domyślna to TAK. | |
| GMSMapLayer * | warstwa |
| Metoda dostępu niestandardowego typu CALayer używanego na potrzeby warstwy. | |
| GMSFrameRate | preferredFrameRate |
| Kontroluje liczbę klatek podczas renderowania. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Jeśli nie ma wartości nil, cel aparatu ogranicza cel aparatu tak, aby gesty nie mogły przekraczać określonych granic. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Wszystkie funkcje dostępne warunkowo (w zależności od identyfikatora mapID lub innych ustawień mapy), które są dostępne w danej chwili. | |
Powiązane funkcje | |
(Pamiętaj, że nie są to funkcje składowe). | |
| NSString *stały | kGMSAccessibilityCompass |
| Identyfikator ułatwień dostępu dla przycisku kompasu. | |
| NSString *stały | kGMSAccessibilityMyLocation |
| Identyfikator ułatwień dostępu w sekcji „moja lokalizacja” Przycisk | |
| NSString *stały | kGMSAccessibilityOutOfQuota |
| Identyfikator ułatwień dostępu „Przekroczono limit” . | |
Dokumentacja funkcji członków
| - (typ instancji) init |
Inicjuje się przy użyciu CGRectZero i opcji domyślnych.
| – (typ instancji) initWithOptions: | (nonnull GMSMapViewOptions *) | opcje |
Tworzy nowy widok mapy z podanymi opcjami.
Wartość obiektu options jest kopiowana przez tę metodę.
| – (typ instancji) initWithFrame: | (CGRect) | ramka |
| - (typ instancji do wartości null) initWithCoder: | (NSCoder *) | koder |
| + (typ instancji) mapWithFrame: | (CGRect) | ramka | |
| aparat: | (GMSCameraPosition* (położenie kamery GMS)* | 64 Mpix | |
Tworzy i zwraca widok mapy z ramką i celem kamery.
| + (typ instancji) mapWithFrame: | (CGRect) | ramka | |
| mapID: | (GMSMapID *) | mapID | |
| aparat: | (GMSCameraPosition* (położenie kamery GMS)* | 64 Mpix | |
Wygodny inicjator do tworzenia i zwracania widoku mapy z ramką, identyfikatorem mapy i celem kamery.
| – (typ instancji) initWithFrame: | (CGRect) | ramka | |
| aparat: | (GMSCameraPosition* (położenie kamery GMS)* | 64 Mpix | |
Tworzy i zwraca widok mapy z ramką i celem kamery.
- Uwaga:
- Ta wersja została wycofana. Użyj polecenia -init lub -initWithOptions:.
| – (typ instancji) initWithFrame: | (CGRect) | ramka | |
| mapID: | (GMSMapID *) | mapID | |
| aparat: | (GMSCameraPosition* (położenie kamery GMS)* | 64 Mpix | |
Tworzy i zwraca widok mapy z ramką, identyfikatorem mapy i celem kamery.
- Uwaga:
- Ta wersja została wycofana. Użyj polecenia -init lub -initWithOptions:.
| - (void) startRendering |
Informuje tę mapę, że ma włączyć mechanizm renderowania.
Jest opcjonalny i idempotentny.
- Uwaga:
- Ta wersja została wycofana. Ta metoda jest nieaktualna i zostanie usunięta w przyszłej wersji.
| - (void) stopRendering |
Informuje tę mapę o wyłączeniu mechanizmu renderowania.
Jest opcjonalny i idempotentny.
- Uwaga:
- Ta wersja została wycofana. Ta metoda jest nieaktualna i zostanie usunięta w przyszłej wersji.
| – (void) wyczyść |
Usuwa wszystkie znaczniki, które zostały dodane do mapy, w tym znaczniki, linie łamane i nakładki na teren.
Nie spowoduje to usunięcia widocznej kropki lokalizacji ani zresetowania bieżącego obiektu mapType.
| - (void) setMinZoom: | (liczba zmiennoprzecinkowa) | minZoom | |
| maxZoom: | (liczba zmiennoprzecinkowa) | maxZoom | |
Ustawia minZoom i maxZoom.
Ta metoda wymaga, aby wartość minimalna była mniejsza od wartości maksymalnej lub jej równa. W przeciwnym razie zgłasza wyjątek o nazwie NSRangeException.
| - (wartość null GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | granice | |
| wcięcia: | (UIEdgeInsets) | zestawy instruktażowe | |
Utwórz funkcję GMSCameraPosition, która przedstawia bounds z parametrem padding.
Kamera będzie miała zerowe położenie i przechylenie (tzn. jest skierowana na północ, patrząc bezpośrednio na Ziemię). Ta opcja uwzględnia ramkę i dopełnienie GMSMapView.
Jeśli granice są nieprawidłowe, ta metoda zwraca kamerę nil.
| - (void) moveCamera: | (GMSCameraUpdate *) | zaktualizuj |
Zmienia działanie kamery zgodnie z zasadą update.
Zmiana aparatu jest natychmiastowa (bez animacji).
| – (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition* (położenie kamery GMS)* | pozycja | |
| pozycja: | (GMSCameraPosition* (położenie kamery GMS)* | otherPosition | |
Weź pod uwagę poziom dokładności i przekształcenia używane wewnętrznie, aby sprawdzić, czy dane ustawienie kamery spowodowałoby takie samo wyrenderowanie obrazu.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
Zwraca warstwę cech określonego typu.
Warstwy cech należy skonfigurować w konsoli Cloud.
Jeśli na tej mapie nie ma warstwy określonego typu, styl oparty na danych nie jest włączony lub jeśli nie jest używana platforma renderowania Metal, wartość „isAvailable” w warstwie wynikowej ma wartość NO i nie będzie odpowiadać na żadne wywołania.
Wymaga mechanizmu renderowania Metal. Aby dowiedzieć się, jak włączyć Metal, wejdź na https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.
| – (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
Zwraca warstwę cech określonego zbioru danych.
Identyfikatory zbiorów danych należy skonfigurować w konsoli Cloud.
Jeśli na tej mapie nie istnieje zbiór danych o podanym identyfikatorze lub styl oparty na danych nie jest włączony, w wartości „isAvailable” warstwy wynikowej będzie mieć wartość NO i nie będzie ona odpowiadać na żadne wywołania.
| - (void) animateToCameraPosition: (animateToCameraPosition) | (GMSCameraPosition* (położenie kamery GMS)* | cameraPosition |
Powoduje animowanie kamery mapy na cameraPosition.
| - (void) animateToLocation: | (CLLocationCoordinate2D) | lokalizacja |
Jako animacjaToCameraPosition:, 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 ustawienie [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationDirection) | bearing |
Jako animateToCameraPosition:, ale zmienia tylko położenie kamery (w stopniach).
0 wskazuje prawdziwą północ.
| - (void) animateToViewingAngle: | (liczba zmiennoprzecinkowa) | viewingAngle |
Jako animateToCameraPosition:, ale zmienia tylko kąt patrzenia kamery (w stopniach).
Wartość ta zostanie ograniczona do minimum zera (tzn. skrajnie w dół) oraz od 30 do 45 stopni w kierunku horyzontu, w zależności od względnego odległości od Ziemi.
| - (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Stosuje metodę cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób zgodny z animmateToCameraPosition:.
Dokumentacja funkcji Znajomi i powiązane funkcje
– (NSString* const) kGMSAccessibilityCompass [related] |
Identyfikator ułatwień dostępu dla przycisku kompasu.
– (NSString* const) kGMSAccessibilityMyLocation [related] |
Identyfikator ułatwień dostępu w sekcji „moja lokalizacja” Przycisk
– (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Identyfikator ułatwień dostępu „Przekroczono limit” .
Dokumentacja usługi
- (IBOutlet id<GMSMapViewDelegate>) Delegegate [read, write, assign] |
Delegat GMSMapView.
- (GMSCameraPosition*) kamera [read, write, copy] |
Kontroluje kamerę, która określa orientację mapy.
Zmiana tej właściwości jest natychmiastowa.
– (GMSProjection*) Prognoza [read, assign] |
Zwraca obiekt GMSProjection, którego można użyć do konwertowania współrzędnych ekranu na współrzędne szerokości i długości geograficznej.
To jest migawka bieżącego projekcji i nie jest automatycznie aktualizowana, gdy kamera się porusza. Przedstawia on rzutowanie ostatniej utworzonej klatki GMSMapView albo w którym kamera została ustawiona lub właśnie została utworzona mapa czy nadchodząca klatka. Nigdy nie będzie nil.
– (BOOL) myLocationEnabled [read, write, assign] |
Określa, czy punkt Moja lokalizacja i okrąg dokładności mają być włączone.
Domyślna wartość to NO.
– (CLLocation*) myLocation [read, assign] |
Jeśli włączona jest funkcja Moja lokalizacja, można sprawdzić, gdzie rysowana jest kropka lokalizacji urządzenia.
Jeśli jest wyłączona lub włączona, ale dane o lokalizacji nie są dostępne, 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świetlenie na nim okna informacyjnego. Jeśli ta właściwość ma wartość inną niż nil, ustawienie jej na wartość nil powoduje usunięcie zaznaczenia znacznika, co powoduje ukrycie okna informacyjnego. Tę właściwość można obserwować za pomocą KVO.
– (BOOL) – trafficEnabled [read, write, assign] |
Określa, czy na mapie są pokazywane dane o natężeniu ruchu (jeśli są dostępne).
Zależy to od dostępności danych o ruchu. Domyślna wartość to NO.
– (GMSMapViewType) mapType [read, write, assign] |
Określa typ fragmentów mapy, które powinny być wyświetlane.
Wartość domyślna to kGMSTypeNormal.
– (GMSMapStyle*) mapStyle [read, write, assign] |
Określa styl mapy.
Atrybut mapStyle o wartości innej niż nil będzie stosowany tylko wtedy, gdy atrybut mapType ma wartość Normal.
– (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Zmień mapę na odpowiedni [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc).
Zastępuje to domyślne działanie UIKit i domyślnie ustawia UIUserInterfaceStyleLight, aby zapewnić zgodność wsteczną. Ma to wpływ na schemat kolorów map Normalny i Teren.
– (liczba zmiennoprzecinkowa) minZoom [read, assign] |
Minimalny zoom (może być oddalony, jeśli kamera jest oddalona)
Wartość domyślna to kGMSMinZoomLevel. Zmodyfikowano za pomocą polecenia -setMinZoom:maxZoom:.
– (liczba zmiennoprzecinkowa) maxZoom [read, assign] |
Maksymalne powiększenie (najbliższa kamera znajduje się najbliżej Ziemi).
Wartość domyślna to kGMSMaxZoomLevel. Zmodyfikowano za pomocą polecenia -setMinZoom:maxZoom:.
– (BOOL) buildingsEnabled [read, write, assign] |
Jeśli jest skonfigurowana, budynki 3D będą wyświetlane tam, gdzie są dostępne.
Wartość domyślna to TAK.
Może to być przydatne przy dodawaniu do mapy niestandardowej warstwy kafelków, by poprawić jej czytelność przy dużym powiększeniu. Zmiana tej wartości spowoduje krótką 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ęci podręczne danych wewnętrznych mogą zostać trwale usunięte, a każde piętro wybrane przez użytkownika może zostać zresetowane.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Pobiera instancję GMSIndoorDisplay, która umożliwia obserwowanie aspektów wyświetlania danych wewnętrznych lub sterowanie nimi.
- (GMSUISettings*) ustawienia [read, assign] |
Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy.
– (UIEdgeInsets) dopełnienie [read, write, assign] |
Kontroluje widoczność obszaru widoku.
Dzięki dopełnieniu można utworzyć obszar wokół krawędzi widoku, który będzie zawierał dane mapy, ale nie będzie zawierać elementów sterujących interfejsu.
Jeśli dopełnienie nie jest zrównoważone, wizualny środek widoku zostanie odpowiednio przesunięty. Dopełnienie wpływa też na właściwość projection, więc widoczny obszar nie będzie zawierał obszaru dopełnienia. Funkcja GMSCameraUpdate fitToBounds zagwarantuje, że zarówno to dopełnienie, jak i wszystkie żądane dopełnienia zostaną uwzględnione.
Ta właściwość może być animowana w bloku animacji opartym na UIView.
– (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Kontroluje sposób dodawania wektorów bezpiecznego obszaru do wartości dopełnienia.
Podobnie jak dopełnienie, wektory bezpiecznego obszaru wbudowują elementy sterujące mapą położenia, takie jak kompas, przycisk lokalizacji i selektor pięter, w bezpiecznym obszarze urządzenia.
Wartość domyślna to kGMSMapViewPaddingadBehaviorZawsze.
– (BOOL) accessibilityElementsHidden [read, write, assign] |
Wartość domyślna to TAK.
Jeśli ustawisz wartość NIE, GMSMapView wygeneruje elementy ułatwień dostępu dla obiektów nakładek, takich jak GMSMarker i GMSPolyline.
Ta usługa jest zgodna z nieformalnym protokołem UIUłatwienia dostępu, z wyjątkiem domyślnej wartości YES.
- (GMSMapLayer*) warstwa [read, retain] |
Metoda dostępu niestandardowego typu CALayer używanego na potrzeby warstwy.
– (GMSFrameRate) preferredFrameRate [read, write, assign] |
Kontroluje liczbę klatek podczas renderowania.
Wartość domyślna to kGMSFrameRateMax.
– (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Jeśli nie ma wartości nil, cel aparatu ogranicza cel aparatu tak, aby gesty nie mogły przekraczać określonych granic.
– (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Wszystkie funkcje dostępne warunkowo (w zależności od identyfikatora mapID lub innych ustawień mapy), które są dostępne w danej chwili.
Nie obejmuje zawsze dostępnych funkcji.