Przegląd
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: |
(typ instancji, w którym można wpisać wartość null) | – 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. | |
(void) | - startRendering |
Informuje tę mapę, że ma włączyć mechanizm renderowania. | |
(void) | - stopRendering |
Informuje tę mapę o wyłączeniu mechanizmu renderowania. | |
(void) | - wyczyść |
Usuwa wszystkie znaczniki, które zostały dodane do mapy, w tym znaczniki, linie łamane i nakładki na teren. | |
(void) | – setMinZoom:maxZoom: |
Ustawia minZoom i maxZoom . | |
(nullable GMSCameraPosition *) | - cameraForBounds:insets: |
Utwórz funkcję GMSCameraPosition, która przedstawia bounds z parametrem padding . | |
(void) | - moveCamera: |
Zmienia działanie kamery zgodnie z zasadą update . | |
(BOOL) | – 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. | |
(void) | - animateToCameraPosition: |
Powoduje animowanie kamery mapy na cameraPosition . | |
(void) | – animateToLocation: |
Jako animacjęToCameraPosition:, ale zmienia tylko lokalizację kamery (np. z bieżącej lokalizacji na location ). | |
(void) | – animateToZoom: |
Jako animateToCameraPosition:, ale zmienia tylko poziom powiększenia kamery. | |
(void) | – animateToBearing: |
Jako animateToCameraPosition:, ale zmienia tylko położenie kamery (w stopniach). | |
(void) | – animateToViewingAngle: |
Jako animateToCameraPosition:, ale zmienia tylko kąt patrzenia kamery (w stopniach). | |
(void) | – animateWithCameraUpdate: |
Stosuje metodę cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób zgodny z animmateToCameraPosition:. | |
Statyczne publiczne funkcje składowe | |
(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. | |
Usługi | |
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. | |
BOOL | 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. | |
BOOL | 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. | |
float | minZoom |
Minimalny zoom (może być oddalony, jeśli kamera jest oddalona) | |
float | maxZoom |
Maksymalne powiększenie (najbliższa kamera znajduje się najbliżej Ziemi). | |
BOOL | buildingsEnabled |
Jeśli jest skonfigurowana, budynki 3D będą wyświetlane tam, gdzie są dostępne. | |
BOOL | 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 obserwację lub kontrolowanie aspektów wyświetlania danych wewnętrznych. | |
GMSUISettings * | ustawienia |
Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy. | |
UIEdgeInsets | dopełnienie |
Steruje „widocznym” obszarem widoku. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
Kontroluje sposób dodawania wektorów bezpiecznego obszaru do wartości dopełnienia. | |
BOOL | 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 *const | kGMSAccessibilityCompass |
Identyfikator ułatwień dostępu dla przycisku kompasu. | |
NSString *const | kGMSAccessibilityMyLocation |
Identyfikator ułatwień dostępu dla przycisku „moja lokalizacja”. | |
NSString *const | kGMSAccessibilityOutOfQuota |
Identyfikator ułatwień dostępu dla etykiety błędu „Przekroczono limit”. |
Dokumentacja funkcji członków
- (typ instancji) init |
Inicjuje się przy użyciu CGRectZero i opcji domyślnych.
– (typ instancji) initWithOptions: | (wartość inna niż 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 *) | camera | |
Tworzy i zwraca widok mapy z ramką i celem kamery.
+ (typ instancji) mapWithFrame: | (CGRect) | ramka | |
identyfikator_map: | (GMSMapID *) | mapID | |
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.
- Uwaga:
- Ta wersja została wycofana. Użyj polecenia -init lub -initWithOptions:.
– (typ instancji) initWithFrame: | (CGRect) | ramka | |
identyfikator_map: | (GMSMapID *) | mapID | |
aparat: | (GMSCameraPosition *) | camera | |
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: | (float) | minZoom | |
maxZoom: | (float) | 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.
- (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | granice | |
wcięcia: | (UIEdgeInsets) | insets, | |
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 *) | pozycja | |
pozycja: | (GMSCameraPosition *) | 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, wynikowa warstwa isAvailable 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 ma zbioru danych o podanym identyfikatorze lub jeśli styl oparty na danych nie jest włączony, isAvailable
warstwy wynikowej będzie miał wartość NO
i nie będzie odpowiadać na żadne wywołania.
- (void) animateToCameraPosition: (animateToCameraPosition) | (GMSCameraPosition *) | 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: | (float) | 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 dla przycisku „moja lokalizacja”.
– (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Identyfikator ułatwień dostępu dla etykiety błędu „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 ona rzut ostatniej klatki GMSMapView lub kolejną klatkę, w przypadku której kamera została jawnie ustawiona lub właśnie została utworzona mapa. 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.
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 obserwację lub kontrolowanie aspektów wyświetlania danych wewnętrznych.
- (GMSUISettings*) ustawienia [read, assign] |
Pobiera obiekt GMSUISettings, który kontroluje ustawienia interfejsu użytkownika mapy.
– (UIEdgeInsets) dopełnienie [read, write, assign] |
Steruje „widocznym” obszarem 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.