Atlas For Google Maps 1.0
Applies to: S0 and S1 pricing tiers.
May 16, 2019 An Extensible Map Abstraction for Flutter. Contribute to bmw-tech/atlas development by creating an account on GitHub. May 14, 2016 Hi, is there a way a layman could add the google maps source to the latest version of mobac? I realise that you can access google maps on mobac by using an older version of it, but this isnt enough for me, as I want to be able to have the options of the latest version too - particularly in terms of area selection e.g. The option to create a map around a gpx. Page 1, records 1-0 of 0. Google Maps is a web mapping service provided by Google that features a map that users can pan (by dragging the mouse) and zoom (by using the mouse wheel). Collection points are displayed as colored markers that when clicked on, displays the full information for that collection.
The static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The supported resolution range for the map image is from 1x1 to 8192x8192. If you are deciding when to use the static image service over the map tile service, you may want to consider how you would like to interact with the rendered map. If the map contents will be relatively unchanging, a static map is a good choice. If you want to support a lot of zooming, panning and changing of the map content, the map tile service would be a better choice.
Service also provides Image Composition functionality to get a static image back with additional data like; pushpins and geometry overlays with following S0 and S1 capabilities.
In S0 you can:
- Render up to 5 pushpins specified in the request
- Provide one custom image for the pins referenced in the request
- Add labels to the pushpins
In S1 you can:
- Render pushpins through Azure Maps Data Service
- Specify multiple pushpin styles
- Provide custom pushpin images stored in Azure Maps Data Service
- Render circle, polyline and polygon geometry types.
- Render of supported GeoJSON geometry types uploaded through Azure Maps Data Service
Please see How-to-Guide for detailed examples.
Note : Either center or bbox parameter must be supplied to theAPI.
The supported Lat and Lon ranges when using the bbox parameter, are as follows:
Zoom Level | Max Lon Range | Max Lat Range |
---|---|---|
0 | 360.0 | 170.0 |
1 | 360.0 | 170.0 |
2 | 360.0 | 170.0 |
3 | 360.0 | 170.0 |
4 | 360.0 | 170.0 |
5 | 180.0 | 85.0 |
6 | 90.0 | 42.5 |
7 | 45.0 | 21.25 |
8 | 22.5 | 10.625 |
9 | 11.25 | 5.3125 |
10 | 5.625 | 2.62625 |
11 | 2.8125 | 1.328125 |
12 | 1.40625 | 0.6640625 |
13 | 0.703125 | 0.33203125 |
14 | 0.3515625 | 0.166015625 |
15 | 0.17578125 | 0.0830078125 |
16 | 0.087890625 | 0.0415039063 |
17 | 0.0439453125 | 0.0207519531 |
18 | 0.0219726563 | 0.0103759766 |
19 | 0.0109863281 | 0.0051879883 |
20 | 0.0054931641 | 0.0025939941 |
URI Parameters
Name | In | Required | Type | Description | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format | path | True | Desired format of the response. Possible value: png. | |||||||||||||||||||||||||||
query |
| One of the Azure Maps keys provided from an Azure Map Account. Please refer to this article for details on how to manage authentication. | ||||||||||||||||||||||||||||
api-version | query | True |
| Version number of Azure Maps API. Current version is 1.0 | ||||||||||||||||||||||||||
query | Map layer requested. If layer is set to labels or hybrid, the format should be png. | |||||||||||||||||||||||||||||
style | query | Map style to be returned. Possible values are main and dark. | ||||||||||||||||||||||||||||
query |
| Desired zoom level of the map. Zoom value must be in the range: 0-20 (inclusive). Default value is 12. | ||||||||||||||||||||||||||||
center | query |
| Coordinates of the center point. Format: 'lon,lat'. Projection used
Note: Either center or bbox are required parameters. They aremutually exclusive. | |||||||||||||||||||||||||||
query |
| Bounding box. Projection used - EPSG:3857. Format : 'minLon, minLat,maxLon, maxLat'. Note: Either bbox or center are requiredparameters. They are mutually exclusive. It shouldn’t be used withheight or width. The maximum allowed ranges for Lat and Lon are defined for each zoom levelin the table at the top of this page. | ||||||||||||||||||||||||||||
height | query |
| Height of the resulting image in pixels. Range is 1 to 8192. Defaultis 512. It shouldn’t be used with bbox. | |||||||||||||||||||||||||||
query |
| Width of the resulting image in pixels. Range is 1 to 8192. Default is 512. It shouldn’t be used with bbox. | ||||||||||||||||||||||||||||
language | query |
| Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in specified language is not available for a specific field, default language is used. Please refer to Supported Languages for details. | |||||||||||||||||||||||||||
query |
| The View parameter specifies which set of geopolitically disputed content is returned via Azure Maps services, including borders and labels displayed on the map. The View parameter (also referred to as “user region parameter”) will show the correct maps for that country/region. By default, the View parameter is set to “Unified” even if you haven’t defined it in the request. It is your responsibility to determine the location of your users, and then set the View parameter correctly for that location. Alternatively, you have the option to set ‘View=Auto’, which will return the map data based on the IP address of the request. The View parameter in Azure Maps must be used in compliance with applicable laws, including those regarding mapping, of the country where maps, images and other data and third party content that you are authorized to access via Azure Maps is made available. Example: view=IN. Please refer to Supported Views for details and to see the available Views. | ||||||||||||||||||||||||||||
pins | query |
| Pushpin style and instances. Use this parameter to optionally add pushpins to the image.The pushpin style describes the appearance of the pushpins, and the instances specifythe coordinates of the pushpins and optional labels for each pin. (Be sure to properly URL-encode values of thisparameter since it will contain reserved characters such as pipes and punctuation.) The Azure Maps account S0 SKU only supports a single instance of the pins parameter. Other SKUsallow multiple instances of the pins parameter to specify multiple pin styles. To render a pushpin at latitude 45°N and longitude 122°W using the default built-in pushpin style, add thequerystring parameter
Note that the longitude comes before the latitude.After URL encoding this will look like
All of the examples here show the pinsparameter without URL encoding, for clarity. To render a pin at multiple locations, separate each location with a pipe character. For example, use
The S0 Azure Maps account SKU only allows five pushpins. Other account SKUs do not have this limitation. Style ModifiersYou can modify the appearance of the pins by adding style modifiers. These are added after the style but beforethe locations and labels. Style modifiers each have a two-letter name. These abbreviated names are used to helpreduce the length of the URL. To change the color of the pushpin, use the 'co' style modifier and specify the color using the HTML/CSS RGB colorformat which is a six-digit hexadecimal number (the three-digit form is not supported). For example, to usea deep pink color which you would specify as #FF1493 in CSS, use
Pushpin LabelsTo add a label to the pins, put the label in single quotes just before the coordinates. For example, to labelthree pins with the values '1', '2', and '3', use
There is a built in pushpin style called 'none' that does not display a pushpin image. You can use this ifyou want to display labels without any pin image. For example,
MAC Jotun Valhalla Edition 토렌트 torrent 로그인한 회원만 댓글 등록이 가능합니다. Jotun Impress the Gods! Jotun is a hand-drawn action-exploration game set in Norse mythology. In Jotun, you play Thora, a Viking warrior who died an inglorious death and must prove herself to the Gods to enter Valhalla. Jotun: Valhalla Edition – A hand-drawn exploration game set in Norse mythology Cracked Games Jotun Torrent. In Jotun, you play Thora, a Viking warrior who died an inglorious death and must prove herself to the Gods to enter Valhalla. Jotun valhalla review. To change the color of the pushpin labels, use the 'lc' label color style modifier. For example, to use pinkpushpins with black labels, use
To change the size of the labels, use the 'ls' label size style modifier. The label size represents the approximateheight of the label text in pixels. For example, to increase the label size to 12, use
The labels are centered at the pushpin 'label anchor.' The anchor location is predefined for built-in pushpins andis at the top center of custom pushpins (see below). To override the label anchor, using the 'la' style modifierand provide X and Y pixel coordinates for the anchor. These coordinates are relative to the top left corner of thepushpin image. Positive X values move the anchor to the right, and positive Y values move the anchor down. For example,to position the label anchor 10 pixels right and 4 pixels above the top left corner of the pushpin image,use
Custom PushpinsTo use a custom pushpin image, use the word 'custom' as the pin style name, and then specify a URL after thelocation and label information. Use two pipe characters to indicate that you're done specifying locations and arestarting the URL. For example,
After URL encoding, this would look like
By default, custom pushpin images are drawn centered at the pin coordinates. This usually isn't ideal as it obscuresthe location that you're trying to highlight. To override the anchor location of the pin image, use the 'an'style modifier. This uses the same format as the 'la' label anchor style modifier. For example, if your custompin image has the tip of the pin at the top left corner of the image, you can set the anchor to that spot byusing
Note: If you use the 'co' color modifier with a custom pushpin image, the specified color will replace the RGBchannels of the pixels in the image but will leave the alpha (opacity) channel unchanged. This would usuallyonly be done with a solid-color custom image. Getting Pushpins from Azure Maps Data StorageFor all Azure Maps account SKUs other than S0,the pushpin image and location information can be obtained from Azure Maps Data Storage. After uploading a pushpin imageor a GeoJSON document containing pin locations, the Data Storage service returns a Unique Data ID (UDID) that you can useto reference the data in the pins parameter. To use a custom pushpin image from Azure Maps Data Storage, specify the UDID prefixed by 'udid-' as the name of thepushpin style. For example,
To use the point geometry from an uploaded GeoJSON document as the pin locations, specify the UDID in the locationssection of the pins parameter. For example,
Note thatonly point and multipoint geometry, points and multipoints from geometry collections, and point geometry from featureswill be used. Linestring and polygon geometry will be ignored. If the point comes from a feature and the featurehas a string property called 'label', the value of that property will be used as the label for the pin. You can mix pin locations from Data Storage and pin locations specified in the pins parameter. Any of the pipe-delimitedpin locations can be a longitude and latitude or a UDID. For example,
Scale, Rotation, and OpacityYou can make pushpins and their labels larger or smaller by using the 'sc' scale style modifier. This is avalue greater than zero. A value of 1 is the standard scale. Values larger than 1 will make the pins larger, andvalues smaller than 1 will make them smaller. For example, to draw the pushpins 50% larger than normal, use
You can rotate pushpins and their labels by using the 'ro' rotation style modifier. This is a number of degreesof clockwise rotation. Use a negative number to rotate counter-clockwise. For example, to rotate the pushpins90 degrees clockwise and double their size, use
You can make pushpins and their labels partially transparent by specifying the 'al' alpha style modifier.This is a number between 0 and 1 indicating the opacity of the pushpins. Zero makes them completely transparent(and not visible) and 1 makes them completely opaque (which is the default). For example, to make pushpinsand their labels only 67% opaque, use
Style Modifier Summary
| |||||||||||||||||||||||||||
query |
| Path style and locations. Use this parameter to optionally add lines, polygons or circles to the image.The path style describes the appearance of the line and fill. (Be sure to properly URL-encode values of thisparameter since it will contain reserved characters such as pipes and punctuation.) Path parameter is supported in Azure Maps account SKU starting with S1. Multiple instances of the path parameterallow to specify multiple geometries with their styles. Number of parameters per request is limited to 10 andnumber of locations is limited to 100 per path. To render a circle with radius 100 meters and center point at latitude 45°N and longitude 122°W using the default style, add thequerystring parameter
Note that the longitude comes before the latitude.After URL encoding this will look like
All of the examples here show the path parameter without URL encoding, for clarity. To render a line, separate each location with a pipe character. For example, use
To render a polygon, last location must be equal to the start location. For example, use
Longitude and latitude values for locations of lines and polygons can be in the range from -360 to 360 to allow for rendering of geometries crossing the anti-meridian. Style ModifiersYou can modify the appearance of the path by adding style modifiers. These are added before the locations.Style modifiers each have a two-letter name. These abbreviated names are used to help reduce the lengthof the URL. To change the color of the outline, use the 'lc' style modifier and specify the color using the HTML/CSS RGB colorformat which is a six-digit hexadecimal number (the three-digit form is not supported). For example, to usea deep pink color which you would specify as #FF1493 in CSS, use
Multiple style modifiers may be combined together to create a more complex visual style.
Getting Path locations from Azure Maps Data StorageFor all Azure Maps account SKUs other than S0, the path location information can be obtained from Azure Maps Data Storage.After uploading a GeoJSON document containing path locations, the Data Storage service returns a Unique Data ID (UDID) that you can useto reference the data in the path parameter. To use the point geometry from an uploaded GeoJSON document as the path locations, specify the UDID in the locationssection of the path parameter. For example,
Note the it is not allowed to mix path locations from Data Storage with locations specified in the path parameter. Style Modifier Summary
|
Request Header
Name | Required | Type | Description |
---|---|---|---|
x-ms-client-id |
| Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from Azure Maps management plane Account API. To use Azure AD security in Azure Maps see the following articles for guidance. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
| OK Media Types: 'application/json', 'image/jpeg', 'image/png' |
400 Bad Request | Bad request: one or more parameters were incorrectly specified or are mutually exclusive. Media Types: 'application/json', 'image/jpeg', 'image/png' | |
401 Unauthorized | Access denied due to invalid subscription key or invalid Azure Active Directory bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the WWW-Authenticate header for error code and description of the provided AAD bearer token. Media Types: 'application/json', 'image/jpeg', 'image/png' Headers
| |
403 Forbidden | Permission, capacity, or authentication issues. Media Types: 'application/json', 'image/jpeg', 'image/png' | |
404 Not Found | Not Found: the requested resource could not be found, but it may be available again in the future. Media Types: 'application/json', 'image/jpeg', 'image/png' | |
500 Internal Server Error | An error occurred while processing the request. Please try again later. Media Types: 'application/json', 'image/jpeg', 'image/png' |
Security
azure_auth
These are the Azure Active Directory OAuth2 Flows. When paired with Azure Role Based Access control it can be used to control access to Azure Maps REST APIs. Azure Role based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built in role or a custom role composed of one or more permissions to Azure Maps REST APIs.
To implement scenarios we recommend viewing authentication concepts. In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.
Note
- This security definition requires the use of the
x-ms-client-id
header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the Maps management API. - The
Authorization URL
is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. - The Azure role based access control is configured from the Azure management plane via Azure portal, Powershell, CLI, Azure SDKs, or REST APIs.
- Usage of the Azure Maps Web SDK allows for configuration based setup of an application for multiple use cases.
- Currently Azure Active Directory v1.0 tokens are supported.
Atlas 0 Gauge Track
Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize
subscription-key
This is a shared key which is provisioned when creating an Azure Maps resource through the Azure management plane via Azure portal, Powershell, CLI, Azure SDKs, or REST APIs. With this key, any application is authorized to access all REST APIs. In other words, these can currently be treated as master keys to the account which they are issued for. For publicly exposed applications our recommendation is to use server to server access of Azure Maps REST APIs where this key can be securely stored.
Type: apiKey
In: query
Examples
GetMapStaticImage
Sample Request
Definitions
Error | This object is returned when an error occurs in the Maps API |
ErrorResponse | This response object is returned when an error occurs in the Maps API |
MapImageStyle | Map style to be returned. Possible values are main and dark. |
RasterTileFormat | Desired format of the response. Possible value: png. |
StaticMapLayer | Map layer requested. If layer is set to labels or hybrid, the format should be png. |
Error
This object is returned when an error occurs in the Maps API
Name | Type | Description |
---|---|---|
code |
| The HTTP status code. |
message |
| If available, a human readable description of the error. |
Google Maps 0
ErrorResponse
This response object is returned when an error occurs in the Maps API
Name | Type | Description |
---|---|---|
error | This object is returned when an error occurs in the Maps API |
MapImageStyle
Atlas 0 Scale Track
Map style to be returned. Possible values are main and dark.
Name | Type | Description |
---|---|---|
dark |
| Dark grey version of the Azure Maps main style |
main |
| Azure Maps main style |
RasterTileFormat
Desired format of the response. Possible value: png.
Name | Type | Description |
---|---|---|
png |
| An image in the png format. Supports zoom levels 0 through 18. |
StaticMapLayer
Map layer requested. If layer is set to labels or hybrid, the format should be png.
Name | Type | Description |
---|---|---|
basic |
| Returns an image containing all map features including polygons, borders, roads and labels. |
hybrid |
| Returns an image containing borders, roads, and labels, and can be overlaid on other tiles (such as satellite imagery) to produce hybrid tiles. |
labels |
| Returns an image of just the map's label information. |
home > Maps of Faerûn
|