LocationServiceMapsV2 / Client / get_static_map

get_static_map#

LocationServiceMapsV2.Client.get_static_map(**kwargs)#

GetStaticMap provides high-quality static map images with customizable options. You can modify the map’s appearance and overlay additional information. It’s an ideal solution for applications requiring tailored static map snapshots.

See also: AWS API Documentation

Request Syntax

response = client.get_static_map(
    BoundingBox='string',
    BoundedPositions='string',
    Center='string',
    ColorScheme='Light'|'Dark',
    CompactOverlay='string',
    CropLabels=True|False,
    GeoJsonOverlay='string',
    Height=123,
    Key='string',
    LabelSize='Small'|'Large',
    Language='string',
    Padding=123,
    PoliticalView='string',
    PointsOfInterests='Enabled'|'Disabled',
    Radius=123,
    FileName='string',
    ScaleBarUnit='Kilometers'|'KilometersMiles'|'Miles'|'MilesKilometers',
    Style='Satellite'|'Standard',
    Width=123,
    Zoom=...
)
Parameters:
  • BoundingBox (string) –

    Takes in two pairs of coordinates, [Lon, Lat], denoting south-westerly and north-easterly edges of the image. The underlying area becomes the view of the image.

    Example: -123.17075,49.26959,-123.08125,49.31429

  • BoundedPositions (string) –

    Takes in two or more pair of coordinates, [Lon, Lat], with each coordinate separated by a comma. The API will generate an image to encompass all of the provided coordinates.

    Note

    Cannot be used with Zoom and or Radius

    Example: 97.170451,78.039098,99.045536,27.176178

  • Center (string) –

    Takes in a pair of coordinates, [Lon, Lat], which becomes the center point of the image. This parameter requires that either zoom or radius is set.

    Note

    Cannot be used with Zoom and or Radius

    Example: 49.295,-123.108

  • ColorScheme (string) –

    Sets color tone for map, such as dark and light for specific map styles. It only applies to vector map styles, such as Standard.

    Example: Light

    Default value: Light

    Note

    Valid values for ColorScheme are case sensitive.

  • CompactOverlay (string) –

    Takes in a string to draw geometries on the image. The input is a comma separated format as follows format: [Lon, Lat]

    Example: line:-122.407653,37.798557,-122.413291,37.802443;color=%23DD0000;width=7;outline-color=#00DD00;outline-width=5yd|point:-122.40572,37.80004;label=Fog Hill Market;size=large;text-color=%23DD0000;color=#EE4B2B

    Note

    Currently it supports the following geometry types: point, line and polygon. It does not support multiPoint , multiLine and multiPolgyon.

  • CropLabels (boolean) – It is a flag that takes in true or false. It prevents the labels that are on the edge of the image from being cut or obscured.

  • GeoJsonOverlay (string) –

    Takes in a string to draw geometries on the image. The input is a valid GeoJSON collection object.

    Example: {"type":"FeatureCollection","features": [{"type":"Feature","geometry":{"type":"MultiPoint","coordinates": [[-90.076345,51.504107],[-0.074451,51.506892]]},"properties": {"color":"#00DD00"}}]}

  • Height (integer) –

    [REQUIRED]

    Specifies the height of the map image.

  • Key (string) – Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.

  • LabelSize (string) – Overrides the label size auto-calculated by FileName. Takes in one of the values - Small or Large.

  • Language (string) –

    Specifies the language on the map labels using the BCP 47 language tag, limited to ISO 639-1 two-letter language codes. If the specified language data isn’t available for the map image, the labels will default to the regional primary language.

    Supported codes:

    • ar

    • as

    • az

    • be

    • bg

    • bn

    • bs

    • ca

    • cs

    • cy

    • da

    • de

    • el

    • en

    • es

    • et

    • eu

    • fi

    • fo

    • fr

    • ga

    • gl

    • gn

    • gu

    • he

    • hi

    • hr

    • hu

    • hy

    • id

    • is

    • it

    • ja

    • ka

    • kk

    • km

    • kn

    • ko

    • ky

    • lt

    • lv

    • mk

    • ml

    • mr

    • ms

    • mt

    • my

    • nl

    • no

    • or

    • pa

    • pl

    • pt

    • ro

    • ru

    • sk

    • sl

    • sq

    • sr

    • sv

    • ta

    • te

    • th

    • tr

    • uk

    • uz

    • vi

    • zh

  • Padding (integer) –

    Applies additional space (in pixels) around overlay feature to prevent them from being cut or obscured.

    Note

    Value for max and min is determined by:

    Min: 1

    Max: min(height, width)/4

    Example: 100

  • PoliticalView (string) –

    Specifies the political view, using ISO 3166-2 or ISO 3166-3 country code format.

    The following political views are currently supported:

    • ARG: Argentina’s view on the Southern Patagonian Ice Field and Tierra Del Fuego, including the Falkland Islands, South Georgia, and South Sandwich Islands

    • EGY: Egypt’s view on Bir Tawil

    • IND: India’s view on Gilgit-Baltistan

    • KEN: Kenya’s view on the Ilemi Triangle

    • MAR: Morocco’s view on Western Sahara

    • RUS: Russia’s view on Crimea

    • SDN: Sudan’s view on the Halaib Triangle

    • SRB: Serbia’s view on Kosovo, Vukovar, and Sarengrad Islands

    • SUR: Suriname’s view on the Courantyne Headwaters and Lawa Headwaters

    • SYR: Syria’s view on the Golan Heights

    • TUR: Turkey’s view on Cyprus and Northern Cyprus

    • TZA: Tanzania’s view on Lake Malawi

    • URY: Uruguay’s view on Rincon de Artigas

    • VNM: Vietnam’s view on the Paracel Islands and Spratly Islands

  • PointsOfInterests (string) – Determines if the result image will display icons representing points of interest on the map.

  • Radius (integer) –

    Used with center parameter, it specifies the zoom of the image where you can control it on a granular level. Takes in any value >= 1.

    Example: 1500

    Note

    Cannot be used with Zoom.

    Unit: Meters

  • FileName (string) –

    [REQUIRED]

    The map scaling parameter to size the image, icons, and labels. It follows the pattern of ^map(@2x)?$.

    Example: map, map@2x

  • ScaleBarUnit (string) –

    Displays a scale on the bottom right of the map image with the unit specified in the input.

    Example: KilometersMiles, Miles, Kilometers, MilesKilometers

  • Style (string) – Style specifies the desired map style.

  • Width (integer) –

    [REQUIRED]

    Specifies the width of the map image.

  • Zoom (float) –

    Specifies the zoom level of the map image.

    Note

    Cannot be used with Radius.

Return type:

dict

Returns:

Response Syntax

{
    'Blob': StreamingBody(),
    'ContentType': 'string',
    'CacheControl': 'string',
    'ETag': 'string',
    'PricingBucket': 'string'
}

Response Structure

  • (dict) –

    • Blob (StreamingBody) –

      The blob represents a map image as a jpeg for the GetStaticMap API.

    • ContentType (string) –

      Header that represents the format of the response. The response returns the following as the HTTP body.

    • CacheControl (string) –

      Header that instructs caching configuration for the client.

    • ETag (string) –

      The static map’s Etag.

    • PricingBucket (string) –

      The pricing bucket for which the request is charged at.

Exceptions

  • LocationServiceMapsV2.Client.exceptions.InternalServerException

  • LocationServiceMapsV2.Client.exceptions.AccessDeniedException

  • LocationServiceMapsV2.Client.exceptions.ValidationException

  • LocationServiceMapsV2.Client.exceptions.ThrottlingException