get-static-map

Описание

GetStaticMap предоставляет высококачественные статические изображения карт с настраиваемыми параметрами. Вы можете изменить внешний вид карты и добавить дополнительную информацию. Это идеальное решение для приложений, требующих настраиваемых снимков статических карт.

См. также: Документацию API AWS

Синтаксис

  get-static-map
[--bounding-box <value>]
[--bounded-positions <value>]
[--center <value>]
[--color-scheme <value>]
[--compact-overlay <value>]
[--crop-labels | --no-crop-labels]
[--geo-json-overlay <value>]
--height <value>
[--key <value>]
[--label-size <value>]
[--language <value>]
[--padding <value>]
[--political-view <value>]
[--points-of-interests <value>]
[--radius <value>]
--file-name <value>
[--scale-bar-unit <value>]
[--style <value>]
--width <value>
[--zoom <value>]
<outfile>
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--bounding-box (строка)

Принимает две пары координат, [Долгота, Широта], обозначающие юго-западную и северо-восточную границы изображения. Подлежащая область становится областью просмотра изображения.

Пример: -123.17075,49.26959,-123.08125,49.31429

--bounded-positions (строка)

Принимает две или более пары координат, [Долгота, Широта], где каждая координата отделена запятой. API сгенерирует изображение, охватывающее все указанные координаты.

Примечание

Нельзя использовать с Zoom и/или Radius

Пример: 97.170451,78.039098,99.045536,27.176178

--center (строка)

Принимает пару координат, [Долгота, Широта], которые становятся центральной точкой изображения. Этот параметр требует, чтобы был задан параметр zoom или radius.

Примечание

Нельзя использовать с Zoom и/или Radius

Пример: 49.295,-123.108

--color-scheme (строка)

Устанавливает цветовой тон карты, например, темный и светлый для определенных стилей карт. Применяется только к векторным стилям карт, таким как Standard.

Пример: Light

Значение по умолчанию: Light

Примечание

Допустимые значения для ColorScheme чувствительны к регистру.

Возможные значения:

Light
Dark

--compact-overlay (строка)

Принимает строку для рисования геометрий на изображении. Входной формат — через запятую, как указано ниже: [Lon, Lat]

Пример: 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

Примечание

В настоящее время поддерживаются следующие типы геометрий: точка, линия и многоугольник. Не поддерживаются multiPoint, multiLine и multiPolygon.

--crop-labels | --no-crop-labels (логическое значение)

Это флаг, принимающий значения true или false. Он предотвращает обрезку или скрытие меток на краю изображения.

--geo-json-overlay (строка)

Принимает строку для рисования геометрий на изображении. Входной формат — корректный GeoJSON-объект коллекции.

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

--height (целое число)

Указывает высоту изображения карты.

--key (строка)

Необязательно: API-ключ для авторизации. При запросе необходимо указать либо API-ключ, либо корректную подпись SigV4.

--label-size (строка)

Переопределяет размер меток, автоматически рассчитанный FileName . Принимает одно из значений - Small или Large .

Возможные значения:

Small
Large

--language (строка)

Указывает язык меток на карте, используя тег языка BCP 47, ограниченный двузначными кодами языков ISO 639-1. Если указанные данные языка недоступны для изображения карты, метки будут по умолчанию отображаться на языке региона.

Поддерживаемые коды:

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 (целое число)

Добавляет дополнительное пространство (в пикселях) вокруг наложенных элементов, чтобы предотвратить их обрезку или скрытие.

Примечание

Значения max и min определяются:

Min: 1

Max: min(height, width)/4

Пример: 100

--political-view (строка)

Указывает политическую точку зрения, используя формат кода страны ISO 3166-2 или ISO 3166-3.

В настоящее время поддерживаются следующие политические точки зрения:

ARG : Точка зрения Аргентины на Южно-патагонское ледниковое поле и Землю Огня, включая Фолклендские острова, Южную Георгию и Южные Сандвичевы острова
EGY : Точка зрения Египта на Бир-Тауил
IND : Точка зрения Индии на Гильгит-Балтистан
KEN : Точка зрения Кении на Треугольник Илеми
MAR : Точка зрения Марокко на Западную Сахару
RUS : Точка зрения России на Крым
SDN : Точка зрения Судана на Триугольник Халиб
SRB : Точка зрения Сербии на Косово, Вukoвaр и острова Сaренгрaд
SUR : Точка зрения Суринама на верховья рек Курантин и Лава
SYR : Точка зрения Сирии на Голанские высоты
TUR : Точка зрения Турции на Кипр и Северный Кипр
TZA : Точка зрения Танзании на озеро Малави
URY : Точка зрения Уругвая на Ринкон-де-Артигас
VNM : Точка зрения Вьетнама на острова Парасель и Спратли

--points-of-interests (строка)

Определяет, будут ли на изображении отображаться значки, представляющие точки интереса на карте.

Возможные значения:

Enabled
Disabled

--radius (длинное целое число)

Используется с параметром center, он указывает масштаб изображения, где можно контролировать его на уровне зерен. Принимает любое значение >= 1 .

Пример: 1500

Примечание

Нельзя использовать с Zoom .

Единица измерения : Meters

--file-name (строка)

Параметр масштабирования карты для изменения размера изображения, значков и меток. Следует шаблону ^map(@2x)?$ .

Пример: map, map@2x

--scale-bar-unit (строка)

Отображает масштаб в правом нижнем углу изображения карты с указанной в входных данных единицей измерения.

Пример: KilometersMiles, Miles, Kilometers, MilesKilometers

Возможные значения:

Kilometers
KilometersMiles
Miles
MilesKilometers

--style (строка)

Style указывает желаемый стиль карты.

Возможные значения:

Satellite
Standard

--width (целое число)

Указывает ширину изображения карты.

--zoom (вещественное число)

Указывает уровень масштабирования изображения карты.

Примечание

Нельзя использовать с Radius .

outfile (строка) Имя файла, куда будет сохранён контент

Общие параметры

--debug (boolean)

Включить отладку.

--endpoint-url (string)

Переопределить стандартный URL команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить вывод в цвете.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр задан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

Blob -> (blob)

Блок представляет собой изображение карты как jpeg для API GetStaticMap.

ContentType -> (string)

Заголовок, который представляет формат ответа. Ответ возвращает следующее в качестве тела HTTP.

CacheControl -> (string)

Заголовок, который задает настройки кэширования для клиента.

ETag -> (string)

ETag статической карты.

PricingBucket -> (string)

Ведро ценообразования, за которое взимается плата за запрос.