Использовать идентификаторы карты

Идентификатор карты — это идентификатор, связанный с определенным стилем карты или функцией. Настройте стиль карты и свяжите его с идентификатором карты в Google Cloud Console. Затем, когда вы ссылаетесь на идентификатор карты в своем коде, связанный с ним стиль карты отображается в вашем приложении. Любые последующие обновления стилей, которые вы делаете, появляются в вашем приложении автоматически, без необходимости каких-либо обновлений со стороны ваших клиентов.

При создании идентификаторы карт связываются с проектом, а также ограничиваются одной платформой (Android, iOS, JavaScript) или API статики Карт.

Чтобы создавать идентификаторы карт или управлять ими в Cloud Console, у вас должна быть роль IAM «Владелец проекта» или «Редактор проекта» .

Требуемые разрешения

Чтобы создавать любые идентификаторы карт или стили карт в данном проекте Google Cloud или управлять ими, вы должны иметь роль владельца или редактора IAM в проекте.

Создать идентификатор карты

Идентификатор карты — это уникальный идентификатор, представляющий отдельный экземпляр Карты Google. Вы можете создавать идентификаторы карт и обновлять стиль, связанный с идентификатором карты, в любое время в Cloud Console.

Чтобы создать идентификатор карты:

  1. В Cloud Console перейдите на страницу управления картами .
  2. Выберите «Создать новый идентификатор карты» , чтобы отобразить форму «Создать новый идентификатор карты» .
    Создать новый идентификатор карты

    В форме выполните следующие действия:

    • Укажите имя карты.
    • Укажите тип карты или платформу.
    • Для карт JavaScript выберите растровый или векторный тип карты.
    • Введите описание карты.
    • Выберите «Далее» , чтобы отобразить новый идентификатор карты.

Свяжите идентификатор карты со стилем карты

В этих инструкциях предполагается, что в вашем проекте существует как минимум один стиль карты.

  1. В Cloud Console перейдите на страницу управления картами .
  2. На этой странице выберите идентификатор существующей карты в столбце Имя карты .
  3. В нижней части этой формы выберите стиль карты из стилей карты, связанных с этим раскрывающимся списком ID карты .
  4. Выберите Сохранить .
    Снимок экрана, показывающий страницу сведений для одного идентификатора карты, включая раскрывающееся поле, которое позволяет пользователям связать стиль карты с этим идентификатором карты.

Добавьте идентификатор карты в свое приложение.

Андроид

Добавьте свой идентификатор карты с помощью элемента <fragment> в файле макета действия, используя класс MapView или программно, используя класс GoogleMapOptions .

Например, предположим, что вы создали идентификатор карты, который хранится в виде строкового значения с именем map_id в res/values/strings.xml :

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

Для карт, добавленных с помощью элемента <fragment> в файле макета действия, все фрагменты карты, которые должны иметь пользовательский стиль, должны указывать идентификатор карты в атрибуте map:mapId :

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

Вы также можете использовать атрибут map:mapId класса MapView , чтобы указать идентификатор карты:

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

Чтобы указать идентификатор карты программно, передайте его экземпляру MapFragment с помощью класса GoogleMapOptions :

Джава

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

Котлин

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

В Android Studio создайте и запустите свое приложение, как обычно. Пользовательские стили, настроенные на первом этапе, будут применяться ко всем картам с идентификатором.

iOS

Чтобы создать экземпляр карты с использованием идентификатора карты, выполните следующие действия:

  1. Создайте GMSMapID со строкой идентификатора карты из Cloud Console.
  2. Создайте GMSMapView , указав только что созданный идентификатор карты.

Быстрый

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

Цель-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;

Если вы используете свой собственный идентификатор карты, вы можете в любое время настроить свой идентификатор карты в Cloud Console, чтобы он имел новый стиль, и этот стиль будет автоматически отображаться на вашей карте для вас и пользователей в течение примерно шести часов.

Если вы хотите немедленно увидеть изменения, вы можете закрыть и перезапустить приложение, выйдя из приложения, принудительно выйдя из списка недавно использованных приложений, а затем повторно открыв его. Обновленная карта будет видна.

JavaScript

Чтобы создать карту с идентификатором карты в коде приложения:

  1. Если вы в настоящее время настраиваете свою карту с помощью встроенного кода JSON, удалите свойство styles из вашего объекта MapOptions ; в противном случае пропустите этот шаг.

  2. Добавьте идентификатор карты на карту, используя свойство mapId . Например:

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

Карты статические

Чтобы добавить идентификатор карты к новой или существующей карте, использующей один из наших API-интерфейсов веб-сервиса, добавьте параметр URL-адреса map_id и задайте для него идентификатор вашей карты. В этом примере показано добавление идентификатора карты на карту с помощью 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" />

Карта с центром на Бруклинском мосту в Нью-Йорке, штат Нью-Йорк, США, с элементами управления картой в правом нижнем углу. На карте отображаются пользовательские стили дорог, воды и земли.

Если у вас есть цифровая подпись в статическом URL-адресе Карт до добавления идентификатора карты, вам потребуется создать и добавить новую цифровую подпись после добавления идентификатора карты. При создании нового секрета подписи URL-адреса не забудьте удалить предыдущую цифровую подпись из URL-адреса.

Функции, доступные при использовании идентификаторов карты

Стилизация облачных карт : создавайте, настраивайте и управляйте своими картами с помощью Google Cloud Console.
Доступно на всех платформах (Android, JavaScript, iOS и Maps Static API).

Векторные карты : карта, состоящая из векторных плиток, которые рисуются во время загрузки на стороне клиента с помощью WebGL.
Доступно на JavaScript