Идентификатор карты — это уникальный идентификатор, представляющий настройки стиля и конфигурации Google Карт, хранящиеся в Google Cloud. Идентификаторы карт используются для включения функций, управления и стилизации карт на ваших веб-сайтах и в приложениях. Вы можете создать идентификаторы карт для каждой необходимой платформы — JavaScript, Android, iOS или статических карт — в вашем проекте консоли Google Cloud на странице «Управление картами» .
Для создания или управления любыми идентификаторами карт в вашем проекте необходимо использовать субъекта с соответствующими правами уровня роли (редактор или владелец) на странице IAM проекта в Cloud Console. Подробнее см. в справочнике по базовым и предопределенным ролям IAM .
Создать идентификаторы карт
Создайте идентификаторы карт в облачной консоли, выполнив следующие действия:
На странице «Создать новый идентификатор карты» выполните следующие действия:
В поле Имя укажите имя идентификатора карты.
Необязательно : в поле «Описание» опишите, для чего используется идентификатор карты.
В поле «Тип карты » выберите платформу, на которой вы планируете использовать идентификатор карты. Если вы выбрали JavaScript, также выберите тип карты: растровый (по умолчанию) или векторный . Подробнее о векторных картах см. в разделе Векторные карты .
Нажмите «Сохранить» , чтобы отобразить новый идентификатор карты.
Добавьте идентификатор своей карты через элемент <fragment> в файле макета активности, используя класс MapView или программно с помощью класса GoogleMapOptions .
Например, предположим, что вы создали идентификатор карты, который хранится как строковое значение с именем map_id в res/values/strings.xml :
Для карт, добавленных через элемент <fragment> в файле макета активности, все фрагменты карты, которые должны иметь пользовательский стиль, должны указывать идентификатор карты в атрибуте map:mapId :
В Android Studio соберите и запустите приложение как обычно. Пользовательские стили, настроенные на первом этапе, применяются ко всем картам с указанным идентификатором.
iOS
Чтобы создать карту с использованием идентификатора карты, выполните следующие действия:
Создайте GMSMapID со строкой идентификатора карты из облачной консоли.
Создайте GMSMapView , указав идентификатор только что созданной карты.
Если вы используете собственный идентификатор карты, вы можете в любой момент задать для него новый стиль в консоли Cloud, и этот стиль автоматически отобразится на вашей карте для вас и пользователей в течение примерно шести часов.
Если вы хотите увидеть изменения немедленно, вы можете закрыть и перезапустить приложение, выйдя из него, принудительно завершив его из списка недавно использованных приложений, а затем снова открыв его. После этого обновлённая карта станет видна.
JavaScript
Чтобы создать карту с идентификатором карты в коде приложения:
Если вы уже настраиваете свою карту с помощью встроенного JSON-кода, удалите свойство styles из объекта MapOptions ; в противном случае пропустите этот шаг.
Добавьте идентификатор карты с помощью свойства mapId . Например:
Чтобы добавить идентификатор карты к новой или существующей карте, использующей один из наших API веб-сервисов, добавьте параметр URL map_id и укажите в нём идентификатор вашей карты. В этом примере показано добавление идентификатора карты к карте с помощью Maps Static API.
Если до добавления идентификатора карты в вашем статическом URL-адресе Maps была цифровая подпись, вам потребуется создать и добавить новую цифровую подпись после добавления идентификатора карты. При создании нового секрета для подписи URL-адреса не забудьте удалить предыдущую цифровую подпись из URL-адреса.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eA map ID is a unique identifier that represents Google Map styling and configuration settings stored in Google Cloud, and is used to enable features or manage styles on websites and applications.\u003c/p\u003e\n"],["\u003cp\u003eCreating a map ID is done in the Google Cloud console under the "Maps Management" page, where you assign a name, optional description, and choose a map type (platform).\u003c/p\u003e\n"],["\u003cp\u003eTo use map IDs you need editor or owner permissions, the map load triggered by using one of them will be charged against the Dynamic Maps SKU for Android and iOS.\u003c/p\u003e\n"],["\u003cp\u003eOnce created, a map ID can be associated with a map style for cloud-based styling and added to apps via code, which will update map styles within about six hours of any change being applied on the cloud console.\u003c/p\u003e\n"],["\u003cp\u003eMap IDs can be applied across multiple platforms including Android, iOS, JavaScript, and Static Maps.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/android-sdk/map-ids/get-map-id \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/map-ids/get-map-id \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/map-ids/get-map-id \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/map-ids/get-map-id \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\n| **Paid feature:**\n| Features accessed by adding a [map ID](/maps/documentation/get-map-id) triggers a map\n| load charged against the Dynamic Maps SKU for Android and iOS. See\n| [Google Maps Billing](/maps/billing-and-pricing/sku-details#dynamic-maps-ess-sku) for more information.\n\nA map ID is a unique identifier that represents Google Map styling and configuration settings that are stored in Google Cloud. You use map IDs to enable features or manage or style maps on your websites and in your applications. You can create map IDs for each platform you need--JavaScript, Android, iOS, or Static maps--in your Google Cloud console project on the **Map Management** page.\n\nFor more details and features that use map IDs,\nsee [Map ID overview](/maps/documentation/maps-static/map-ids/mapid-over).\n\nRequired permissions\n\nTo create or manage any map IDs in your project, you\nmust use a principal with the appropriate role-level permissions, Editor or\nOwner, on the Cloud console IAM page for the project. For\ndetails, see\n[IAM basic and predefined roles reference](https://cloud.google.com/iam/docs/understanding-roles#role_types).\n\nCreate map IDs\n\nCreate map IDs in the Cloud console following\nthese steps:\n\n1. Sign in to and open a Cloud console project with the\n [required permissions](#permissions).\n\n2. In the Cloud console, go to the\n [Maps Management page](https://console.cloud.google.com/google/maps-apis/studio/maps).\n\n3. Click **Create map ID**.\n\n4. On the **Create new map ID** page, do the following:\n\n 1. For **Name**, give the map ID a name.\n 2. *Optional* : For **Description**, describe what the map ID is used for.\n 3. For **Map type** , select the platform on which you plan to use the map ID. If you choose JavaScript, also choose a **Raster** (the default) or **Vector** map type. For more information on vector maps, see [Vector Maps](/maps/documentation/javascript/vector-map).\n 4. Click **Save** to show your new map ID.\n\nAssociate a map ID to a map style\n\nIf you are using cloud-based maps styling, you associate a map style with your\nmap ID. For details, see [Associate your style to a map ID](../cloud-customization/map-styles-leg#associate-style-with-map-id).\n\nAdd the map ID to your app \n\nAndroid\n\nAdd your map ID through a `\u003cfragment\u003e` element in the\nactivity's layout file, by using the `MapView` class, or programmatically\nusing the `GoogleMapOptions` class.\n\nFor example, assume you created a map ID that is stored as a\nstring value named `map_id` in `res/values/strings.xml`: \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cresources\u003e\n \u003cstring name=\"map_id\"\u003e\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\u003c/string\u003e\n \u003c/resources\u003e\n\nFor maps added through a `\u003cfragment\u003e` element in the activity's layout file,\nall map fragments that should have the custom style must specify the\nmap ID in the `map:mapId` attribute: \n\n \u003cfragment xmlns:map=\"http://schemas.android.com/apk/res-auto\"\n map:name=\"com.google.android.gms.maps.SupportMapFragment\"\n ...\n map:mapId=\"@string/map_id\" /\u003e\n\nYou can also use the `map:mapId` attribute of the `MapView` class to specify\na map ID: \n\n \u003ccom.google.android.gms.maps.MapView\n xmlns:map=\"http://schemas.android.com/apk/res-auto\"\n ....\n map:mapId=\"@string/map_id\" /\u003e\n\nTo specify a map ID programmatically, pass it to a\n`MapFragment` instance using the `GoogleMapOptions` class: \n\nJava \n\n MapFragment mapFragment = MapFragment.newInstance(\n new GoogleMapOptions()\n .mapId(getResources().getString(R.string.map_id)));\n\nKotlin \n\n val mapFragment = MapFragment.newInstance(\n GoogleMapOptions()\n .mapId(resources.getString(R.string.map_id))\n )\n\nIn Android Studio, build and run your app as you normally would. Custom\nstyles configured in the first step are applied to all maps with\nthe specified map ID.\n\niOS\n\nTo instantiate a map using a map ID, do the following:\n\n1. Create a `GMSMapID` with the map ID string from Cloud console.\n2. Create a `GMSMapView` specifying the map ID you just created.\n\nSwift \n\n let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)\n let mapID = GMSMapID(identifier: \"\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\")\n let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)\n self.view = mapView\n\nObjective-C \n\n GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169\n longitude:-122.336471\n zoom:12];\n GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@\"\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\"];\n GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];\n self.view = mapView;\n\nIf you are using your own map ID, you can set your\nmap ID in the Cloud console to have a new style\nat any time, and that style will be reflected on your map view automatically\nfor you and users within about six hours.\n\nIf you want to see the changes immediately, you can close out and restart\nyour app by exiting the app, forcing a quit of the app from the recently-used\napps list, and then reopening it. The updated map will then be visible.\n\nJavaScript\n\nTo create a map with a map ID in your application code:\n\n1. If you are already customizing your map with embedded JSON code, remove\n the\n [`styles` property](/maps/documentation/javascript/reference/map#MapOptions.styles)\n from your `MapOptions` object; otherwise, skip this step.\n\n2. Add a map ID to the map using the `mapId` property. For example:\n\n```javascript\nmap = new google.maps.Map(document.getElementById('map'), {\ncenter: {lat: -34.397, lng: 150.644},\nzoom: 8,\nmapId: '\u003cvar translate=\"no\"\u003eMAP_ID\u003c/var\u003e'\n});\n```\n\nMaps Static\n\nTo add a map ID to a new or existing map that uses one of our\nweb-service APIs, append the `map_id` URL parameter and set it to your\nmap ID. This example shows adding a map ID to\na map using Maps Static API. \n\n \u003cimg 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=\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e&signature=YOUR_SIGNATURE\" /\u003e\n\nIf you have a digital signature in your Maps Static URL before adding your map ID, you will need to [create\nand add a new digital signature](/maps/documentation/maps-static/digital-signature) after adding your map ID. When generating your new URL signing secret, remember to remove your previous digital signature from the URL."]]
