Sdílet prostřednictvím

RenderURL class

  • Reference
Balíček:
azure-maps-rest

Adresa RenderURL představuje adresu URL pro operace vykreslování Azure Maps.

Extends
MapsURL

Konstruktory

RenderURL(Pipeline, string)

Vytvoří instanci RenderURL.

Zděděné vlastnosti

mapsUrl

Hodnota základního řetězce adresy URL

Metody

getMapImage(Aborter, GetMapImageOptions)

Vykreslí uživatelem definovaný obdélníkový obrázek obsahující část mapy pomocí úrovně přiblížení od 0 do 20. Služba statického obrázku vykresluje uživatelem definovaný obdélníkový obrázek obsahující oddíl mapy pomocí úrovně přiblížení od 0 do 20. Podporovaný rozsah rozlišení obrázku mapy je 1x1 až 8192x8192. Pokud se rozhodujete, kdy použít službu statických obrázků přes službu mapových dlaždic, měli byste zvážit, jak chcete s vykreslenou mapou pracovat. Pokud bude obsah mapy relativně neměnný, je statická mapa dobrou volbou. Pokud chcete podporovat hodně přiblížení, posouvání a změny obsahu mapy, bude lepší volbou služba mapových dlaždic. Služba také poskytuje funkci Image Composition pro získání statického obrázku zpět s dalšími daty, jako jsou: připínáky a překryvy geometrie s následujícími funkcemi S0 a S1.

V S0 můžete:

  • Vykreslení až 5 připínáčků zadaných v požadavku
  • Zadejte jednu vlastní image pro špendlíky, na které se odkazuje v požadavku.
  • Přidání popisků k připínáčkům

V S1 můžete:

Podrobné příklady najdete v návodu .

Poznámka : Rozhraní API musí být zadán parametr center nebo bbox .

Podporované rozsahy Lat a Lon při použití parametru bbox jsou následující:

Úroveň přiblížení Max Lon Range Maximální rozsah lat
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

Používá rozhraní API Pro získání obrázků map: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

Vrátí dlaždici s obrázkem mapy o velikosti 256 × 256 s ohledem na souřadnice x a y a úroveň přiblížení. Rozsahy úrovně přiblížení od 0 do 18. Aktuální dostupná hodnota stylu je "satelitní", která poskytuje pouze satelitní snímky. Používá rozhraní API Pro získání dlaždic mapových obrázků: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Vrátí dlaždice mapy ve vektorovém nebo rastrovém formátu, které mají být obvykle integrovány do nového mapového ovládacího prvku nebo sady SDK. Azure ve výchozím nastavení používá pro svůj ovládací prvek webové mapy dlaždice vektorové mapy (viz Úrovně přiblížení a Mřížka dlaždic). Používá rozhraní API Získat dlaždici mapy: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Zděděné metody

newPipeline(Credential, INewPipelineOptions)

Statická metoda používaná k vytvoření nového objektu pipeline se zadanými přihlašovacími údaji.

Podrobnosti konstruktoru

RenderURL(Pipeline, string)

Vytvoří instanci RenderURL.

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

Parametry

pipeline
Pipeline

Zavolejte MapsURL.newPipeline() a vytvořte výchozí kanál nebo poskytněte vlastní kanál.

mapsUrl

string

Řetězec adresy URL odkazující na službu Azure Maps, výchozí hodnota je "https://atlas.microsoft.com". Pokud není zadaný žádný protokol, například "atlas.microsoft.com", https bude se předpokládat.

Podrobnosti zděděných vlastností

mapsUrl

Hodnota základního řetězce adresy URL

mapsUrl: string

Hodnota vlastnosti

string

Zděděno zmapsURL.mapsUrl

Podrobnosti metody

getMapImage(Aborter, GetMapImageOptions)

Vykreslí uživatelem definovaný obdélníkový obrázek obsahující část mapy pomocí úrovně přiblížení od 0 do 20. Služba statického obrázku vykresluje uživatelem definovaný obdélníkový obrázek obsahující oddíl mapy pomocí úrovně přiblížení od 0 do 20. Podporovaný rozsah rozlišení obrázku mapy je 1x1 až 8192x8192. Pokud se rozhodujete, kdy použít službu statických obrázků přes službu mapových dlaždic, měli byste zvážit, jak chcete s vykreslenou mapou pracovat. Pokud bude obsah mapy relativně neměnný, je statická mapa dobrou volbou. Pokud chcete podporovat hodně přiblížení, posouvání a změny obsahu mapy, bude lepší volbou služba mapových dlaždic. Služba také poskytuje funkci Image Composition pro získání statického obrázku zpět s dalšími daty, jako jsou: připínáky a překryvy geometrie s následujícími funkcemi S0 a S1.

V S0 můžete:

  • Vykreslení až 5 připínáčků zadaných v požadavku
  • Zadejte jednu vlastní image pro špendlíky, na které se odkazuje v požadavku.
  • Přidání popisků k připínáčkům

V S1 můžete:

Podrobné příklady najdete v návodu .

Poznámka : Rozhraní API musí být zadán parametr center nebo bbox .

Podporované rozsahy Lat a Lon při použití parametru bbox jsou následující:

Úroveň přiblížení Max Lon Range Maximální rozsah lat
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

Používá rozhraní API Pro získání obrázků map: https://docs.microsoft.com/rest/api/maps/render/getmapimage

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

Parametry

aborter
Aborter

Vytvořte novou instanci Aborter pomocí Aborter.none nebo Aborter.timeout(), další příklady zrušení požadavku najdete v dokumentech Aborter.

options
GetMapImageOptions

Návraty

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

Vrátí dlaždici s obrázkem mapy o velikosti 256 × 256 s ohledem na souřadnice x a y a úroveň přiblížení. Rozsahy úrovně přiblížení od 0 do 18. Aktuální dostupná hodnota stylu je "satelitní", která poskytuje pouze satelitní snímky. Používá rozhraní API Pro získání dlaždic mapových obrázků: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

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

Parametry

aborter
Aborter

Vytvořte novou instanci Aborter pomocí Aborter.none nebo Aborter.timeout(), další příklady zrušení požadavku najdete v dokumentech Aborter.

zoom

number

Úroveň přiblížení pro požadovanou dlaždici Hodnota přiblížení musí být v rozsahu 0–18 (včetně).

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

xTileIndex

number

Souřadnice X dlaždice v mřížce přiblížení. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

yTileIndex

number

Souřadnice Y dlaždice v mřížce lupy. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

Návraty

Promise<GetMapImageryTileResponse>

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

Vrátí dlaždice mapy ve vektorovém nebo rastrovém formátu, které mají být obvykle integrovány do nového mapového ovládacího prvku nebo sady SDK. Azure ve výchozím nastavení používá pro svůj ovládací prvek webové mapy dlaždice vektorové mapy (viz Úrovně přiblížení a Mřížka dlaždic). Používá rozhraní API Získat dlaždici mapy: 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>

Parametry

aborter
Aborter

Vytvořte novou instanci Aborter pomocí Aborter.none nebo Aborter.timeout(), další příklady zrušení požadavku najdete v dokumentech Aborter.

format
TileFormat

Požadovaný formát odpovědi Možné hodnoty jsou png & pbf. Možné hodnoty: 'png', 'pbf'

layer
MapTileLayer

Byla požadována vrstva mapy. Možné hodnoty jsou basic, hybrid, labels a terra. Mezi možné hodnoty patří: 'basic', 'hybrid', 'labels', 'terra'

style
MapTileStyle

Styl mapování, který se má vrátit. Možné hodnoty jsou hlavní & shaded_relief. Mezi možné hodnoty patří main, shaded_relief.

zoom

number

Úroveň přiblížení pro požadovanou dlaždici U rastrových dlaždic musí být hodnota v rozsahu 0–18 (včetně). Rastrové dlaždice Terra, hodnoty musí být v rozsahu 0–6 (včetně). U vektorových dlaždic musí být hodnota v rozsahu 0–22 (včetně).

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

xTileIndex

number

Souřadnice X dlaždice v mřížce přiblížení. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

yTileIndex

number

Souřadnice Y dlaždice v mřížce lupy. Hodnota musí být v rozsahu [0, 2zoom -1].

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

options
GetMapTileOptions

Návraty

Promise<GetMapTileResponse>

Podrobnosti zděděných metod

newPipeline(Credential, INewPipelineOptions)

Statická metoda používaná k vytvoření nového objektu pipeline se zadanými přihlašovacími údaji.

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

Parametry

credential
Credential

Například SubscriptionKeyCredential, TokenCredential a MapControlCredential.

pipelineOptions
INewPipelineOptions

Návraty

Pipeline

Nový objekt kanálu.

Zděděno zMapsURL.newPipeline