Konfigurowanie mapy

Wybierz platformę: Android iOS

W tym omówieniu opisano, jak skonfigurować mapę dodaną do aplikacji na iOS za pomocą pakietu Maps SDK na iOS.

Przegląd

Po dodaniu mapy do aplikacji możesz skonfigurować jej opcje początkowe i ustawienia środowiska wykonawczego. Szczegółowe informacje o dodawaniu kontenera mapy znajdziesz w artykule Dodawanie mapy.

Początkowe ustawienia mapy obejmują:

• Pozycja kamery, w tym: lokalizacja, powiększenie, kierunek i nachylenie. Szczegółowe informacje o ustawianiu kamery znajdziesz w sekcji Kamera i widok.
• Kolor tła mapy.
• Typ mapy.
• Komponenty interfejsu, które mają być wyświetlane, takie jak przyciski powiększenia i kompas.
• Gesty, które chcesz włączyć.

W czasie działania możesz skonfigurować te i niektóre dodatkowe ustawienia, aktualizując obiekt GMSMapView.

Opcje mapy

Podczas inicjowania widoku mapy opcje konfiguracji są ustawiane za pomocą GMSMapViewOptions. Właściwości opcji to frame, camera, mapID lub backgroundColor.

Opcje mapy
rama łóżka	Wartość: CGRect Ramka mapy. Domyślna wartość to CGRectZero.
aparat	Wartość: GMSCameraPosition Domyślna pozycja kamery na mapie.
mapID	Wartość: GMSMapID Identyfikator mapy Google. Parametr opcjonalny.
backgroundColor	Wartość: UIColor Domyślna wartość to UIColor.lightGray

Konfigurowanie opcji mapy

Możesz ustawić własne właściwości opcji lub przekazać instancję GMSMapViewOptions z wartościami domyślnymi bezpośrednio do GMSMapView.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Oto przykład przekazywania obiektu GMSMapViewOptions z wartościami domyślnymi bezpośrednio do GMSMapView.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Konfigurowanie koloru tła

Podczas pracy w trybie ciemnym lub przełączania się między widokami mapy przydatne może być zastąpienie domyślnego koloru tła mapy. Można to zrobić, ustawiając właściwość opcji mapy backgroundColor.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Uwaga: do skonfigurowania koloru tła możesz też użyć definiowania stylów map w Google Cloud. Kolor tła ustawiony w stylach map ma wyższy priorytet niż lokalny kolor tła. Więcej informacji znajdziesz w artykule Zmienianie koloru tła aplikacji dotyczącym definiowania stylów map w Google Cloud.

Typy map

Możesz dostosować mapę, wybierając jeden z kilku typów map. Typ mapy określa jej ogólny wygląd. Na przykład atlas zwykle zawiera mapy polityczne, które skupiają się na pokazywaniu granic, oraz mapy drogowe, które pokazują wszystkie drogi w mieście lub regionie. Maps SDK na iOS oferuje te typy map:

Typ mapy
Normalna	Wartość: kGMSTypeNormal Typowa mapa drogowa. Pokazuje drogi, niektóre obiekty stworzone przez człowieka i ważne obiekty naturalne, takie jak rzeki. Widoczne są też etykiety dróg i obiektów. Obsługuje ustawianie schematu kolorów mapy na ciemny, jasny lub zgodny z ustawieniami systemu.
Ruch hybrydowy	Wartość: kGMSTypeHybrid Dane zdjęć satelitarnych z dodatkiem map drogowych. Widoczne są też etykiety dróg i obiektów.
Satelita	Wartość: kGMSTypeSatellite Dane ze zdjęć satelitarnych. Etykiety dróg i obiektów nie są widoczne.
Teren	Wartość: kGMSTypeTerrain Dane topograficzne. Mapa zawiera kolory, linie konturowe i etykiety oraz cieniowanie perspektywiczne. Widoczne są też niektóre drogi i etykiety. Obsługuje ustawianie schematu kolorów mapy na ciemny, jasny lub zgodny z ustawieniami systemu.
Brak	Wartość: kGMSTypeNone Brak kafelków mapy. Kafelki mapy podstawowej nie będą renderowane. Ten tryb jest przydatny w połączeniu z warstwami kafelków. Wyświetlanie danych o natężeniu ruchu jest wyłączone, gdy typ mapy jest ustawiony na „brak”.

Zmienianie typu mapy

Aby ustawić typ mapy, przypisz nową wartość do właściwości GMSMapView.mapType. Aby na przykład wyświetlić mapę satelitarną:

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

Poniższy selektor pokazuje porównanie mapy ukształtowania terenu, mapy normalnej i mapy hybrydowej dla tej samej lokalizacji:

Mapy obiektów

Przy dużych poziomach powiększenia pakiet Maps SDK na iOS wyświetla plany pięter pomieszczeń, takich jak lotniska, centra handlowe, duże sklepy i stacje transportu publicznego. Plany pięter są zintegrowane z domyślnymi kafelkami mapy typu „normalna” (kGMSTypeNormal) i są automatycznie włączane, gdy użytkownik powiększa mapę, a gdy ją pomniejsza, znikają.

Mapy obiektów możesz wyłączyć, ustawiając właściwość indoorEnabled obiektu GMSMapView na NO.

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

Możesz też wyłączyć tylko selektor piętra.

Dodawanie planów pięter

Plany pięter są dostępne w wybranych lokalizacjach. Jeśli dane planu piętra nie są dostępne dla budynku, który chcesz wyróżnić w aplikacji, możesz:

• Dodaj plany pięter bezpośrednio do Map Google. Dzięki temu Twoje plany będą dostępne dla wszystkich użytkowników Map Google.
• Wyświetlanie planu piętra jako nakładki naziemnej. Dzięki temu tylko użytkownicy Twojej aplikacji będą mogli wyświetlać plany pięter.

Warstwa natężenia ruchu

Możesz umożliwić użytkownikom wyświetlanie mapy z nałożonymi informacjami o natężeniu ruchu. Zapewnia to wizualne podsumowanie lokalnej sytuacji na drogach. Warstwę natężenia ruchu możesz włączać i wyłączać, wywołując metodę trafficEnabled. Poniższy przykład pokazuje, jak warstwa natężenia ruchu może wyglądać na mapie.

Warstwa transportu publicznego

Pakiet Maps SDK na iOS umożliwia wyświetlanie sieci transportu publicznego w mieście na mapie za pomocą metody transitEnabled. Gdy warstwa ruchu jest włączona, a mapa jest wyśrodkowana na mieście, które obsługuje informacje o transporcie publicznym, główne linie transportu publicznego będą wyświetlane jako grube, kolorowe linie. Kolor linii jest ustawiany na podstawie informacji od operatora linii transportu publicznego. Włączenie warstwy transportu publicznego zmieni styl mapy podstawowej, aby lepiej podkreślić trasy transportu publicznego.

Jeśli reprezentujesz instytucję publiczną, która nadzoruje transport publiczny w Twoim mieście, i chcesz, aby Twoje dane zostały uwzględnione, odwiedź witrynę Programu partnerskiego Transportu publicznego Google, aby dowiedzieć się więcej.

Poniższy przykład pokazuje, jak warstwa transportu publicznego może wyglądać na mapie.

Ułatwienia dostępu

Domyślnie elementy ułatwień dostępu na mapie są ukryte. Możesz włączyć ułatwienia dostępu, ustawiając właściwość accessibilityElementsHidden elementu GMSMapView na NO. Spowoduje to wygenerowanie elementów ułatwień dostępu dla obiektów nakładki (takich jak GMSMarker i okna informacyjne, GMSPolyline itp.).

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

Ta właściwość jest zgodna z nieformalnym protokołem UIAccessibility, z tym że domyślna wartość w pakiecie Maps SDK na iOS to YES.

Moja lokalizacja

Domyślnie na mapie nie są wyświetlane żadne dane o lokalizacji. Możesz włączyć niebieski punkt „Moja lokalizacja” i kierunek kompasu, ustawiając myLocationEnabled na GMSMapView.

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

Włączenie tej funkcji umożliwia podanie bieżącej lokalizacji użytkownika za pomocą właściwości myLocation. Ta właściwość może nie być od razu dostępna – na przykład jeśli iOS prosi użytkownika o zezwolenie na dostęp do tych danych. W tym przypadku jest to nil.

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

Budynki 3D

Wiele miast, gdy są wyświetlane z bliska, ma widoczne budynki 3D, jak na obrazie Seattle w stanie Waszyngton poniżej.

Możesz wyłączyć budynki 3D, ustawiając odpowiednią właściwość GMSMapView w języku Swift lub Objective-C, jak pokazano poniżej:

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

Dopełnienie mapy

Mapa Google jest zaprojektowana tak, aby wypełniać cały region określony przez GMSMapView. Wymiary widoku określają kilka aspektów wyglądu i działania mapy:

• Cel kamery odzwierciedla środek wypełnionego regionu.
• Elementy sterujące mapą są rozmieszczone względem jej krawędzi.
• Informacje prawne, takie jak oświadczenia o prawach autorskich czy logo Google, pojawiają się wzdłuż dolnej krawędzi mapy.

Możesz dodać dopełnienie wokół krawędzi mapy za pomocą GMSMapView.Właściwość padding. Mapa nadal wypełnia cały kontener, ale pozycjonowanie tekstu i elementów sterujących, gesty na mapie i ruchy kamery zachowują się tak, jakby mapa została umieszczona w mniejszej przestrzeni. Spowoduje to te zmiany:

• Ruchy kamery wywoływane przez wywołania interfejsu API lub naciśnięcie przycisku (np. kompas, moja lokalizacja) są względne do obszaru z dopełnieniem.
• GMSMapView.projection zwraca projekcję, która obejmuje tylko wypełniony region.
• Elementy sterujące interfejsu są przesunięte od krawędzi kontenera o określoną liczbę punktów.

Dopełnienie może być przydatne podczas projektowania interfejsów, które nakładają się na część mapy. Na przykład na obrazie mapa jest dopełniona wzdłuż górnej i prawej krawędzi. Widoczne elementy sterujące mapy i tekst prawny są wyświetlane wzdłuż krawędzi obszaru dopełnienia (na zielono), a mapa nadal wypełnia cały kontener (na niebiesko). W tym przykładzie możesz umieścić menu po prawej stronie mapy, nie zasłaniając elementów sterujących mapą.

Aby dodać do mapy dopełnienie, utwórz obiekt UIEdgeInsets i przekaż go do metody GMSMapView.padding.

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

Uwaga: zgodnie z Warunkami korzystania z Google Maps Platform aplikacja nie może usuwać ani zasłaniać logo Google ani powiadomień o prawach autorskich. Dopełnienie mapy pozwala w razie potrzeby zmienić położenie tych elementów. Jeśli u dołu mapy wyświetlasz niestandardowy interfejs, dodaj do mapy dopełnienie, aby logo i informacje prawne były widoczne.

Schemat kolorów mapy

W przypadku map typu normalnego i terenowego możesz ustawić ciemny lub jasny schemat kolorów mapy, możesz też użyć bieżących ustawień systemowych. Możesz na przykład przyciemnić lub rozjaśnić schemat kolorów mapy w zależności od pory dnia lub tego, czy urządzenie jest używane w pomieszczeniu czy na zewnątrz.

Użyj GMSMapView overrideUserInterfaceStyle:, aby ustawić i zaktualizować schemat kolorów mapy.

Swift

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;

Aby utworzyć niestandardowe style jasne i ciemne dla map, użyj definiowania stylów map w Google Cloud.