- Artikel
Verwenden Sie die folgenden URL-Vorlagen, um eine statische Karte zu erhalten. Sie können eine Route auch auf einer statischen Karte anzeigen und statische Kartenmetadaten anfordern. Zu den statischen Kartenmetadaten gehören die absoluten (Breiten- und Längengrad) und relativen (in Bezug auf die Karte) Koordinaten und die Größe von Stecknadeln sowie den Kartenbereich und den Mittelpunkt.
Die Standardkartengröße beträgt 350 x 350 Pixel.
Spitze
Statische Kartenmetadaten: Um die Größe und den Mittelpunkt des Bildes sowie die Positionen und die Größe der Stecknadeln auf der Karte zu erhalten, legen Sie festKartenmetadaten
Parameter zu1
(WAHR). Wenn Sie statische Kartenmetadaten anfordern, werden die Metadaten anstelle des Kartenbilds zurückgegeben.
URL-Vorlagen
Notiz
Diese Vorlagen unterstützen sowohl HTTP- als auch HTTPS-Protokolle.
Erhalten Sie eine Karte, die an einem bestimmten Punkt zentriert ist
Wenn Sie einen Mittelpunkt angeben, müssen Sie auch eine Zoomstufe angeben.
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet/centerPoint/zoomLevel?mapSize={mapSize}&pushpin={pushpin}&mapLayer={mapLayer}&format={format}&mapMetadata={mapMetadata}&key ={BingMapsKey}
Holen Sie sich eine Karte, die einen bestimmten Kartenbereich zeigt
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet?mapArea={mapArea}&mapSize={mapSize}&pushpin={pushpin}&mapLayer={mapLayer}&format={format}&mapMetadata=mapMetadata}&key ={BingMapsKey}
Erhalten Sie eine Karte mit Stecknadeln, die keinen Mittelpunkt oder Kartenbereich angeben
Wenn Sie keinen Mittelpunkt oder Kartenbereich angeben, wird der Kartenbereich ausgewählt, um die Anzeige der Stecknadeln zu optimieren.
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet?pushpin={pushpin_1}&pushpin={pushpin_2}&pushpin={pushpin_n}&mapLayer={mapLayer}&format={format}&mapMetadata={mapMetadata} &key={BingMapsKey}
Rufen Sie eine Karte ab, die auf den angegebenen Punkt zentriert ist und eine Route anzeigt
Sie können eine Route auf einer Karte anzeigen, indem Sie eine Reihe von Wegpunkten angeben.
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet/centerPoint/zoomLevel/Routes/travelMode?waypoint.1={routeWaypoint1}&waypoint.2={routeWaypoint2}&waypoint.n={routeWaypointn}&mapSize ={mapSize}&avoid={avoidOptions}&pushpin={pushpin}&timeType={timetType}&dateTime={dateTime}&maxSolutions={maxSolutions}&distanceBeforeFirstTurn={distanceBeforeFirstTurn}&mapLayer={mapLayer}&format={format}&mapMetadata={mapMetadata}&key ={BingMapsKey}
Erhalten Sie eine Karte, die eine Route ohne Angabe eines Mittelpunkts anzeigt. Sie können den Kartenbereich angeben oder die Standardeinstellung übernehmen
Sie können eine Route auf einer Karte anzeigen, indem Sie eine Reihe von Wegpunkten angeben. Wenn kein Kartenbereich oder Mittelpunkt und keine Zoomstufe angegeben sind, wird ein Kartenbereich ausgewählt, um die Anzeige der Route zu optimieren.
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet/Routes/travelMode?waypoint.1={routeWaypoint1}&waypoint.2={routeWaypoint2}&waypoint.n={routeWaypointn}&mapArea={mapArea} &avoid={avoidOptions}&pushpin={pushpin}&timeType={timeType}&dateTime={dateTime}&maxSolutions={maxSolutions}&distanceBeforeFirstTurn={distanceBeforeFirstTurn}&mapLayer={mapLayer}&format={format}&mapMetadata={mapMetadata}&key={BingMapsKey}
Rufen Sie eine Karte ab, die auf einer Abfrage basiert
Rufen Sie eine Karte basierend auf der angegebenen Abfrage ab.
https://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet/query?mapSize={mapSize}&mapLayer={mapLayer}&format={format}&mapMetadata={mapMetadata}&key={BingMapsKey}
Erhalten Sie Streetside-Bilder an einem bestimmten Punkt
Rufen Sie ein Straßenbild zu einem bestimmten Zeitpunkt abMittelpunkt
unter Verwendung der ParameterzoomLevel
,Überschrift
, UndTonhöhe
. DerÜberschrift
Der Parameter gibt die Richtung von 0° bis 360° an, wobei 0° nach Norden zeigt, undTonhöhe
Gibt den Winkel von -90° (direkt nach unten gerichtet) bis 90° (direkt nach oben gerichtet) an, in dem das zurückgegebene Bild positioniert ist.
Entweder verwenden Sie astrukturiertURL:
https://dev.virtualearth.net/REST/V1/Imagery/Map/Streetside/{centerPoint}/{zoomLevel}?heading={heading}&pitch={pitch}&key={BingMapsKey}
Oder verwenden Sie eineunstrukturiertURL:
https://dev.virtualearth.net/REST/V1/Imagery/Map/Streetside/{centerPoint}?zoomLevel={zoomLevel}&heading={heading}&pitch={pitch}&key={BingMapsKey}
Holen Sie sich Streetside-Bilder an einer angegebenen Adresse
Rufen Sie ein Straßenbild an einer angegebenen Adresse ab.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Streetside/{address}?zoomlevel=0&key={BingMapsKey}
Wenn für diese Adresse keine Streetside-Bilder verfügbar sind oder wenn der REST Locations-Aufruf dafür nicht sowohl Dach- als auch routbare Koordinaten (Verwendungstyp: Route) enthält, wird der Fehler 404 „Nicht gefunden“ zurückgegeben.
Zeichnen Sie Linien, Polygone, Kreise und Kurven auf statischen Karten
Rufen Sie mithilfe einer der oben genannten URL-Vorlagen eine statische Karte mit einer auf dem Bild gezeichneten Form ab, indem Sie Folgendes angebendrawCurve
Parameter.
Die Syntax für diesen Parameter lautet:drawCurve=
.
Beschreibungen und die Syntax fürFormtyp
,Stiltyp
, UndKoordinaten
sind unten.
Geben Sie Wert ein | Name | Beschreibung |
---|---|---|
l | Linie | Zeichnen Sie eine Linie auf der Karte. |
P | Polygon | Zeichnen Sie ein Polygon auf der Karte. |
C | Kreis | Zeichnen Sie einen Kreis mit dem angegebenen Radius auf der Karte. |
Lebenslauf | Kurve | Zeichnen Sie eine geschwungene Linie auf der Karte. |
Stiltyp | Format | Beschreibung |
---|---|---|
Linie(l ) oder Kurve(Lebenslauf ) | [Linienfarbe],[Linienstärke] | Die Linienfarbe nimmt hexadezimale ARGB-Farbwerte an, z. B.FFFF5064 und die Linienstärke ist eine positive ganze Zahl, z. B2 , mit Einheiten in Pixel.Beispiel: |
Polygon(P ) | [Umrissfarbe],[Füllfarbe],[Umrissstärke] | Umriss- und Füllfarben werden in ARGB mit Hexadezimalwerten formatiert, während die Umrissstärke eine Ganzzahl mit Einheiten in Pixeln ist. Beispiel: |
Kreis(C ) | [Farbe der Umrisslinie] ,[Füllfarbe] ,[Umrissdicke] ,[Kreisradius] | Umriss- und Füllfarbe werden in ARGB mit Hexadezimalwerten formatiert, während die Umrissstärke eine ganze Zahl mit Einheiten in Pixeln ist und der Kreisradius des Kreises in Pixeln angegeben wird. Beispiel: |
Von der angegebene KoordinatendrawCurve
Parameter sind optional, aber wenn sie angegeben werden, müssen sie entweder im Nur-Text-Format oder im Base-64-codierten Format bereitgestellt werden:
Format | Syntax | Beispiel |
---|---|---|
Klartext | {latitude_1},{longitude_1}_{latitude_2},{longitude_2}, ..., {latitude_n},{longitude_n} | 37.428175,-122.16968_37.737368,-122.422845_37.869505,-122.2705 |
Basis 64 | enc:{codiertes Polylinienformat} | enc:aemcFngthVmk{@fmp@{xXcw\} Weitere Einzelheiten finden Sie imFormat des codierten Polylinienalgorithmus. |
Pushpin-Grenzwerte
Wenn Sie die HTTP-GET-Methode mit einer der folgenden URL-Vorlagen verwenden, können Sie bis zu 18 Pins in der URL angeben. Wenn Sie mehr als 18 Pushpins angeben möchten, verwenden Sie die HTTP-POST-Methode, um bis zu 100 Pushpins im Hauptteil der HTTP-POST-Anfrage anzugeben. Wenn Sie die HTTP-POST-Methode verwenden, müssen sich alle Pushpins im Hauptteil der Anfrage und nicht in der URL befinden. Sie müssen auch festlegenInhaltstyp
ZuText/einfach
und der Zeichensatz zuUTF-8
im HTTP-Header. Eine Beispielanforderung finden Sie unterBeispieleAbschnitt.
Vorlagenparameter
Notiz
Siehe dieAllgemeine Parameter und TypenAbschnitt für zusätzliche allgemeine Parameter zur Verwendung mit diesen URLs.
Zu den allgemeinen Parametern gehören:
- Ausgabeparameter: Enthält Antwortausgabetypen und die JSON-Rückrufparameter.
- Kulturparameter: Enthält eine Liste der unterstützten Kulturen.
- Benutzerkontextparameter: Enthält Parameter, die Benutzerstandort- und Ansichtsfensterwerte festlegen, um die Standortbestimmung zu erleichtern. Diese Werte können beispielsweise dabei helfen, eine Reihe möglicher Standorte zu priorisieren, wenn Sie eine Karte basierend auf einer Standortabfrage erhalten.
Bei Parameterwerten wird die Groß-/Kleinschreibung nicht beachtet.
Wenn ein Alias bereitgestellt wird, können Sie den Alias verwenden, um die Länge des Abfrageparameters zu verkürzen. Zum Beispiel,Reißzwecke=47,610,-122,107
kann verkürzt werden aufpp=47.610,-122.107
.
Kartenparameter
Parameter | Alias | Beschreibung | Werte |
---|---|---|---|
Mittelpunkt | Erforderlich.Ein Punkt auf der Erde, an dem die Karte zentriert ist. | Ein Punktwert (Breitengrad und Längengrad). Weitere Informationen zu Punktwerten finden Sie unterStandort- und Gebietstypen. Beispiel: | |
declutterPins | dcl | Optional.Gibt an, ob die Anzeige überlappender Stecknadeln geändert werden soll, sodass sie separat auf einer Karte angezeigt werden. | Einer der folgenden Werte: - Notiz: Diese Funktion wird nur unterstützt, wenn der Standard-Pinnnadelstil verwendet wird. Beispiele: - |
dpi | Optional.Gibt die Auflösung der Beschriftungen auf dem abzurufenden Bild an. | Einer der folgenden Werte: - Beispiel: | |
drawCurve | dv | Optional.Wird zum Einfügen von Linien, Kurven, Kreisen und Polygonen über ein Bild verwendet. | Siehe den AbschnittZeichnen Sie Linien, Polygone, Kreise und Kurven auf statischen KartenWeitere Informationen finden Sie oben. |
Format | fmt | Optional.Das für die statische Karte zu verwendende Bildformat. | Einer der folgenden Bildformatwerte: - Beispiele: - |
Überschrift | Optional, für Streetside. Gewünschte Kamerarichtung in Grad, im Uhrzeigersinn von Norden. | Gültige Werte des Typsdoppelt von 0 bis 360.Standard : | |
imagerySet | Erforderlich.Die Art der Bilder. | Einer der folgenden Werte: - | |
Kartenbereich | ma | Erforderlich, wenn kein Mittelpunkt oder Satz von Routenpunkten angegeben ist.Das auf der Karte anzuzeigende geografische Gebiet. | Ein rechteckiger Bereich, der als Begrenzungsrahmen angegeben wird. Weitere Informationen finden Sie unterStandort- und Gebietstypen. Beispiel: |
MapLayer | ml | Optional.Eine Anzeigeebene, die über dem Bildsatz gerendert wird. | -Grundkarte, Gebäude : Gebäude-Fußabdrücke. Diese Ebene ist nur beim Bildtyp „Straßenkarte“ sichtbar.- OrdnanceSurvey : Bilder der Ordnance Survey. Diese Ebene ist nur im Vereinigten Königreich sichtbar.- Verkehrsfluss : Verkehrsflussebene.Notiz:mapLayer wird für Bird's Eye-Bilder nicht unterstützt. Beispiel: |
Kartengröße | MS | Optional.Die Breite und Höhe der statischen Kartenausgabe in Pixel. | Eine Zeichenfolge, die eine durch Komma getrennte Breite und Höhe enthält. Die Breite muss zwischen 80 und 2000 Pixel und die Höhe zwischen 80 und 1500 Pixel liegen. Die Standardkartengröße für statische Karten beträgt 350 x 350 Pixel. Bei Straßenkarten ist die maximale Größe bei Verwendung eines Basiskontoschlüssels auf 400 x 400 Pixel begrenzt. Wenn eine größere Größe benötigt wird, benötigen Sie eineUnternehmensschlüssel. Beispiel: |
Kartenmetadaten | mmd | Optional. Gibt an, ob Metadaten für die statische Karte anstelle des Bildes zurückgegeben werden sollen. Zu den Metadaten der statischen Karte gehören die Größe der statischen Karte sowie die Platzierung und Größe der Pins auf der statischen Karte. | Einer der folgenden Werte: - Beispiel: |
Tonhöhe | Optional, für Streetside. Steuert den Neigungswinkel der Kamera. Positive Werte richten die Kamera nach oben in Richtung Himmel, negative Werte zeigen nach unten zum Boden. | Gültige Werte des Typsdoppelt In[-90, 90] . | |
Orientierung | dir | Optional, für Bird's Eye.Die Blickausrichtung für Bilder aus der Vogelperspektive. Diese Option gilt nur für Bilder aus der Vogelperspektive. | Ein Double-Wert zwischen 0 und 360, wobei 0 = Nord [Standard], 90 = Osten, 180 = Süden, 270 = Westen. Beispiel: |
Stecknadeln | S | Optional. Ein oder mehrere Stecknadelstandorte, die auf der Karte angezeigt werden sollen. | Eine Reihe von Werten, die einen Punktwert (Breitengrad und Längengrad) mit Optionen zum Hinzufügen einer Beschriftung mit bis zu drei (3) Zeichen und zum Festlegen eines Symbolstils umfassen. Weitere Informationen zum Angeben von Stecknadeln finden Sie unterPin-Syntax und Symbolstile. Sie können bis zu 18 Pushpins innerhalb einer URL angeben und 100, wenn Sie die HTTP-POST-Methode verwenden und die Pushpins im Hauptteil der Anfrage angeben. Siehe dieBeispieleAbschnitt für Beispiele. Beispiel: |
Anfrage | Erforderlich, wenn Route, Mittelpunkt oder Kartenbereich nicht angegeben sindEine Abfragezeichenfolge, die verwendet wird, um den anzuzeigenden Kartenstandort zu bestimmen. | Eine Zeichenfolge, die Abfragebegriffe für den Standort der statischen Karte enthält. Beispiel: | |
zoomLevel | Erforderlich.Die anzuzeigende Zoomstufe. | Eine ganze Zahl zwischen 0 und 20. Notiz:Einige Bilder sind möglicherweise nicht in allen Zoomstufen für alle Standorte verfügbar. Wenn an einem Standort keine Bilder verfügbar sind, wird eine Meldung zurückgegeben Beispiel: | |
Sichtfeld | fov | Optional, für Streetside. Gibt das horizontale Sichtfeld in Grad an, das im Bild angezeigt werden soll. Auf diese Weise können Sie die Zoomstufe des Bildes festlegen. In der Anfrage sollte entweder „fieldOfView“ oder „zoomLevel“ angegeben werden, nicht beides. | Eine ganze Zahl zwischen 15 und 120. Beispiel: |
HighlightEntity | Er | Hebt ein Polygon für ein Objekt hervor. | 1 : Hervorhebungspolygon ist aktiviert. |
Stil | st | Optional.Gibt einen benutzerdefinierten Kartenstil an, der auf die Straßenkarten angewendet werden soll. | SehenBenutzerdefinierte Kartenstile in Bing Maps. |
Routenparameter
Parameter | Alias | Beschreibung | Werte |
---|---|---|---|
vermeiden | Optional.Gibt die Straßentypen an, die minimiert oder vermieden werden sollen, wenn die Route für den Fahrmodus erstellt wird. | Eine durch Kommas getrennte Liste von Werten, die die Verwendung von Autobahnen und Mautstraßen in der Route einschränken. In den folgenden Definitionen gilt:Autobahn bezieht sich auch auf aAutobahn mit beschränktem Zugang .Wenn keine Werte angegeben werden, sind Autobahnen und Mautstraßen in der Route zulässig. - Notiz:Wenn Sie mehr als eine Option für einen Straßentyp angeben, wird die restriktivste Option verwendet. Wenn Sie beispielsweise den Parameter „Vermeiden“ auf „Beide“ setzen Beispiele: - - | |
distanceBeforeFirstTurn | dbft | Optional.Gibt die Entfernung an, bevor die erste Abbiegung in der Route zulässig ist. Diese Option gilt nur für den Fahrmodus. | Eine ganzzahlige Entfernung, angegeben in Metern. Verwenden Sie diesen Parameter, um sicherzustellen, dass das fahrende Fahrzeug genügend Abstand hat, um die erste Kurve zu fahren. Beispiele: - - |
Terminzeit | dt | Erforderlich, wenn der Reisemodus Transit ist.DerZeittyp Der Parameter identifiziert die gewünschte Transitzeit, z. B. Ankunftszeit oder Abfahrtszeit. Der Laufzeittyp wird durch die angegebenZeittyp Parameter. | Eine Zeichenfolge, die das Datum und die Uhrzeit im Format enthältTerminzeitWert. Informationen zu den String-Darstellungsoptionen fürTerminzeit Werte, sieheDateTime.Parse-Methode (String).Beispiele: - |
maxSolutions | maxSolns | Optional. Gibt die maximale Anzahl der zurückzugebenden Transitrouten an. | Eine Zeichenfolge, die einen ganzzahligen Wert enthält. Der Standardwert ist1 . Beispiel: Notiz:Dieser Parameter wird nur für den Reisemodus „Transit“ unterstützt. |
optimieren | optmz | Optional.Gibt an, welche Parameter zur Optimierung der Route auf der Karte verwendet werden sollen. | Einer der folgenden Werte: - Beispiel: |
Zeittyp | tt | Erforderlich, wenn der Reisemodus Transit ist. Gibt an, wie der durch den dateTime-Parameter angegebene Datums- und Laufzeitwert interpretiert werden soll. | Einer der folgenden Werte: - |
Reisemodus | Optional.Der Reisemodus für die Route. | Einer der folgenden Werte: - | |
Wegpunkt.n | wp.n | Erforderlich.Gibt zwei oder mehr Standorte an, die die Route definieren und in sequentieller Reihenfolge vorliegen. | Ein Wegpunkt kann als Punkt, Orientierungspunkt oder Adresse angegeben werden. Sie können optional einen Symbolstil festlegen und für jeden Wegpunkt eine Beschriftung mit bis zu drei (3) Zeichen hinzufügen. Eine Liste der Symbolstile finden Sie unterPin-Syntax und Symbolstile. Weitere Informationen zu Punktwerten finden Sie unterStandort- und Gebietstypen. Geben Sie Wegpunkte im folgenden Format an: Sie können maximal 25 Wegpunkte haben. Beispiele: - - - - Falscher Wegpunktsatz.Der folgende Wertesatz ist ungültig, da kein Wegpunkt vorhanden ist.2. |
Antwort
Statische Bilder werden in einem der folgenden Formate zurückgegeben. Sie können das Bildformat festlegen, indem Sie Folgendes festlegenFormat
Parameter. Standardbildformate und die entsprechenden Inhaltstypwerte, die in der Antwort zurückgegeben werden (z. BBild/PNG
) sind unten definiert.
PNG (
Bild/PNG
): Standardbildformat für Bilder von Collins Bart und Ordnance Survey.JPEG (
Bild/JPEG
): Standardbildformat für Straßen-, Luft- und Luftaufnahmen mit Beschriftungen.GIF (
Bild/Gif
)
Diese URLs unterstützen JSON (application/json
) und XML (application/xml
) Antwortformate. Standardmäßig wird eine JSON-Antwort bereitgestellt, es sei denn, Sie fordern eine XML-Ausgabe an, indem Sie festlegenAusgang
(Ö
) Parameter. Weitere Informationen finden Sie unterAusgabeparameter.
Spitze
Bei Verwendung des Aufrufs der Imagery-API fürStraßenseite
Maps, der AntwortheaderX-VE-SS-CatpureDate
enthält dieRFC 1123 Datums-/Uhrzeitstempelwann das Bild erstellt wurde. Dieselben Informationen können auch erhalten werden, indem derselbe Breiten- und Längengrad an übergeben wirdBildmetadaten-API.
Beispiele
Holen Sie sich eine Straßenkarte mit Gebäudegrundrissen
In diesem Beispiel wird eine Straßenkarte mit Gebäudegrundrissen zusammen mit einer Stecknadel basierend auf einem angegebenen Mittelpunkt bei Zoomstufe 18 erstellt.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.645523,-122.139059/18?mapSize=500,500&pp=47.645523,-122.139059;66&mapLayer=Basemap,Buildings&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie eine Karte mit Straßenbildern und Verkehrsfluss basierend auf einer Abfrage
In diesem Beispiel wird eine Karte mit Straßenbildern basierend auf dem Abfrageergebnis Bellevue, Washington, abgerufen. Auch der Verkehrsfluss ist in der Karte enthalten.
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/Bellevue%20Washington?mapLayer=TrafficFlow&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie eine Karte mit Luftbildern basierend auf einer Anfrage
In diesem Beispiel wird eine Karte mit Luftbildern und Beschriftungen basierend auf einem Abfrageergebnis für den Eiffelturm in Paris abgerufen. Die Karte hat eine Breite von 500 Pixel und eine Höhe von 400 Pixel.
https://dev.virtualearth.net/REST/v1/Imagery/Map/AerialWithLabels/eiffel%20tower?mapSize=500,400&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie eine Karte mit Straßenbildern und Stecknadeln, die auf einen bestimmten Punkt zentriert ist
In diesem Beispiel wird eine Karte mit Straßenbildern erstellt und Pins auf der Space Needle, dem Pacific Science Center und dem Olympic Sculpture Park in Seattle platziert. DerMittelpunkt
der Karte ist auf 47,619048 Grad Breite und -122,35384 Grad Länge eingestellt. DerzoomLevel
ist auf 15 eingestellt.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.619048,-122.35384/15?mapSize=500,500&pp=47.620495,-122.34931;21;AA&pp=47.619385,-122.351485;;AB&pp=47.61 6295 ,-122.3556;22&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Rufen Sie die statischen Kartenmetadaten für eine Karte mit Straßenbildern und Stecknadeln ab, die an einem bestimmten Punkt zentriert ist
In diesem Beispiel werden dieselben Kartenparameter wie im vorherigen Beispiel angegeben und der Parameter „mapMetadata“ hinzugefügt, um die Kartenmetadaten abzurufen. Zu den Kartenmetadaten gehören die Kartengröße, die Fläche und der Mittelpunkt sowie die Position und Größe der Stecknadeln. Informationen zu den XML- und JSON-Antworten für diese Anfrage sowie Beschreibungen der Metadateninformationen finden Sie unterStatische Kartendaten.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.619048,-122.35384/15?mapSize=500,500&pp=47.620495,-122.34931;21;AA&pp=47.619385,-122.351485;;AB&pp=47.61 6295 ,-122.3556;22&mapMetadata=1&o=xml&key={BingMapsKey}
Holen Sie sich eine Karte mit Straßenbildern und entfernen Sie überlappende Stecknadeln
In diesem Beispiel wird eine Karte mit Straßenbildern erstellt und zwei Pins angegeben, die sehr nahe beieinander liegen. DerdeclutterPins
(dcl
)-Parameter ist so eingestellt, dass beide Pins separat angezeigt werden. Wenn diedeclutterPins
Wenn der Parameter nicht festgelegt wurde, würden sich die Pins überlappen. Karten für beide Fälle sind unten dargestellt.
https://dev.virtualearth.net/rest/v1/imagery/map/road/47.6156352,-122.2043549/12?PP=47.6156352,-122.2043549;
Dieses Beispiel gibt das folgende Bild zurück.
Wenn der Declutter-Parameter in diesem Beispiel nicht festgelegt wäre, würden sich die Pins überlappen, wie in der folgenden Abbildung dargestellt.
Erhalten Sie eine Karte mit Luftbildern und Stecknadeln, ohne einen Kartenbereich oder Mittelpunkt anzugeben
In diesem Beispiel wird eine Karte mit Luftbildern mit Beschriftungen erstellt und 5 Stecknadeln angegeben. Da kein Kartenbereich oder Mittelpunkt angegeben ist, wird ein Kartenbereich ausgewählt, der alle Stecknadeln am besten anzeigt. Die Karte ist so optimiert, dass sie zu den Pins passt.
https://dev.virtualearth.net/REST/v1/Imagery/Map/AerialWithLabels?pp=40.804000,-74.464460;;1&pp=40.815180,-74.219250;;2&pp=40.881210,-74.168020;;3&pp=40.810830,-7 4.260250 ;;4&pp=40.851800,-74.299900;;5&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Rufen Sie eine Karte mit Straßenbildern für einen bestimmten Kartenbereich ab
In diesem Beispiel wird eine Karte des angegebenen Gebiets abgerufen, die Straßenbilder mit Verkehrsfluss zeigt. Die Karte zeigt die Metropolregion San Francisco und Stecknadeln markieren den Standort der Stanford University und der University of California in Berkeley.
https://dev.virtualearth.net/REST/V1/Imagery/Map/road?mapArea=37.317227,-122.318439,37.939081,-122.194565&ms=500,600&pp=37.869505,-122.2705;35;BK&pp=37.42817 5,-122.169680; ;ST&ml=TrafficFlow&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Holen Sie sich eine Karte mit Straßenbildern, die eine Route anzeigt
In diesem Beispiel wird eine Karte mit Straßenbildern erstellt, die eine Fahrtroute zwischen den Städten Seattle und Redmond im US-Bundesstaat Washington anzeigt. Die benutzerdefinierten Symbole 64 und 66 werden ausgewählt, um die Endpunkte anzuzeigen, die als „1“ und „2“ gekennzeichnet sind.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/Routes?wp.0=Seattle,WA;64;1&wp.1=Redmond,WA;66;2&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie eine Karte mit Straßenbildern, die an einem Punkt mit einer angegebenen Zoomstufe zentriert sind
In diesem Beispiel werden ein Mittelpunkt und eine Zoomstufe verwendet, um eine Karte zu erhalten, die das Ende der Route zwischen Seattle und Redmond aus dem vorherigen Beispiel zeigt. Der Mittelpunkt sind die Breiten- und Längenkoordinaten von Redmond. Du kannst den ... benutzenFinden Sie einen Standort anhand der AdresseAPI zum Abrufen der Breiten- und Längenkoordinaten eines Standorts.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.678559869527817,-122.13099449872971/14/Routes? wp.0=Seattle,WA;64;1&wp.1=Redmond,WA;66;2&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie Karten mit Straßenbildern, die eine Transitroute und vergrößerte Ansichten der Start- und Endpunkte anzeigen
Die folgenden Beispiele zeigen, wie Sie eine Karte mit Straßenbildern erhalten, die eine Transitroute von der Space Needle in Seattle, Washington, zum Bellevue Downtown Park in Bellevue, Washington, um 15:00 Uhr des aktuellen Tages anzeigt. Die drei URL-Beispiele zeigen die gesamte Route und vergrößerte Ansichten der Start- und Endpunkte der Route. Beachten Sie, dass die Wanderabschnitte der Route als gepunktete Linien angezeigt werden.
Ansicht der kompletten Transitstrecke.
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/Routes/Transit?wp.0=Space%20Needle&wp.1=Bellevue%20Downtown%20Park&timeType=Departure&dateTime=3:00:00PM&output=xml&key= {BingMapsKey}
Zeigen Sie den Beginn der Transitroute an, indem Sie einen Mittelpunkt und eine Zoomstufe angeben. Der Mittelpunkt dieser Karte sind die Koordinaten für die Space Needle, die in der Antwort zurückgegeben werden, wenn Sie mithilfe von c eine Transitroute anfordernBerechnen Sie eine RouteAPI. Diese Karte enthält eine Wanderroute, die durch eine gepunktete Linie dargestellt ist.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.620495,-122.34931/15/Routes/Transit?timeType=Departure&dateTime=3:00:00PM&wp.0=Space%20Needle&wp.1=Bellevue %20Downtown%20Park&key={BingMapsKey}
Zeigen Sie das Ende der Transitroute an, indem Sie einen Mittelpunkt und eine Zoomstufe angeben. Der Mittelpunkt dieser Karte sind die Koordinaten des Bellevue Downtown Park in, die in der Antwort zurückgegeben werden, wenn Sie mithilfe von eine Transitroute anfordernBerechnen Sie eine RouteAPI. Diese Karte enthält eine Wanderroute, die durch eine gepunktete Linie dargestellt ist.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.615635,-122.20435/15/Routes/Transit?timeType=Departure&dateTime=3:00:00PM&wp.0=Space%20Needle&wp.1=Bellevue %20Downtown%20Park&key={BingMapsKey}
Holen Sie sich eine Bird's Eye-Karte
In diesem Beispiel wird eine Vogelperspektivenkarte mit Westausrichtung (Richtung = 270) bei Zoomstufe 20 erstellt. Die Karte hat eine Breite von 900 Pixel und eine Höhe von 700 Pixel.
https://dev.virtualearth.net/REST/V1/Imagery/Map/Birdseye/37.802297,-122.405844/20?dir=270&ms=900,700&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Erhalten Sie Straßenbilder mit der StreetSide Imagery API
Die folgende URL-Anfrage erhält ein Bild von Bergen Place in Ballard, Seattle, mit einer Neigung von 5° (nach oben) und einer Richtung von 145° (Grad im Uhrzeigersinn von Norden, was bei 0° liegt). Die Zoomstufe beträgt 5. Weitere Einzelheiten zur Streetside Imagery API finden Sie unterAbrufen von Straßenkacheln aus Bildmetadaten.
Wenn Sie die Antwortheader untersuchen, werden Sie das feststellenX-VE-SS-Erfassungsdatum
ist eingestellt aufMi, 16. Juli 2014 17:13:06 Uhr
.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Streetside/47.668687,-122.384795?zoomlevel=5&heading=145&pitch=5&mapSize=350,350&key={BingMapsKey}
Rufen Sie mithilfe der HTTP-POST-Methode eine Karte ab, auf der Pins angezeigt werden
Das folgende Beispiel zeigt, wie Sie mithilfe der HTTP-POST-Methode eine statische Karte anfordern. Wenn Sie diese Methode verwenden, können Sie bis zu 100 Pins angeben. Alle Pins müssen im Hauptteil der Anfrage enthalten sein. Da in der Anfrage weder ein Kartenbereich noch ein Mittelpunkt und keine Zoomstufe angegeben werden, wird der Kartenbereich so optimiert, dass alle Stecknadeln angezeigt werden.
HTTP-POST-URL
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/?key={BingMapsKey}
HTTP-POST-Header
Sie müssen die folgenden Einstellungen in den HTTP-POST-Header aufnehmen.
Inhaltslänge: insertLengthOfHTTPBody Inhaltstyp: text/plain; Zeichensatz=utf-8
HTTP-POST-Text
Wenn Sie im Anforderungstext Pushpins angeben, können Sie einen Wagenrücklauf verwenden (\r\n
) oder ein kaufmännisches Und (&
) als Trennzeichen. Die folgenden zwei Beispiele zeigen diese Optionen.
Beispiel 1
pp=38.889586530732335,-77.05010175704956;23;LM\r\n pp=38.88772364638439,-77.0472639799118;7;KM\r\n pp=38.890479451480054,-77.0 4744637012482;1;VM\r\n pp=38.8896854931628,-77.03519403934479;45 ;WM
Beispiel 2
pp=38.889586530732335,-77.05010175704956;23;LM&pp=38.88772364638439,-77.0472639799118;7;KM\r\n pp=38.890479451480054,-77.04744 63 7012482;1;VM&pp=38.8896854931628,-77.03519403934479;45;WM
Dieses Beispiel gibt das folgende Bild zurück.
Holen Sie sich eine Karte mit Ordnance Survey-Bildern im JPEG-Format
Dieses Beispiel zeigt eine Karte des Trafalgar Square in Großbritannien unter Verwendung von Ordnance Survey-Bildern. Die statische Karte wird im JPEG-Format zurückgegeben. Wenn dieses Bildformat nicht in der URL angegeben wäre, würde die statische Karte im Standard-PNG-Format zurückgegeben.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.506666,-0.129436/15?ml=OrdnanceSurvey&format=jpeg&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Holen Sie sich eine Karte, die das Polygon n für eine Entität hervorhebt
Dieses Beispiel zeigt eine Karte mit demHighlightEntity
(he=1) Parameter mit einem Wert vonVerwaltungsabteilung1
um eine Karte mit einem Polygon für den Bundesstaat Washington anzuzeigen. Der Breiten- und Längengrad ist ein Punkt innerhalb des Objekts, das Sie hervorheben möchten.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/Washington%20State?ms=500,270&c=en-US&he=1&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Dieses Beispiel zeigt eine Karte mit demHighlightEntity
(er=1
) Parameter mit einem Wert vonBesiedelter Ort
um eine Karte mit einem Polygon für die Stadt Redmond anzuzeigen. Der Breiten- und Längengrad ist ein Punkt innerhalb des Objekts, das Sie hervorheben möchten.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/Redmond Washington?ms=500.270&zl=12&&c=one-US&he=1&key={BingMapsKey}
Dieses Beispiel gibt das folgende Bild zurück.
Zeichnen Sie einen grünen Kreis mitdrawCurve
Parameter
In diesem Beispiel wird ein grüner Kreis um die Gegend von Palo Alto in Kalifornien gezeichnet, indem ein Kreis mit der Farbe der Umrisslinie angegeben wird64009900
(dunkelgrün), die FüllfarbeFF009900
(Limettengrün), mit einer Umrissstärke von 2 Pixeln und einem Radius von 50 Pixeln.
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/37.6288,-122.2565/10?mapSize=500,600&dc=c,64009900,FF009900,2,50;37.428175,-122.16968&fmt=png&key= {BingMapsKey}``
Hier ist die resultierende PNG-Datei:
Zeichnen Sie mit dem grüne Polygone und Linien über die Bay AreadrawCurve
Parameter
In diesem Beispiel wird ein überlappendes grünes Polygon über die Bay Area in Kalifornien gezeichnet. DerdrawCurve
Parameter wird als Polygon angegeben (P
) mit den gleichen Umriss- und Füllfarben wie oben, unter Verwendung der Basis-64-Kodierung:enc:aemcFngthVojs@asV}_GhahA{xXcw\
.
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/37.6288,-122.2565/10?mapSize=500,600&dc=p,64009900,FF009900,2;enc:aemcFngthVojs@asV%7d_GhahA%7bxXcw% 5C&key={BingMapsKey}
Hier ist die resultierende PNG-Datei:
In diesem Beispiel werden grüne Linien über die Bay Area gezogen; Die Endpunkte der Linie werden jedoch im Klartext statt im codierten Polylinienformat codiert:
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/37.6288,-122.2565/9?mapSize=400,500&dc=l,FF009900,3;37.428175,-122.16968_37.737368,-122.422845_37. 869505,-122.2705&fmt=png&key={BingMapsKey}
Hier ist das resultierende PNG-Bild:
Schließlich können Entwickler mit denselben Koordinaten wie oben gekrümmte Linien zeichnen, indem sie den ersten Parameter von änderndrawCurve
Eingabeparameter vonl
ZuLebenslauf
:
https://dev.virtualearth.net/REST/V1/Imagery/Map/Road/37.6288,-122.2565/9?mapSize=400,500&dc=cv,FF009900,3;37.428175,-122.16968_37.737368,-122.422845_37. 869505,-122.2705&fmt=png&key={BingMapsKey}
Und hier ist das resultierende PNG-Bild:
Zeichnen Sie mit dem Pushpoints auf einer Karte der USAdrawCurve
Parameter
Benutzen Sie dieS
Parameter, zusammen mitdrawCurve
, um Reißzwecken auf einem Bild zu zeichnen und diese mit geraden oder geschwungenen Linien zu verbinden.
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/41.03824,-100.76646/3?mapSize=500,500&pp=47.620495,-122.34931;90;&pp=41.88446,-71.23319;90&&pp=25.81692, -80.32291;90&dc=l,,3&key={BingMapsKey}
Hier ist das resultierende JPEG-Bild:
Wie im vorherigen Beispiel,l
imdrawCurve
Parameter kann geändert werdenLebenslauf
So zeichnen Sie geschwungene Linien:
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/41.03824,-100.76646/3?mapSize=500,500&pp=47.620495,-122.34931;90;&pp=41.88446,-71.23319;90&&pp=25.81692, -80.32291;90&dc=cv,,3&key={BingMapsKey}
Hier ist das resultierende JPEG-Bild:
HTTP-Statuscodes
Notiz
Weitere Einzelheiten zu diesen HTTP-Statuscodes finden Sie unterStatuscodes und Fehlerbehandlung.
Wenn die Anfrage erfolgreich ist, wird der folgende HTTP-Statuscode zurückgegeben.
- 200
Wenn die Anfrage nicht erfolgreich ist, gibt die Antwort einen der folgenden Fehler zurück.
- 400
- 401
- 404
- 429
- 500
- 503
Siehe auch
Verwendung der REST-Dienste mit .NETJSON-Datenverträge
FAQs
How often are Bing satellite maps updated? ›
Bing maps frequently update and expand the geographic areas covered by their imagery, with new updates being released on roughly a monthly basis. Each imagery release typically contains more than 10TB of imagery.
Which is more accurate Bing Maps or Google Maps? ›However, despite this, many independent reviewers describe Bing Maps to be one of the best maps available, rivaling even Google Maps. They state that Bing offers better image quality. They also maintain that Bing offers a friendlier and easier to follow API. Usage in countries.
How do I get Bing Street View maps? ›Streetside is available on the Bing Maps website and in the maps app in Windows. Click the Streetside icon from any map view to see street view images.
What is Bing Maps used for? ›The Bing Maps Routing API considers live traffic data and historical traffic data to present the fastest and safest route for users. Support for multiple modes of travel, including walking, driving, and public transportation, makes the API accessible for a wide range of users.