GetStaticMapRequest
¶
Source code in docs_src/capo_geo_maps/types/get_static_map_request.py
bounded_positions
instance-attribute
¶
bounded_positions: NotRequired[PositionListString]
Takes in two or more pair of coordinates in World Geodetic System (WGS 84) format: [longitude, latitude], with each coordinate separated by a comma. The API will generate an image to encompass all of the provided coordinates.
Cannot be used with Zoom and or Radius
Example: 97.170451,78.039098,99.045536,27.176178
bounding_box
instance-attribute
¶
bounding_box: NotRequired[PositionListString]
Takes in two pairs of coordinates in World Geodetic System (WGS 84) format: [longitude, latitude], 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
center
instance-attribute
¶
center: NotRequired[PositionString]
Takes in a pair of coordinates in World Geodetic System (WGS 84) format: [longitude, latitude], which becomes the center point of the image. This parameter requires that either zoom or radius is set.
Cannot be used with Zoom and or Radius
Example: 49.295,-123.108
color_scheme
instance-attribute
¶
color_scheme: NotRequired[ColorScheme]
Sets the color tone for the map, such as dark and light.
Example: Light
Default value: Light
Valid values for ColorScheme are case sensitive.
compact_overlay
instance-attribute
¶
compact_overlay: NotRequired[CompactOverlay]
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
Currently it supports the following geometry types: point, line and polygon. It does not support multiPoint , multiLine and multiPolgyon.
crop_labels
instance-attribute
¶
crop_labels: NotRequired[bool]
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.
file_name
instance-attribute
¶
file_name: str
The map scaling parameter to size the image, icons, and labels. It follows the pattern of ^map(@2x)?$.
Example: map, map@2x
geo_json_overlay
instance-attribute
¶
geo_json_overlay: NotRequired[GeoJsonOverlay]
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"}}]}
key
instance-attribute
¶
key: NotRequired[ApiKey]
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
label_size
instance-attribute
¶
label_size: NotRequired[LabelSize]
Overrides the label size auto-calculated by FileName. Takes in one of the values - Small or Large.
language
instance-attribute
¶
language: NotRequired[LanguageTag]
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
instance-attribute
¶
padding: NotRequired[SensitiveInteger]
Applies additional space (in pixels) around overlay feature to prevent them from being cut or obscured.
Value for max and min is determined by:
Min: 1
Max: min(height, width)/4
Example: 100
points_of_interests
instance-attribute
¶
points_of_interests: NotRequired[MapFeatureMode]
Determines if the result image will display icons representing points of interest on the map.
political_view
instance-attribute
¶
political_view: NotRequired[CountryCode]
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
radius
instance-attribute
¶
radius: NotRequired[DistanceMeters]
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
Cannot be used with Zoom.
Unit: Meters
scale_bar_unit
instance-attribute
¶
scale_bar_unit: NotRequired[ScaleBarUnit]
Displays a scale on the bottom right of the map image with the unit specified in the input.
Example: KilometersMiles, Miles, Kilometers, MilesKilometers
style
instance-attribute
¶
style: NotRequired[StaticMapStyle]
Style specifies the desired map style.
zoom
instance-attribute
¶
zoom: NotRequired[SensitiveFloat]
Specifies the zoom level of the map image.
Cannot be used with Radius.