Использовать идентификаторы карт
Идентификатор карты – это идентификатор, связанный с определенным стилем карты или объектом. Настройте стиль карты и свяжите его с идентификатором карты в Google Cloud Console. Затем, когда вы ссылаетесь на идентификатор карты в своем коде, соответствующий стиль карты отображается в вашем приложении. Любые последующие обновления стиля, которые вы делаете, автоматически появляются в вашем приложении, без необходимости каких-либо обновлений со стороны ваших клиентов.
При создании идентификаторы карт связываются с проектом, а также ограничиваются одной платформой (Android, iOS, JavaScript) или Maps Static API.
Чтобы создавать любые идентификаторы карт в облачной консоли или управлять ими, вам необходима роль IAM владельца проекта или редактора проекта .
Требуемые разрешения
Чтобы создавать любые идентификаторы карт или стили карт в конкретном проекте Google Cloud или управлять ими, вы должны иметь роль IAM владельца или редактора в проекте.
Создать идентификатор карты
Идентификатор карты – это уникальный идентификатор, который представляет отдельный экземпляр карты Google. Вы можете создавать идентификаторы карт и обновлять стиль, связанный с идентификатором карты, в любое время в Cloud Console.
Чтобы создать идентификатор карты:
- В Cloud Console перейдите на страницу «Управление картами» .
- Выберите «Создать новый идентификатор карты» , чтобы отобразить форму «Создать новый идентификатор карты» .
В форме выполните следующие действия:
- Укажите имя карты.
- Укажите тип карты или платформу.
- Для карт JavaScript выберите растровый или векторный тип карты.
- Введите описание карты.
- Выберите «Далее» , чтобы отобразить новый идентификатор карты.
Свяжите идентификатор карты со стилем карты
В этих инструкциях предполагается, что в вашем проекте существует хотя бы один стиль карты.
- В Cloud Console перейдите на страницу «Управление картами» .
- На этой странице выберите существующий идентификатор карты в столбце «Название карты» .
- В нижней части этой формы выберите стиль карты из раскрывающегося списка «Стили карты», связанного с этим идентификатором карты .
- Выберите Сохранить .
Добавьте идентификатор карты в свое приложение
Андроид
Добавьте идентификатор карты через элемент <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
Чтобы создать экземпляр карты с использованием идентификатора карты, выполните следующие действия:
- Создайте
GMSMapID
со строкой идентификатора карты из Cloud Console. - Создайте
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
Чтобы создать карту с идентификатором карты в коде вашего приложения:
Если вы в настоящее время настраиваете свою карту с помощью встроенного кода JSON, удалите свойство
styles
из объектаMapOptions
; в противном случае пропустите этот шаг.Добавьте идентификатор карты на карту, используя свойство
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" />
Функции, доступные при использовании идентификаторов карт
Стилизация облачных карт . Создавайте, настраивайте и управляйте своими картами с помощью Google Cloud Console.
Доступно на всех платформах (Android, JavaScript, iOS и Maps Static API).
Векторные карты : карта, состоящая из векторных фрагментов, которые рисуются во время загрузки на стороне клиента с помощью WebGL.
Доступно на JavaScript