RenderURL class

  • Referenz
Paket:
azure-maps-rest

Eine RenderURL stellt eine URL für die Azure Maps Rendervorgänge dar.

Extends
MapsURL

Konstruktoren

RenderURL(Pipeline, string)

Erstellt eine instance von RenderURL.

Geerbte Eigenschaften

mapsUrl

Basis-URL-Zeichenfolgenwert.

Methoden

getMapImage(Aborter, GetMapImageOptions)

Rendert ein benutzerdefiniertes, rechteckiges Bild, das einen Kartenabschnitt enthält, mit einem Zoomfaktor von 0 bis 20. Der Dienst für statische Bilder rendert ein benutzerdefiniertes, rechteckiges Bild, das einen Kartenabschnitt enthält, mithilfe eines Zoomfaktors von 0 bis 20. Der unterstützte Auflösungsbereich für das Kartenbild liegt zwischen 1x1 und 8192 x 8192. Wenn Sie entscheiden, wann sie den Dienst für statische Bilder über den Kartenkacheldienst verwenden, sollten Sie überlegen, wie Sie mit der gerenderten Karte interagieren möchten. Wenn der Karteninhalt relativ unveränderlich ist, ist eine statische Karte eine gute Wahl. Wenn Sie viel Zoomen, Schwenken und Ändern des Karteninhalts unterstützen möchten, wäre der Kartenkacheldienst die bessere Wahl. Der Dienst bietet auch Bildkompositionsfunktionen, um ein statisches Bild mit zusätzlichen Daten wie zu erhalten. Pushpins und Geometrieüberlagerungen mit folgenden S0- und S1-Funktionen.

In S0 haben Sie folgende Möglichkeiten:

  • Rendern von bis zu 5 In der Anforderung angegebenen Pins
  • Geben Sie ein benutzerdefiniertes Image für die In der Anforderung referenzierten Pins an.
  • Hinzufügen von Bezeichnungen zu den Pins

In S1 haben Sie folgende Möglichkeiten:

Ausführliche Beispiele finden Sie unter Anleitung .

Hinweis : Der Center - oder bbox-Parameter muss für die API angegeben werden.

Die unterstützten Lat- und Lon-Bereiche bei Verwendung des bbox-Parameters sind wie folgt:

Zoomfaktor Max. Lon-Bereich Max. Lat-Bereich
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

Verwendet die API zum Abrufen von Kartenbildern: https://docs.microsoft.com/rest/api/maps/render/getmapimage
getMapImageryTile(Aborter, number, number, number)

Gibt eine Kartenbildkachel mit der Größe 256 x 256 zurück, wenn die x- und y-Koordinaten und der Zoomfaktor angegeben sind. Der Zoomfaktor reicht von 0 bis 18. Der derzeit verfügbare Stilwert ist "Satellite", der nur Satellitenbilder bereitstellt. Verwendet die API zum Abrufen von Kartenbilderkacheln: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile
getMapTile(Aborter, TileFormat, MapTileLayer, MapTileStyle, number, number, number, GetMapTileOptions)

Gibt kartenkacheln im Vektor- oder Rasterformat zurück, die in der Regel in ein neues Kartensteuerelement oder SDK integriert werden sollen. Standardmäßig verwendet Azure Vektorkartenkacheln für das Webkartensteuerelement (siehe Zoomstufen und Kachelraster). Verwendet die API zum Abrufen von Kartenkacheln: https://docs.microsoft.com/rest/api/maps/render/getmaptile

Geerbte Methoden

newPipeline(Credential, INewPipelineOptions)

Eine statische Methode zum Erstellen eines neuen Pipelineobjekts mit bereitgestellten Anmeldeinformationen.

Details zum Konstruktor

RenderURL(Pipeline, string)

Erstellt eine instance von RenderURL.

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

Parameter

pipeline
Pipeline

Rufen Sie MapsURL.newPipeline() auf, um eine Standardpipeline zu erstellen oder eine angepasste Pipeline bereitzustellen.

mapsUrl

string

Eine URL-Zeichenfolge, die auf Azure Maps Dienst zeigt. Der Standardwert ist "https://atlas.microsoft.com". Wenn kein Protokoll angegeben wird, z. B. "atlas.microsoft.com", https wird angenommen.

Geerbte Eigenschaftsdetails

mapsUrl

Basis-URL-Zeichenfolgenwert.

mapsUrl: string

Eigenschaftswert

string

Geerbt vonMapsURL.mapsUrl

Details zur Methode

getMapImage(Aborter, GetMapImageOptions)

Rendert ein benutzerdefiniertes, rechteckiges Bild, das einen Kartenabschnitt enthält, mit einem Zoomfaktor von 0 bis 20. Der Dienst für statische Bilder rendert ein benutzerdefiniertes, rechteckiges Bild, das einen Kartenabschnitt enthält, mithilfe eines Zoomfaktors von 0 bis 20. Der unterstützte Auflösungsbereich für das Kartenbild liegt zwischen 1x1 und 8192 x 8192. Wenn Sie entscheiden, wann sie den Dienst für statische Bilder über den Kartenkacheldienst verwenden, sollten Sie überlegen, wie Sie mit der gerenderten Karte interagieren möchten. Wenn der Karteninhalt relativ unveränderlich ist, ist eine statische Karte eine gute Wahl. Wenn Sie viel Zoomen, Schwenken und Ändern des Karteninhalts unterstützen möchten, wäre der Kartenkacheldienst die bessere Wahl. Der Dienst bietet auch Bildkompositionsfunktionen, um ein statisches Bild mit zusätzlichen Daten wie zu erhalten. Pushpins und Geometrieüberlagerungen mit folgenden S0- und S1-Funktionen.

In S0 haben Sie folgende Möglichkeiten:

  • Rendern von bis zu 5 In der Anforderung angegebenen Pins
  • Geben Sie ein benutzerdefiniertes Image für die In der Anforderung referenzierten Pins an.
  • Hinzufügen von Bezeichnungen zu den Pins

In S1 haben Sie folgende Möglichkeiten:

Ausführliche Beispiele finden Sie unter Anleitung .

Hinweis : Der Center - oder bbox-Parameter muss für die API angegeben werden.

Die unterstützten Lat- und Lon-Bereiche bei Verwendung des bbox-Parameters sind wie folgt:

Zoomfaktor Max. Lon-Bereich Max. Lat-Bereich
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

Verwendet die API zum Abrufen von Kartenbildern: https://docs.microsoft.com/rest/api/maps/render/getmapimage

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

Parameter

aborter
Aborter

Erstellen Sie eine neue Aborter-instance mit Aborter.none oder Aborter.timeout(). Weitere Beispiele zum Abbrechen von Anforderungen erhalten Sie in den Dokumenten von Aborter.

options
GetMapImageOptions

Gibt zurück

Promise<GetMapImageResponse>

getMapImageryTile(Aborter, number, number, number)

Gibt eine Kartenbildkachel mit der Größe 256 x 256 zurück, wenn die x- und y-Koordinaten und der Zoomfaktor angegeben sind. Der Zoomfaktor reicht von 0 bis 18. Der derzeit verfügbare Stilwert ist "Satellite", der nur Satellitenbilder bereitstellt. Verwendet die API zum Abrufen von Kartenbilderkacheln: https://docs.microsoft.com/rest/api/maps/render/getmapimagerytile

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

Parameter

aborter
Aborter

Erstellen Sie eine neue Aborter-instance mit Aborter.none oder Aborter.timeout(), wechseln Sie zu Dokumenten von Aborter, um weitere Beispiele zum Abbrechen von Anforderungen zu erhalten.

zoom

number

Zoomstufe für die gewünschte Kachel. Der Zoomwert muss im Bereich 0-18 (einschließlich) liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

xTileIndex

number

X-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

yTileIndex

number

Y-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

Gibt zurück

Promise<GetMapImageryTileResponse>

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

Gibt kartenkacheln im Vektor- oder Rasterformat zurück, die in der Regel in ein neues Kartensteuerelement oder SDK integriert werden sollen. Standardmäßig verwendet Azure Vektorkartenkacheln für das Webkartensteuerelement (siehe Zoomstufen und Kachelraster). Verwendet die API zum Abrufen von Kartenkacheln: 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>

Parameter

aborter
Aborter

Erstellen Sie eine neue Aborter-instance mit Aborter.none oder Aborter.timeout(), wechseln Sie zu Dokumenten von Aborter, um weitere Beispiele zum Abbrechen von Anforderungen zu erhalten.

format
TileFormat

Gewünschtes Format der Antwort. Mögliche Werte sind png & pbf. Mögliche Werte: "png", "pbf"

layer
MapTileLayer

Kartenebene angefordert. Mögliche Werte sind basic, hybrid, labels und terra. Mögliche Werte: "basic", "hybrid", "labels", "terra"

style
MapTileStyle

Zurückzugebende Kartenformat Mögliche Werte werden Standard & shaded_relief. Mögliche Werte: "Standard", "shaded_relief"

zoom

number

Zoomstufe für die gewünschte Kachel. Für Rasterkacheln muss der Wert im Bereich 0-18 (einschließlich) liegen. Terra-Rasterkacheln, Werte müssen im Bereich 0-6 (einschließlich) liegen. Für Vektorkacheln muss der Wert im Bereich 0-22 (inklusive) liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

xTileIndex

number

X-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

yTileIndex

number

Y-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen.

Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

options
GetMapTileOptions

Gibt zurück

Promise<GetMapTileResponse>

Details zur geerbten Methode

newPipeline(Credential, INewPipelineOptions)

Eine statische Methode zum Erstellen eines neuen Pipelineobjekts mit bereitgestellten Anmeldeinformationen.

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

Parameter

credential
Credential

Beispielsweise SubscriptionKeyCredential, TokenCredential und MapControlCredential.

pipelineOptions
INewPipelineOptions

Gibt zurück

Pipeline

Ein neues Pipelineobjekt.

Geerbt vonMapsURL.newPipeline