Korzystanie z identyfikatorów map
Identyfikator mapy to identyfikator powiązany z określonym stylem lub funkcją mapy. Skonfiguruj styl mapy i powiąż go z identyfikatorem mapy w konsoli Google Cloud. Następnie, gdy odwołujesz się w swoim kodzie do identyfikatora mapy, powiązany z nim styl mapy to wyświetlane w aplikacji. Wszelkie późniejsze zmiany stylu pojawią się w aplikacji automatycznie, bez konieczności aktualizacji przez klientów.
Po utworzeniu identyfikatory map są powiązane z projektem i są również do jednej platformy (Android, iOS, JavaScript) lub do statycznego interfejsu API Map Google.
Aby utworzyć identyfikatory map lub nimi zarządzać w konsoli Cloud: musi zawierać Projekt Rola uprawnień właściciela lub edytującego projekt.
Wymagane uprawnienia
Aby utworzyć identyfikatory lub style mapy w w ramach danego projektu Google Cloud musisz mieć Rola uprawnień właściciela lub edytującego nad projektem.
Utwórz identyfikator mapy
Identyfikator mapy to unikalny identyfikator, który reprezentuje pojedynczą instancję Google Mapa. W każdej chwili możesz utworzyć identyfikatory map i zaktualizować styl powiązany z identyfikatorem mapy czasu w konsoli Cloud.
Aby utworzyć identyfikator mapy:
- W konsoli Cloud otwórz Strona zarządzania mapami.
- Wybierz Create New Map ID (Utwórz nowy identyfikator mapy), aby wyświetlić link Create New Map (Utwórz)
Nowy identyfikator mapy.
W formularzu wykonaj te czynności:
- Podaj nazwę mapy.
- Określ typ mapy lub platformę.
- W przypadku map JavaScript wybierz typ mapy rastrowej lub wektorowej.
- Wpisz opis mapy.
- Wybierz Dalej, aby wyświetlić nowy identyfikator mapy.
Powiązanie identyfikatora mapy ze stylem mapy
W tych instrukcjach przyjęto, że w Twoim projekcie istnieje co najmniej 1 styl mapy.
- W konsoli Cloud otwórz Strona zarządzania mapami.
- Na tej stronie wybierz istniejący identyfikator mapy w kolumnie Nazwa mapy.
- U dołu tego formularza wybierz styl mapy z menu Style mapy powiązane z tym identyfikatorem mapy.
- Kliknij Zapisz.
Dodawanie identyfikatora mapy do aplikacji
Android
Dodaj identyfikator mapy za pomocą elementu <fragment>
w sekcji aktywności
pliku układu, przy użyciu klasy MapView
lub programowo przy użyciu
GoogleMapOptions
zajęcia.
Załóżmy na przykład, że masz utworzony identyfikator mapy, który jest przechowywany jako
wartość ciągu znaków 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 mapy, które powinny mieć styl niestandardowy, muszą zawierać atrybut
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
, aby określić
identyfikator mapy:
<com.google.android.gms.maps.MapView
xmlns:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
Aby automatycznie określić identyfikator mapy, przekaż go do MapFragment
instancji 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ę tak jak zwykle. Style niestandardowe, skonfigurowana w pierwszym kroku zostanie zastosowana do wszystkich map z danym identyfikatorem.
iOS
Aby utworzyć instancję mapy przy użyciu identyfikatora mapy, wykonaj te czynności:
- Utwórz w Cloud Console obiekt
GMSMapID
z ciągiem znaków identyfikatora mapy. - Utwórz
GMSMapView
, podając identyfikator właśnie utworzonej 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 go ustawić w konsoli Cloud, aby w dowolnym momencie mieć nowy styl. ten styl zostanie automatycznie odzwierciedlony w widoku mapy użytkowników w ciągu około 6 godzin.
Jeśli chcesz zobaczyć zmiany od razu, możesz zamknąć przeglądarkę i uruchomić ją ponownie. przez wychodzenie z aplikacji, wymuszenie jej zamknięcia z ostatnio używanego listę aplikacji i ponownie ją otwórz. Zaktualizowana mapa będzie wtedy widoczna.
JavaScript
Aby utworzyć mapę z identyfikatorem mapy w kodzie aplikacji:
Jeśli obecnie dostosowujesz mapę, korzystając z umieszczonego kodu JSON, usuń parametr Usługa
styles
z obiektuMapOptions
; W przeciwnym razie pomiń ten krok.Dodaj do mapy identyfikator 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 do nowej lub istniejącej mapy, która korzysta z
interfejsów API usług internetowych, dołącz parametr adresu URL map_id
i ustaw go na identyfikator mapy.
Ten przykład pokazuje, jak dodać do mapy identyfikator przy użyciu statycznego interfejsu API Map Google.
<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" />
Funkcje dostępne, gdy używasz identyfikatorów map
[cloud-based maps style” (style map w chmurze): style i dostosowywanie map oraz zarządzanie nimi za pomocą konsoli Google Cloud;
Dostępne na wszystkich platformach (Android, JavaScript, iOS i Mapy statyczne)
Mapy wektorowe: mapa złożona z fragmentów wektorowych, które są rysowane w czasie wczytywania
po stronie klienta za pomocą WebGL.
Dostępna w JavaScript