Working with the Platform Manager
Differences between On-Cloud and On-Premise versions
The Platform Manager is available both On-Cloud and On-Premise. The available features differ depending on the installation.
| On-Cloud | On-Premise | |
|---|---|---|
| Viewing licenses | ✗ | ✓ |
| Creating access keys | ✓ | ✓ |
| Managing access keys | ✓ | ✓ |
| Managing users | ✓ (See the Managing users) instruction | ✓ Only changing user roles: see the Managing user roles section. |
| Managing companies | ✓ (See the Managing companies) instruction | ✗ |
| Uploading custom map styles | ✗ (You can specify the style in map settings) | ✓ |
| Testing services in the playground | ✓ | ✓ |
| Viewing statistics on access keys | ✓ | ✓ |
| Monitoring services | ✗ | ✓ |
Getting started
- Make sure the Platform Manager service is installed and works properly. For details, see the Installing the Platform Manager instruction.
- Follow a URL in the
https://platform.example.comformat that you received after installing the service.
Platform Manager interface
Work with the following tabs in the Platform Manager:
- Licenses: to view information about licenses installed within the On-Premise suite.
- API Keys: to view the list of API keys and manage services included in them.
- Map Styles: to upload and manage custom map styles.
- Playgrounds: to test the operation of key APIs.
- Statistics: to view statistics on access keys and download it as a file.
- Status Page: to view the statuses of services installed within the On-Premise software suite.
Viewing licenses
On the Licenses tab, you can view information about licenses installed within the On-Premise suite.
For each license, the following information is displayed:
- service the license is issued for
- license ID
- validity period
- status:
Active,Expiring soon(appears 10 days before expiration), andExpired
To view the JSON file with additional license parameters, click icon next to the license.
Managing API keys
Users with the Administrator role can manage API keys.
Creating a key
To create a new API key:
- Go to the API Keys tab.
- Click Create API Key.
- Enter a key name and click Create.
After creating the key, you can configure services and JSON parameters for it, view its usage statistics, and block it.
Configuring services in a key
To configure services in an API key:
- On the API Keys tab, click the key name to open the list of services it includes.
- Enable or disable a service in the list.
Configuring service limits in a key
To configure service limits in an API key:
-
On the API Keys tab, click the key name to open the list of services it includes.
-
On the Services tab, in the row of the service, click
icon.
-
Specify the limit values for the service:
-
Limit Periods: the time period for which the limits are counted: minute, day, or month.
-
Limit reached: the event that occurs after the limit is used up: notification, throttle, or block.
noteEmail notifications (the Notification option) are not available On-Premise.
-
Limit: the limit for the service in the selected period. When this limit is reached within the specified period, the event selected in the Limit reached parameter occurs.
-
-
(Optional) Click Add Limitation to set additional limits for the service.
-
Click Save.
Configuring restrictions in a key
-
Go to the API Keys tab and select the key.
-
In the Restrictions section, configure the key restrictions:
- By HTTP headers: access restriction by header values.
- By IP and subnets: access restriction by IP addresses.
- By application: access restriction by mobile application ID.
-
Click Save.
By HTTP headers
Restricts access based on HTTP headers in the request:
Referer: by page URL.Origin: by server name.User-Agent: by application type, operating system, and other parameters.
For example, to allow access only for requests from the domain example.com and from a browser with User-Agent Mozilla/5.0 setting:
- In the Origin field, enter
example.com. - In the User-Agent field, enter
Mozilla/5.0. - Click Save.
The key will work only for requests with the headers Origin: example.com and User-Agent: Mozilla/5.0. Requests from other domains (e.g., test.com) or other clients (e.g., curl/7.0) are rejected.
By IP and subnets
Restricts access based on a list of IP addresses or subnets in CIDR format (e.g., 192.168.1.0/24). The restriction uses the client IP address extracted from the following headers:
Remote-Addr: IP address of the TCP connection source or the proxy server IP address when using a proxy or NAT.X-Forwarded-For: chain of IP addresses, where the first address is the client IP. It is recommended to use this header, as it supports complex network configurations with proxy.X-Real-IP: client IP address passed by the proxy.
For example, to allow access only for requests from the corporate subnet 192.168.1.0/24:
-
In the CIDR field, enter the subnet
192.168.1.0/24. -
Click Save.
-
If you use a proxy or NAT, headers may be missing or contain incorrect client IP addresses, which can disrupt the restriction. Make sure that your infrastructure (proxy, load balancers, NAT, Ingress) passes headers with the original client IP address:
- Check the configuration of the nginx Ingress controller in your Kubernetes cluster (e.g., the
values.yamlfile in the Helm chart). - Check the configuration of the proxy or the load balancer (e.g., the
proxy_set_headerdirective in nginx). - Enable logging of HTTP headers (
Remote-Addr,X-Forwarded-For,X-Real-IP) in the API Keys service. - Use traffic analysis tools to confirm that at least one header contains the correct client IP address (e.g., Wireshark, tcpdump).
- Check the configuration of the nginx Ingress controller in your Kubernetes cluster (e.g., the
The key will work only for requests from IP addresses in the range 192.168.1.0 — 192.168.1.255, provided that one of the headers (Remote-Addr, X-Forwarded-For, X-Real-IP) correctly passes the client IP address. Requests from other IP addresses (e.g., 10.0.0.1) or without valid headers are rejected.
By application
Restricts access based on the mobile application identifier (appId).
For example, to allow access only for requests from the application with the com.dgis.sdk.app identifier:
- In the App ID field, enter
com.dgis.sdk.app. - Click Save.
The key will work only for requests from the application with the identifier com.dgis.sdk.app. Requests from other applications (e.g., com.dgis.test.app) will be rejected.
Configuring JSON parameters for services in a key
You can configure additional JSON parameters for services enabled in an API key. Below are popular usage scenarios for this setting.
Configuring the matrix size for Distance Matrix API
To change the maximum number of starting and ending points a partner can pass in a single Distance Matrix API request:
-
On the API Keys tab, click the key name to open the list of services it includes.
-
In the row of the Distance Matrix API service, click
icon.
A text field with the current JSON service parameters for this key appears. If no parameters were set previously, the field is empty.
-
Switch to the Partner tab and specify
max_sourcesandmax_targetsvalues in the text field, for example:{"max_sources": 10,"max_targets": 10}Where:
max_sources- maximum number of starting points per request.max_targets- maximum number of ending points per request.
-
Click Save.
You cannot set the matrix size separately for synchronous and asynchronous requests as the restriction is common for both types of requests within the same key. To set different limits for synchronous and asynchronous requests, use two different API keys with different max_sources and max_targets values.
Configuring available fields for Places API
You can allow a partner to receive additional fields with information about a place (for example, floor data) through Places API, or grant access to individual permissions, such as displaying emails for all branches. To do this:
-
On the API Keys tab, click the key name to open the list of services it includes.
-
In the row of the Places API service, click
icon.
A text field with the current JSON service parameters for this key appears. If no parameters were set previously, the field is empty.
-
Switch to the Partner tab and specify available
fieldsandpermissionsin the text field, for example:{"fields": ["items.floors","items.floor_plans"],"permissions": ["allow_emails_for_all_branches"]}Available values
-
fieldsvalues:-
Fields with place geometry and address information:
items.point- coordinates of an object in the WGS84(4326) coordinate system inlon, latformat.items.address- address of an object without specifying the city.items.adm_div- administrative division.items.full_address_name- address of an object including the city.items.geometry.centroid- visual center of the object geometry.items.geometry.hover- geometry of the area used to determine whether the cursor is within the object's zone.items.geometry.selection- geometry used for object highlighting.
-
Fields with additional information about a place:
items.rubrics- company categories.items.org- organization the branch belongs to.items.brand- brand the branch belongs to.items.schedule- company operating hours.items.schedule_special- special company operating hours.items.access- parking access type.items.capacity- parking capacity.items.description- geo object description.items.flags- list of object flags. For example, that there are photos of the object, or that the branch is temporarily closed, etc. You can view the full list of available flags in the response schema insideitems.items.floors- number of floors.items.floor_plans- floor plans.items.is_paid- whether the parking is paid.items.for_trucks- parking for trucks.items.is_incentive- whether the parking is park-and-ride.items.purpose- parking purpose.items.level_count- number of parking levels.items.links- related objects (nearest parking lots, public transport stops, etc.).items.links.database_entrances- entrance point information.items.links.database_entrances.apartments_info- apartment information in the building.items.name_ex- components of the object name.
-
System fields:
items.geometry.style- style ID for rendering.items.group- objects grouped into a combined card.items.is_main_in_group- indicates whether the object is the main one in a hybrid object group.items.city_alias- city alias where the object is located.items.detailed_subtype- detailed type of an administrative-territorial unit.items.alias- transliterated object name.items.caption- object name.items.routes- transport routes passing through the station or stop.items.directions- route directions.items.is_routing_available- indicates whether the object is reachable by vehicle.items.entrance_display_name- entrance number at a metro station if the object is an entrance (station_entrance).items.locale- current locale for the region.items.region_id- unique project ID.items.segment_id- unique segment ID.items.has_apartments_info- indicates whether there is apartment information available in the building.items.station_id- unique ID of the stop the platform belongs to.items.platforms- stop platforms of a stop.items.search_attributes- search result parameters for the found object. Each field insideitems.search_attributesmust be requested separately using dot notation, for example,items.search_attributes.segment_id. You can view the full list of available fields insideitems.search_attributesin the response schema for any object insideitems.items.poi_category- POI category.items.temporary_unavailable_atm_services- indicates whether there are unavailable services at the ATM or terminal.items.floor_id- floor ID.items.purpose_code- building purpose code.items.name_back- localized name of a road sign in the reverse direction (if available).items.value_back- kilometer marker on a road sign in the reverse direction.items.ev_charging_station- EV charging station attributes.items.ski_lift- ski lift information.items.summary- summary information block.items.settlements_group_name- settlement name.items.sport_route_type_name- sports route type.items.ski_track- ski track information.
-
-
permissionsvalues:allow_emails_for_all_branches- permission to view email in the contact list for all branches.government_address_classifiers- permission to view the codes of the state classifiers: Federal Information Address System, National Classifier of Administrative Territorial Entities, and National Classification of Territories of Municipal Formations.
-
-
Click Save.
Blocking a key
A blocked key cannot be reactivated.
When you block a key, the partner cannot use it to access services. The key status changes to Inactive.
-
Go to the API Keys tab.
-
Block the key in one of the following ways:
- In the row of the key, click
→ Block.
- Click the key name, and in the opened window, click Actions → Block.
- In the row of the key, click
Managing user roles
Users with the Administrator role can change the roles of other users.
- Go to the Users tab.
- In the row of the user whose role you want to change, click
→ Change role.
- In the window that appears, select a new role for the user and click Submit.
Email notifications are not available On-Premise.
Managing map styles
On the Map Styles tab, you can:
- Upload custom map styles to use in a private environment.
- Update map styles and switch between them. You can use new styles or upload updated versions of the same style.
- View the list of uploaded styles along with their details: style ID, version, and the map type they are created for.
- Delete uploaded styles.
Uploading and applying a map style
To create a unique map style and use it in your environment:
-
Make sure that the Styles API is installed.
-
Open the Style editor and create a map style.
See instructions on creating and configuring styles in the Style editor documentation.
-
Export the created style from the Style editor:
-
In the Style editor, open the style card in the My styles block.
-
In the top menu, click Share. In the opened dialog, click Export the style.
-
Select the style in the list and click Export.
A new panel appears, preparing the archive for download.
-
When the style is in the Done status, select it from the list and click Download the style.
-
Save the generated
.tar.gzarchive locally.
-
-
Upload the style to the On-Premise environment:
- Open the Platform Manager.
- Go to the Map Styles tab and click Upload Style.
- Add the exported
.tar.gzarchive and wait until it is uploaded (the archive status must be Uploaded).
-
To check how the uploaded style looks in the playground, on the Map Styles tab, click the style name.
-
Copy the generated style ID from the Map Style ID field and apply it to the map using the MapGL JS API.
You can upload different versions of one style and switch between them in the Platform Manager: for more details, see the Updating a map style section.
Updating a map style
You can apply a new style to the map or update a previously created one.
-
Open the Style editor and create a new style or edit an existing one.
See instructions on creating and configuring styles in the Style editor documentation.
-
Follow the steps to export the style from the Style editor and upload it to the Platform Manager.
-
If you upload an updated version of the existing style, its ID does not change. The Platform Manager detects the update as a new version of the style. You can switch between versions of one style.
-
If you upload a new style, copy the generated style ID from the Map Style ID field and apply it to the map using the MapGL JS API.
Deleting a map style
Before deleting a style, make sure it is not applied to any active map. Otherwise, the map may display incorrectly when the style is removed.
- Go to the Map Styles tab.
- Click
icon next to the required style.
Working with playgrounds
On the Playgrounds tab, you can test the operation of key APIs without installing them:
- Map Tiles API: 3D interactive map based on the WebGL engine with MapGL JS.
- Static API: static maps without using JavaScript.
- Geocoder API: search API for determining the coordinates of an object by address (direct geocoding) and vice versa (reverse geocoding).
- Directions API: navigation API for building car, bicycle, and pedestrian routes.
Example of working in the Map Tiles API playground:
Viewing statistics
On the Statistics tab, you can view detailed data on the number of requests. You can filter the data by time period, service, and API key.
Example of statistics display:
The graph displays the number of requests to services over the year grouped by months.
Request distribution statistics
To view the statistics of request distribution:
-
Go to the Statistics tab.
-
Select the period for which you need to get the statistics (today, the last week, month, or year) or specify a custom period of time in the Period field. Date and time are specified in UTC format. When selecting a monthly or yearly period, you can choose how the data will be displayed in the Group by field: by days, weeks, or months.
-
In the Key field, select the access keys for which you need to get the statistics. To select all keys, select Select all.
To filter keys by status and usage mode, click
icon, select the key status (
Active,Inactive) and mode (Demofor a demo key andProdfor the main key). -
In the Service field, select the services for which you need to get the statistics. To select all services, select Select all.
Downloading a file with the statistics
You can download the statistics as a file with a table in .xlsx format. The table contains the fields:
- Key: key ID.
- Date: request date.
- Service: service to which a request is sent.
- Mode: key usage mode (
demofor a demo key orprodfor a main key). - Method: endpoint to which a request is sent.
- Result: request result (
Success,Empty response, orError). - Result code: code of a request result.
- Requests amount: number of requests during a day specified on a date.
- Organizations: number of organizations that are received via the Places API, the Suggest API, and the Markers API.
- Geoobjects: number of geoobjects that are received via the Search APIs.
- Routes: number of routes that are built via the Navigation APIs, excluding the Isochrone API.
To download a file containing the statistics of request distribution:
- Go to the Statistics tab.
- Select a period, keys, and service.
- Click Download in XLSX.
Monitoring services status
On the Status Page tab, you can view the list of services installed within the On-Premise suite and check their status.
