Identyfikator mapy to niepowtarzalny identyfikator, który reprezentuje pojedynczą instancję Mapy Google. Identyfikatorów map używasz do włączania funkcji oraz do zarządzania mapami i ich stylami w swoich witrynach i aplikacjach. Identyfikatory map możesz tworzyć dla każdej platformy, której potrzebujesz (JavaScript, Android, iOS lub mapy statyczne) w projekcie w Google Cloud Console na stronie Zarządzanie mapami.
Więcej informacji o identyfikatorach map oraz funkcjach, które z nich korzystają, znajdziesz w artykule Identyfikator mapy – informacje ogólne.
Wymagane uprawnienia
Aby tworzyć identyfikatory map w projekcie lub nimi zarządzać, musisz użyć podmiotu zabezpieczeń z odpowiednimi uprawnieniami na poziomie roli, czyli Edytujący lub Właściciel, na stronie Uprawnienia w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Informacje o rolach podstawowych i wstępnie zdefiniowanych w uprawnieniach IAM.
Tworzenie identyfikatorów map
Aby utworzyć identyfikatory map w konsoli Cloud, wykonaj te czynności:
Zaloguj się i otwórz projekt w konsoli Cloud z wymaganymi uprawnieniami.
W konsoli Google Cloud otwórz stronę Zarządzanie Mapami.
Kliknij Utwórz identyfikator mapy.
Na stronie Utwórz nowy identyfikator mapy wykonaj te czynności:
- W polu Name (Nazwa) wpisz nazwę identyfikatora mapy.
- Opcjonalnie: w polu Opis opisz, do czego służy identyfikator mapy.
- W sekcji Typ mapy wybierz platformę, na której chcesz używać identyfikatora mapy. Jeśli wybierzesz JavaScript, wybierz też typ mapy: Raster (domyślny) lub Wektor. Więcej informacji o mapach wektorowych znajdziesz w artykule Mapy wektorowe.
- Kliknij Zapisz, aby wyświetlić nowy identyfikator mapy.
Powiązanie identyfikatora mapy ze stylem mapy
Jeśli używasz stylizacji map w chmurze, powiążesz styl mapy z identyfikatorem mapy. Więcej informacji znajdziesz w artykule Powiązanie.
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 programowo za pomocą klasy GoogleMapOptions.
Załóżmy na przykład, że utworzyłeś identyfikator mapy, który jest przechowywany jako wartość ciągu znaków o nazwie map_id w elementach res/values/strings.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>
W przypadku map dodanych za pomocą elementu <fragment> w pliku układu aktywności wszystkie fragmenty mapy, które mają mieć styl niestandardowy, muszą mieć określony identyfikator mapy w atrybucie map:mapId:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
map:name="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
Aby określić identyfikator mapy, możesz też użyć atrybutu map:mapId klasy MapView:
<com.google.android.gms.maps.MapView
xmlns:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
Aby określić identyfikator mapy w sposób programowy, prześlij 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 utwórz i uruchom aplikację jak zwykle. Niestandardowe style skonfigurowane w pierwszym kroku są stosowane do wszystkich map z wybranym identyfikatorem mapy.
iOS
Aby utworzyć instancję mapy za pomocą identyfikatora mapy, wykonaj te czynności:
- Utwórz
GMSMapIDza pomocą ciągu znaków identyfikatora mapy z konsoli Cloud. - Utwórz
GMSMapView, podając utworzony właśnie identyfikator mapy.
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "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:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
Jeśli używasz własnego identyfikatora mapy, możesz go ustawić w konsoli Cloud, aby w dowolnym momencie uzyskać nowy styl. Styl zostanie automatycznie uwzględniony w widoku mapy w ciągu około 6 godzin.
Jeśli chcesz zobaczyć zmiany od razu, możesz zamknąć i ponownie uruchomić aplikację, wychodząc z niej, wymuszając jej zamknięcie z listy ostatnio używanych aplikacji, a następnie otwierając ją ponownie. Zaktualizowana mapa będzie wtedy widoczna.
JavaScript
Aby utworzyć mapę z identyfikatorem mapy w kodzie aplikacji:
Jeśli mapę dostosowujesz już za pomocą wbudowanego kodu JSON, usuń właściwość
stylesz obiektuMapOptions. W przeciwnym razie pomiń ten krok.Dodaj identyfikator mapy do mapy za pomocą właściwości
mapId. Na 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 korzysta z jednego z naszych interfejsów API usług internetowych, dodaj parametr map_id URL i ustaw go jako identyfikator mapy. Ten przykład pokazuje dodawanie identyfikatora mapy do mapy za pomocą Map 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=MAP_ID&signature=YOUR_SIGNATURE" />