Konfigurowanie mapy

W tym przeglądzie opisujemy, 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ć opcje początkowe i ustawienia czasu działania mapy. 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 pochylenie. Więcej informacji o ustawianiu kamery znajdziesz w sekcji Kamera i widok.
• Kolor tła mapy.
• Typ mapy.
• Komponenty interfejsu do wyświetlenia, takie jak przyciski powiększania i kompas.
• gesty do włączenia;

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

Opcje mapy

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

Konfigurowanie opcji mapy

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

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

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 funkcji GMSMapView.

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

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 może być przydatne zastąpienie domyślnego koloru tła mapy. Możesz to zrobić, ustawiając właściwość opcji mapy backgroundColor.

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

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

Typy map

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

Zmienianie typu mapy

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

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

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;

Wybieracz poniżej pokazuje porównanie mapy terenu, zwykłej i hybrydowej dla tej samej lokalizacji:

Mapy obiektów

Przy dużym powiększeniu pakiet Maps SDK na iOS wyświetla plany pięter w przestrzeniach wewnętrznych, takich jak lotniska, centra handlowe, duże sklepy detaliczne i stacje transportu publicznego. Plany pięter wewnątrz budynków są zintegrowane z domyślnymi fragmentami mapy dla typu „normalna” (kGMSTypeNormal) i są automatycznie włączane, gdy użytkownik powiększa mapę, a zanikają, gdy ją pomniejsza.

Możesz wyłączyć mapy pomieszczeń, ustawiając właściwość indoorEnabled elementu GMSMapView na NO.

mapView.isIndoorEnabled = false
      

mapView.indoorEnabled = NO;
      

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

Dodawanie planów pięter

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

• Dodawaj 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świetl plan piętra jako nakładkę na ziemię. 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 informacjami o natężeniu ruchu. Zawiera wizualne podsumowanie sytuacji związanej z ruchem lokalnym. Warstwę ruchu możesz włączać i wyłączać, wywołując metodę trafficEnabled. Poniższy przykład pokazuje, jak warstwa 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, na mapie będą wyświetlane główne linie transportu publicznego 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 uwidocznić trasy transportu publicznego.

Jeśli jesteś przedstawicielem instytucji publicznej, która nadzoruje transport publiczny w Twoim mieście i chcesz, aby Twoje dane były uwzględniane, odwiedź stronę Programu partnerów Google Transit, 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. Ułatwienia dostępu możesz włączyć, ustawiając właściwość accessibilityElementsHidden elementu GMSMapView na NO. Powoduje to generowanie elementów ułatwień dostępu dla obiektów nakładki (takich jak GMSMarker i okna informacyjne, GMSPolyline itp.).

mapView.accessibilityElementsHidden = false
      

mapView.accessibilityElementsHidden = NO;
      

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

Moja lokalizacja

Domyślnie na mapie nie są wyświetlane żadne dane o lokalizacji. Niebieską kropkę „Moja lokalizacja” i kierunek kompasu możesz włączyć, ustawiając myLocationEnabled naGMSMapView.

mapView.isMyLocationEnabled = true
      

mapView.myLocationEnabled = YES;
      

Włączenie tej funkcji udostępnia bieżącą lokalizację użytkownika za pomocą właściwości myLocation. Ta właściwość może nie być od razu dostępna, np. jeśli iOS wyświetli użytkownikowi prośbę o zezwolenie na dostęp do tych danych. W tym przypadku jest tonil.

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

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

Budynki 3D

W wielu miastach, gdy przybliżysz widok, zobaczysz budynki 3D, jak na obrazie Seattle w stanie Waszyngton poniżej.

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

mapView.isBuildingsEnabled = false
      

[mapView setBuildingsEnabled:NO];
      

Dopełnienie mapy

Mapa Google jest zaprojektowana tak, aby wypełniać cały region określony przez element GMSMapView. Na wygląd i działanie mapy wpływa kilka aspektów związanych z wymiarami widoku:

• Cel kamery odzwierciedla środek wyściełanego obszaru.
• Elementy sterujące mapą są umieszczone 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ć marginesy wokół krawędzi mapy za pomocą ikony GMSMapView.padding usługi. Mapa nadal wypełnia cały kontener, ale pozycjonowanie tekstu i elementów sterujących, gesty na mapie oraz ruchy kamery zachowują się tak, jakby mapa była umieszczona w mniejszej przestrzeni. W ten sposób wprowadzamy te zmiany:

• Ruchy kamery za pomocą wywołań interfejsu API lub naciśnięć przycisków (np. kompas, moja lokalizacja) są względne w stosunku do obszaru z marginesami.
• GMSMapView.projection zwraca projekcję, która zawiera tylko obszar z wypełnieniem.
• Elementy interfejsu są odsunięte od krawędzi kontenera o określoną liczbę punktów.

Wypełnienie może być przydatne podczas projektowania interfejsów, które częściowo nakładają się na mapę. Na przykład na obrazie mapa ma marginesy u góry i po prawej stronie. Widoczne elementy sterujące mapą i tekst prawny są wyświetlane wzdłuż krawędzi obszaru z marginesami (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 funkcji GMSMapView.padding usługi.

// 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
      

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

Schemat kolorów mapy

W przypadku map typu normalnego i terenu 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.

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

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 tworzyć niestandardowe jasne i ciemne style map, używaj definiowania stylów map w Google Cloud.