Поделиться через

RenderURL class

  • Ссылка
Пакет:
azure-maps-rest

RenderURL представляет URL-адрес Azure Maps операций отрисовки.

Extends
MapsURL

Конструкторы

RenderURL(Pipeline, string)

Создает экземпляр RenderURL.

Унаследованные свойства

mapsUrl

Базовое строковое значение URL-адреса.

Методы

getMapImage(Aborter, GetMapImageOptions)

Отрисовывает определенное пользователем прямоугольное изображение, содержащее раздел карты, используя уровень масштабирования от 0 до 20. Служба статических изображений отрисовывает определенное пользователем прямоугольное изображение, содержащее раздел карты, используя уровень масштаба от 0 до 20. Поддерживаемый диапазон разрешения для изображения карты — от 1x1 до 8192 x 8192. Если вы решаете, когда следует использовать службу статических изображений поверх службы плиток карты, вы можете подумать о том, как вы хотите взаимодействовать с отображаемой картой. Если содержимое карты будет относительно неизменным, рекомендуется использовать статическую карту. Если вы хотите поддерживать большое количество масштабирования, сдвига и изменения содержимого карты, лучше будет использовать службу плиток карты. Служба также предоставляет функцию композиции изображений, чтобы получить статическое изображение с дополнительными данными, такими как ; pushpins и геометрические наложения со следующими возможностями S0 и S1.

В S0 можно:

  • Отрисовка до 5 канцелярской ветвей, указанных в запросе
  • Укажите один пользовательский образ для контактов, на которые ссылается запрос
  • Добавление меток в канцеляры

В S1 можно:

  • Отрисовка канцелярской кнопки через службу Azure Maps data Service
  • Указание нескольких стилей канцелярской кнопки
  • Предоставление пользовательских образов pushpin, хранящихся в службе данных Azure Maps
  • Отрисовка геометрических типов кругов, ломаных линий и многоугольников.
  • Отрисовка поддерживаемых геометрических типов GeoJSON, отправленных через службу данных Azure Maps

Подробные примеры см. в практическом руководстве .

Примечание . В API необходимо указать параметр center или bbox .

Поддерживаемые диапазоны Lat и Lon при использовании параметра bbox :

Масштаб Максимальный диапазон Лона Максимальный диапазон латов
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

Использует API получения изображения карты: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

Возвращает плитку изображения карты размером 256x256 с учетом координат x и y и уровня масштаба. Масштаб в диапазоне от 0 до 18. Текущим доступным значением стиля является "satellite", который предоставляет только спутниковые снимки. Использует API получения фрагментов изображений карты: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Возвращает плитки карты в векторном или растровом формате, которые обычно необходимо интегрировать в новый элемент управления картой или пакет SDK. По умолчанию Azure использует плитки векторной карты для своего элемента управления веб-картой (см. статью Уровни масштабирования и сетка плиток). Использует API получения фрагментов карты: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Наследуемые методы

newPipeline(Credential, INewPipelineOptions)

Статический метод, используемый для создания нового объекта Pipeline с предоставленными учетными данными.

Сведения о конструкторе

RenderURL(Pipeline, string)

Создает экземпляр RenderURL.

new RenderURL(pipeline: Pipeline, mapsUrl?: string)

Параметры

pipeline
Pipeline

Вызовите MapsURL.newPipeline(), чтобы создать конвейер по умолчанию или предоставить настраиваемый конвейер.

mapsUrl

string

Строка URL-адреса, указывающая на службу Azure Maps, по умолчанию — "https://atlas.microsoft.com". Если протокол не указан, например "atlas.microsoft.com", https будет принято.

Сведения об унаследованном свойстве

mapsUrl

Базовое строковое значение URL-адреса.

mapsUrl: string

Значение свойства

string

Наследуется отMapsURL.mapsUrl

Сведения о методе

getMapImage(Aborter, GetMapImageOptions)

Отрисовывает определенное пользователем прямоугольное изображение, содержащее раздел карты, используя уровень масштабирования от 0 до 20. Служба статических изображений отрисовывает определенное пользователем прямоугольное изображение, содержащее раздел карты, используя уровень масштаба от 0 до 20. Поддерживаемый диапазон разрешения для изображения карты — от 1x1 до 8192 x 8192. Если вы решаете, когда следует использовать службу статических изображений поверх службы плиток карты, вы можете подумать о том, как вы хотите взаимодействовать с отображаемой картой. Если содержимое карты будет относительно неизменным, рекомендуется использовать статическую карту. Если вы хотите поддерживать большое количество масштабирования, сдвига и изменения содержимого карты, лучше будет использовать службу плиток карты. Служба также предоставляет функцию композиции изображений, чтобы получить статическое изображение с дополнительными данными, такими как ; pushpins и геометрические наложения со следующими возможностями S0 и S1.

В S0 можно:

  • Отрисовка до 5 канцелярской ветвей, указанных в запросе
  • Укажите один пользовательский образ для контактов, на которые ссылается запрос
  • Добавление меток в канцеляры

В S1 можно:

  • Отрисовка канцелярской кнопки через службу Azure Maps data Service
  • Указание нескольких стилей канцелярской кнопки
  • Предоставление пользовательских образов pushpin, хранящихся в службе данных Azure Maps
  • Отрисовка геометрических типов кругов, ломаных линий и многоугольников.
  • Отрисовка поддерживаемых геометрических типов GeoJSON, отправленных через службу данных Azure Maps

Подробные примеры см. в практическом руководстве .

Примечание . В API необходимо указать параметр center или bbox .

Поддерживаемые диапазоны Lat и Lon при использовании параметра bbox :

Масштаб Максимальный диапазон Лона Максимальный диапазон латов
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

Использует API получения изображения карты: https://docs.microsoft.com/rest/api/maps/render/getmapimage

function getMapImage(aborter: Aborter, options: GetMapImageOptions): Promise<GetMapImageResponse>

Параметры

aborter
Aborter

Создайте новый экземпляр Aborter с помощью Aborter.none или Aborter.timeout(), перейдите к документам Aborter, чтобы получить дополнительные примеры об отмене запроса.

options
GetMapImageOptions

Возвращаемое значение

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

Возвращает плитку изображения карты размером 256x256 с учетом координат x и y и уровня масштаба. Масштаб в диапазоне от 0 до 18. Текущим доступным значением стиля является "satellite", который предоставляет только спутниковые снимки. Использует API получения фрагментов изображений карты: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

function getMapImageryTile(aborter: Aborter, zoom: number, xTileIndex: number, yTileIndex: number): Promise<GetMapImageryTileResponse>

Параметры

aborter
Aborter

Создайте новый экземпляр Aborter с помощью Aborter.none или Aborter.timeout(), перейдите к документам Aborter, чтобы получить дополнительные примеры об отмене запроса.

zoom

number

Уровень масштаба для нужной плитки. Значение масштаба должно находиться в диапазоне от 0 до 18 (включительно).

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

xTileIndex

number

Координата X плитки на сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

yTileIndex

number

Координата Y плитки на сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

Возвращаемое значение

Promise<GetMapImageryTileResponse>

getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Возвращает плитки карты в векторном или растровом формате, которые обычно необходимо интегрировать в новый элемент управления картой или пакет SDK. По умолчанию Azure использует плитки векторной карты для своего элемента управления веб-картой (см. статью Уровни масштабирования и сетка плиток). Использует API получения фрагментов карты: https://docs.microsoft.com/rest/api/maps/render/getmaptile

function getMapTile(aborter: Aborter, format: TileFormat, layer: MapTileLayer, style: MapTileStyle, zoom: number, xTileIndex: number, yTileIndex: number, options?: GetMapTileOptions): Promise<GetMapTileResponse>

Параметры

aborter
Aborter

Создайте новый экземпляр Aborter с помощью Aborter.none или Aborter.timeout(), перейдите к документам Aborter, чтобы получить дополнительные примеры об отмене запроса.

format
TileFormat

Требуемый формат ответа. Возможные значения: png & pbf. Возможные значения: "png", "pbf"

layer
MapTileLayer

Запрошен слой карты. Возможные значения: basic, hybrid, labels и terra. Возможные значения: basic, hybrid, labels, terra.

style
MapTileStyle

Возвращаемый стиль карты. Возможные значения: main & shaded_relief. Возможные значения: "main", "shaded_relief".

zoom

number

Уровень масштаба для нужной плитки. Для растровых плиток значение должно находиться в диапазоне от 0 до 18 (включительно). Растровые плитки Terra, значения должны находиться в диапазоне от 0 до 6 (включительно). Для векторных плиток значение должно находиться в диапазоне от 0 до 22 (включительно).

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

xTileIndex

number

Координата X плитки на сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

yTileIndex

number

Координата Y плитки на сетке масштабирования. Значение должно находиться в диапазоне [0, 2zoom -1].

Дополнительные сведения см. в разделе Уровни масштабирования и сетка плиток .

options
GetMapTileOptions

Возвращаемое значение

Promise<GetMapTileResponse>

Сведения о наследуемом методе

newPipeline(Credential, INewPipelineOptions)

Статический метод, используемый для создания нового объекта Pipeline с предоставленными учетными данными.

static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline

Параметры

credential
Credential

Например, SubscriptionKeyCredential, TokenCredential и MapControlCredential.

pipelineOptions
INewPipelineOptions

Возвращаемое значение

Pipeline

Новый объект Pipeline.

Наследуется отMapsURL.newPipeline