Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Używanie identyfikatorów map

Identyfikator mapy to identyfikator powiązany z określonym stylem lub funkcją mapy. Skonfiguruj styl mapy i powiąż ją z identyfikatorem mapy w Google Cloud Console. Gdy odwołasz się do identyfikatora mapy w kodzie, powiązany z nim styl mapy wyświetli się w aplikacji. Wszystkie kolejne zmiany stylu wprowadzone w aplikacji będą się pojawiać automatycznie w aplikacji bez żadnych aktualizacji klientów.

Po utworzeniu identyfikatory map są powiązane z projektem i ograniczone do jednej platformy (Android, iOS, JavaScript) lub do Maps Static API.

Aby tworzyć identyfikatory map i zarządzać nimi w Cloud Console, musisz mieć rolę właściciela projektu lub edytującego projekt.

Wymagane uprawnienia

Aby tworzyć identyfikatory map i style map w danym projekcie Google Cloud oraz zarządzać nimi, musisz mieć w projekcie rolę właściciela lub edytującego.

Tworzenie identyfikatora mapy

Identyfikator mapy to unikalny identyfikator, który reprezentuje pojedynczą instancję Mapy Google. W każdej chwili możesz utworzyć identyfikatory map i zaktualizować styl powiązany z identyfikatorem mapy w Cloud Console.

Aby utworzyć identyfikator mapy:

  1. W Cloud Console otwórz stronę zarządzania Mapami.
  2. Wybierz Utwórz nowy identyfikator mapy, aby wyświetlić formularz Utwórz nowy identyfikator mapy.
    Utwórz nowy identyfikator mapy

    W formularzu wykonaj te czynności:

    • Określ nazwę mapy.
    • Określ typ mapy lub platformę.
    • W przypadku map JavaScript wybierz typ mapy rastrowej lub wektorowej.
    • Wpisz opis mapy.
    • Kliknij Dalej, aby wyświetlić nowy identyfikator mapy.

Powiąż identyfikator mapy ze stylem mapy

W tych instrukcjach założono, że w Twoim projekcie jest co najmniej 1 istniejący styl mapy.

  1. W Cloud Console otwórz stronę zarządzania Mapami.
  2. Na tej stronie wybierz istniejący identyfikator mapy z kolumny Nazwa mapy.
  3. U dołu tego formularza wybierz styl mapy z menu Style mapy powiązane z tym identyfikatorem mapy.
  4. Kliknij Zapisz.
    Zrzut ekranu przedstawiający stronę szczegółów pojedynczego identyfikatora mapy, w tym pole, które pozwala użytkownikom powiązać styl mapy z tym identyfikatorem mapy.

Dodawanie identyfikatora mapy do aplikacji

Android

Dodaj identyfikator mapy za pomocą elementu <fragment> w pliku układu aktywności, używając klasy MapView lub automatycznie za pomocą klasy GoogleMapOptions.

Załóżmy na przykład, że utworzony przez Ciebie identyfikator mapy jest przechowywany jako wartość ciągu o nazwie map_id w: res/values/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

W przypadku map dodanych za pomocą elementu <fragment> w pliku układu aktywności wszystkie fragmenty map, które powinny mieć styl niestandardowy, muszą określać identyfikator mapy w atrybucie map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

Możesz też użyć atrybutu map:mapId klasy MapView do określenia identyfikatora mapy:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

Aby automatycznie wskazać identyfikator mapy, przekaż go do instancji MapFragment za pomocą klasy GoogleMapOptions:

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

W Android Studio skompiluj i uruchom aplikację w zwykły sposób. Style niestandardowe skonfigurowane w pierwszym kroku zostaną zastosowane na wszystkich mapach zawierających identyfikator.

iOS

Aby utworzyć mapę za pomocą identyfikatora mapy, wykonaj następujące czynności:

  1. Utwórz GMSMapID z ciągiem identyfikatora mapy z Cloud Console.
  2. Utwórz atrybut GMSMapView określający utworzony przed chwilą identyfikator mapy.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

Jeśli używasz własnego identyfikatora mapy, możesz w każdej chwili ustawić nowy identyfikator mapy w Cloud Console, a styl ten zostanie automatycznie wyświetlony w widoku mapy dla Ciebie i użytkowników w ciągu około 6 godzin.

Jeśli chcesz natychmiast zobaczyć zmiany, możesz zamknąć i ponownie uruchomić aplikację, zamykając ją, wymuszając zamknięcie aplikacji z listy ostatnio używanych, a następnie ponownie otwierając aplikację. Zaktualizowana mapa będzie widoczna.

JavaScript

Aby utworzyć mapę z identyfikatorem mapy w kodzie aplikacji:

  1. Jeśli dostosowujesz obecnie mapę przy użyciu umieszczonego kodu JSON, usuń właściwości styles z obiektu MapOptions. W przeciwnym razie pomiń ten krok.

  2. Dodaj identyfikator mapy do mapy za pomocą właściwości mapId. Przykład:

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

Mapy statyczne

Aby dodać identyfikator mapy do nowej lub istniejącej mapy, która używa jednego z naszych interfejsów API usługi internetowej, dołącz parametr adresu URL map_id i ustaw go na identyfikator mapy. Ten przykład pokazuje, jak dodać identyfikator mapy do mapy za pomocą Maps Static API.

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />

Mapa wyśrodkowana na moście Brooklijskim w Nowym Jorku w USA z ustawieniami map w prawym dolnym rogu. Mapa wyświetla własne style na drogach, wodach i lądzie.

Jeśli w statycznym adresie URL w Mapach Google masz podpis cyfrowy, przed dodaniem identyfikatora mapy musisz utworzyć i dodać nowy podpis cyfrowy. Podczas generowania nowego obiektu tajnego podpisywania URL-a musisz usunąć poprzedni podpis cyfrowy z adresu URL.

Funkcje dostępne podczas korzystania z identyfikatorów map

Styl map w chmurze: możesz konfigurować i dostosowywać mapy oraz nimi zarządzać za pomocą Google Cloud Console.
Dostępna na wszystkich platformach (Android, JavaScript, iOS i Map Static API).

Mapy wektorowe: mapa składająca się z płytek wektorowych, które są rysowane podczas wczytywania po stronie klienta za pomocą WebGL.
Dostępne w JavaScript