Dokumentacja klasy GMSMapView

Inicjuje się przy użyciu CGRectZero i opcji domyślnych.

Tworzy nowy widok mapy z podanymi opcjami.

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

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

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

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

Uwaga:

Ta wersja została wycofana. Użyj polecenia -init lub -initWithOptions:.

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

Uwaga:

Ta wersja została wycofana. Użyj polecenia -init lub -initWithOptions:.

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.

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.

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.

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.

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.

Zmienia działanie kamery zgodnie z zasadą update.

Zmiana aparatu jest natychmiastowa (bez animacji).

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.

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.

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.

Unieważnia widok akcesoriów i aktywuje nowy układ tego widoku.

Musisz wybrać jeden z aktualnych widoków akcesoriów. Jeśli wskazówki są nieaktywne, ta rozmowa jest instrukcją NO-OP.

Ustawia pozycję widoku akcesoriów pod głównym nagłówkiem interfejsu nawigacyjnego.

Przekazanie wartości nil powoduje usunięcie widoku akcesorium. Jeśli wskazówki są nieaktywne, ta rozmowa jest instrukcją NO-OP.

@note Jeśli widok mapy jest krótki, pakiet SDK ukrywa widok akcesoriów ze względu na ograniczoną ilość miejsca. Widoki są zarządzane wewnętrznie w celu optymalizacji wyświetlania mapy.

Powoduje animowanie kamery mapy na cameraPosition.

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

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

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

Jako animateToCameraPosition:, ale zmienia tylko położenie kamery (w stopniach).

0 wskazuje prawdziwą północ.

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.

Stosuje metodę cameraUpdate do bieżącej kamery, a następnie używa wyniku w sposób zgodny z animmateToCameraPosition:.

Aby zaimplementować gesty przesuwania w szablonach map CarPlay, ta metoda powinna być wywoływana z implementacji metody CPMapTemplateDelegate metody -mapTemplate aplikacjaStartPanGesty:

Aby zaimplementować gesty przesuwania w szablonach map CarPlay, ta metoda powinna być wywoływana z implementacji metody CPMapTemplateDelegate metody -mapTemplate:didUpdatePanConsentWithTranslation:

Aby zaimplementować gesty przesuwania w szablonach map CarPlay, ta metoda powinna być wywoływana z implementacji metody CPMapTemplateDelegate metody -mapTemplate:didEndPanConsentWithVelocity:.

Rozpoczyna nawigację w tym widoku mapy od danej sesji nawigacji.

Uwaga:

Aby zmaksymalizować wykorzystanie pamięci i procesora, wywołaj tę metodę przed wywołaniem innych metod związanych z nawigacją w tym widoku mapy.

.

Zwroty:

Informacja o tym, czy nawigacja została uruchomiona (na przykład jeśli warunki korzystania z usługi nie zostały jeszcze zaakceptowane), na przykład wyświetli się komunikat NIE.

Identyfikator ułatwień dostępu dla przycisku kompasu.

Identyfikator ułatwień dostępu w sekcji „moja lokalizacja” Przycisk

Identyfikator ułatwień dostępu „Przekroczono limit” .

Delegat GMSMapView.

Kontroluje kamerę, która określa orientację mapy.

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

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.

Określa, czy punkt Moja lokalizacja i okrąg dokładności mają być włączone.

Domyślna wartość to NO.

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.

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.

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.

Określa typ fragmentów mapy, które powinny być wyświetlane.

Wartość domyślna to kGMSTypeNormal.

Określa styl mapy.

Atrybut mapStyle o wartości innej niż nil będzie stosowany tylko wtedy, gdy atrybut mapType ma wartość Normal.

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.

Minimalny zoom (może być oddalony, jeśli kamera jest oddalona)

Wartość domyślna to kGMSMinZoomLevel. Zmodyfikowano za pomocą polecenia -setMinZoom:maxZoom:.

Maksymalne powiększenie (najbliższa kamera znajduje się najbliżej Ziemi).

Wartość domyślna to kGMSMaxZoomLevel. Zmodyfikowano za pomocą polecenia -setMinZoom:maxZoom:.

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.

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.

Pobiera instancję GMSIndoorDisplay, która umożliwia obserwowanie aspektów wyświetlania danych wewnętrznych lub sterowanie nimi.

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

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.

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.

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.

Metoda dostępu niestandardowego typu CALayer używanego na potrzeby warstwy.

Kontroluje liczbę klatek podczas renderowania.

Wartość domyślna to kGMSFrameRateMax.

Jeśli nie ma wartości nil, cel aparatu ogranicza cel aparatu tak, aby gesty nie mogły przekraczać określonych granic.

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.

Delegat GMSMapView, który otrzymuje wywołania zwrotne dla zdarzeń interfejsu nawigacji.

Określa, czy funkcja nawigacji jest włączona dla tej mapy.

Jeśli wybierzesz TAK, na mapie będą się wyświetlać trasy i szczegółowe wskazówki dojazdu, a kamera będzie mogła przejść w następujący tryb, a gdy kamera nie będzie śledzić lokalizacji urządzenia, pojawi się przycisk wyśrodkowania.

Jeśli użytkownik nie zaakceptował warunków korzystania z Nawigacji Google, ustawienie tej właściwości nie przyniesie żadnego efektu. Aby wyświetlić okno z warunkami korzystania z usługi, zapoznaj się z metodami na stronie GMSNavigationServices.

Nawigacja w tym elemencie GMSMapView, który umożliwia wybór trasy i uruchamianie szczegółowych wskazówek.

Jeśli użytkownik nie zaakceptował Warunków korzystania z usługi Nawigacja Google, nie ma to znaczenia. Aby wyświetlić okno z warunkami korzystania z usługi, zapoznaj się z metodami na stronie GMSNavigationServices.

Zezwala na subskrypcję aktualizacji lokalizacji przyłączonych do drogi.

Jeśli użytkownik nie zaakceptował Warunków korzystania z usługi Nawigacja Google, nie ma to znaczenia. Aby wyświetlić okno z warunkami korzystania z usługi, zapoznaj się z metodami na stronie GMSNavigationServices.

Umożliwia symulację lokalizacji urządzenia.

Symulowana lokalizacja wpływa na pozycję ikony na mapie, postęp nawigacji zakręt po zakręcie oraz aktualizacje dostarczane przez dostawcę lokalizacji przypisanej do drogi.

Jeśli użytkownik nie zaakceptował Warunków korzystania z usługi Nawigacja Google, nie ma to znaczenia. Aby wyświetlić okno z warunkami korzystania z usługi, zapoznaj się z metodami na stronie GMSNavigationServices.

Tryb kamery, który określa jej działanie, gdy właściwość nawigacjaEnabled ma wartość YES.

Informacje o dostępnych trybach znajdziesz na stronie GMSNavigationCameraMode.

Perspektywa aparatu, która będzie używana podczas śledzenia lokalizacji urządzenia.

Aby ta perspektywa zaczęła obowiązywać, właściwość navigationEnabled musi być ustawiona na YES, a cameraMode musi mieć wartość GMSNavigationCameraModeFollowing.

Tryb podróży, który określa rodzaj pobieranych tras i sposób wyznaczania trasy na urządzeniu.

W trybie samochodowym trasa zależy od kierunku ruchu, a w trybie rowerowym lub pieszym trasa przebiega według kierunku kompasu. Kurs urządzenia jest reprezentowany przez kierunek znacznika lokalizacji urządzenia i raportowany przez GMSRoadSnappedLocationProvider.

Tryb oświetlenia określa schemat kolorów, który ma być używany do renderowania mapy.

Służy również do określania domyślnych kolorów różnych elementów interfejsu.

Określa, czy ograniczenie prędkości powinno być wyświetlane, gdy włączone jest wskazówki, a dane o ograniczeniach prędkości są dostępne.

Wartość domyślna to NIE.

Określa, czy wyświetlana jest ikona prędkościomierza.

Gdy ta opcja jest włączona, podczas korzystania ze wskazówek w dolnym rogu wyświetla się ikona prędkościomierza. Jeśli dostępne są wiarygodne dane o ograniczeniach prędkości, wyświetla się też ikona prędkościomierza. Ikona prędkościomierza może mieć różne kolory tekstu i tła, w zależności od wagi alertu o prędkości.

Jeśli przycisk ponownego wyśrodkowania jest włączony, limit prędkości i ikona prędkościomierza są tymczasowo ukryte, gdy wyświetla się przycisk ponownego wyśrodkowania.

Prostokąt zakryty nagłówkiem nawigacyjnym.

Wysokość wynosi zero, gdy nagłówek jest ukryty.

Prostokąt zakryty stopką nawigacyjną.

Wysokość wynosi zero, gdy stopka jest ukryta.

Określa format objaśnienia trasy (domyślny, czas lub odległość).

Spersonalizowany poziom powiększenia podczas nawigacji.

Ustawienie tej wartości zastępuje domyślny poziom powiększenia w pakiecie SDK nawigacji, gdy kamera śledzi lokalizację urządzenia (np. cameraMode równa się GMSNavigationCameraModeFollowing). Jeśli nie chcesz korzystać z zastępowania poziomu powiększenia, możesz ustawić wartość GMSNavigationNoFollowingZoomLevel.

Ustawia dostawcę usługi Moja lokalizacja dla tego widoku mapy.

Zazwyczaj punkt „Moja lokalizacja” i okrąg dokładności w widoku mapy są generowane na podstawie rzeczywistej lokalizacji urządzenia. Po ustawieniu tej właściwości kropka Moja lokalizacja i okrąg dokładności będą określane na podstawie lokalizacji określonej przez dostawcę lokalizacji. Aby przywrócić normalne działanie, ustaw wartość tej właściwości na nil.

Nie działa to, gdy w tym widoku mapy jest włączona opcja navigationEnabled.