Freigeben über

Tutorial: Migrieren von Webdiensten aus Google Maps

Sowohl Azure als auch Google Maps ermöglichen den Zugriff auf räumliche APIs über REST-Webdienste. Die API-Schnittstellen dieser Plattformen bieten ähnliche Funktionen. Die Namenskonventionen und Antwortobjekte unterscheiden sich jedoch jeweils.

In diesem Tutorial wird Folgendes veranschaulicht:

  • Geocodierung vorwärts/reversiert
  • Suchen nach Points of Interest
  • Berechnen von Routen und Wegbeschreibungen
  • Abrufen eines Kartenbilds
  • Berechnen einer Entfernungsmatrix
  • Abrufen von Zeitzonendetails

Außerdem lernen Sie:

  • Wahl des Azure Maps-REST-Diensts für die Migration von einem Google Maps-Webdienst
  • Tipps für die optimale Nutzung der Azure Maps-Dienste
  • Einblicke in andere verwandte Azure Maps Dienste

Die folgende Tabelle enthält die Dienst-APIs von Azure Maps, die über ähnliche Funktionen verfügen wie die aufgeführten Dienst-APIs von Google Maps:

Google Maps-Dienst-API Azure Maps-Dienst-API
Wegbeschreibungen Route
Entfernungsmatrix Veröffentlichen der Routenmatrix
Geocodierung Suche
Suche nach Orten Suche
AutoVervollständigen von Orten Suche
Ausrichtung an Straße Weitere Informationen finden Sie im Abschnitt Berechnen von Routen und Wegbeschreibungen.
Geschwindigkeitsbegrenzungen Weitere Informationen finden Sie unter Umgekehrte Geocodierung einer Koordinate.
Statische Karte Render
Zeitzone Zeitzone

Die folgenden Dienst-APIs stehen in Azure Maps derzeit nicht zur Verfügung:

  • Geolocation: Azure Maps verfügt über einen Dienst namens „Geolocation“. Damit werden IP-Adressen für Standortinformationen bereitgestellt, doch Funkmast- oder WLAN-Triangulation wird derzeit nicht unterstützt.
  • Details zu Orten und Fotos: Telefonnummern und Website-URL stehen in der Azure Maps-Such-API zur Verfügung.
  • Karten-URLs
  • Nächstgelegene Straßen: Erreichbar mit dem Web SDK, wie im Beispiel Grundlegende Logik der Ausrichtung an Straßen veranschaulicht, aber derzeit nicht als Dienst verfügbar.
  • Statische Straßenansicht

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Hinweis

Weitere Informationen zur Authentifizierung in Azure Maps finden Sie unter Verwalten der Authentifizierung in Azure Maps.

Geocodierung von Adressen

Bei der Geocodierung wird eine Adresse in eine Koordinate konvertiert. Die Adresse „1 Microsoft Way, Redmond, WA“ wird beispielsweise in eine Koordinate mit dem Längengrad -122,1298 und dem Breitengrad 47,64005 konvertiert. Koordinaten können dann für verschiedene Zwecke verwendet werden – etwa, um einen Marker auf einer Karte zu zentrieren.

Azure Maps bietet mehrere Methoden zur Geocodierung von Adressen:

  • Abrufen der Suchadresse: Die Freiform-Geocodierung von Adressen wird verwendet, um eine einzelne Adresszeichenfolge (wie "1 Microsoft way, Redmond, WA") anzugeben und die Anforderung sofort zu verarbeiten. Dieser Dienst wird zur schnellen Geocodierung einzelner Adressen empfohlen.
  • Strukturiertes Abrufen der Suchadresse: Geben Sie die Teile einer einzelnen Adresse an, z. B. den Namen der Straße, die Stadt, das Land bzw. die Region und die Postleitzahl, und verarbeiten Sie die Anforderung sofort. Diese API wird empfohlen, wenn Sie einzelne Adressen schnell geocodieren müssen und die Daten bereits als einzelne Adressbestandteile analysiert haben.
  • Batch für Suchadresse veröffentlichen: Erstellen Sie eine Anforderung mit bis zu 10.000 Adressen, und lassen Sie sie über einen bestimmten Zeitraum verarbeiten. Alle Adressen werden auf dem Server parallel geocodiert. Nach Abschluss des Vorgangs kann das vollständige Resultset heruntergeladen werden. Dies wird für die Geocodierung großer Datasets empfohlen.
  • Fuzzy für die Suche abrufen: Die API für die Fuzzysuche kombiniert die Geocodierung von Adressen mit der Suche nach Points of Interest (POI). Diese API übernimmt eine Freiform-Zeichenfolge, die eine Adresse, ein Ort, ein Orientierungspunkt, ein Point of Interest oder eine POI-Kategorie sein kann, und verarbeitet die Anforderung sofort. Diese API wird für Anwendungen empfohlen, in denen Benutzer im selben Textfeld nach Adressen oder Points of Interest suchen können.
  • Batchveröffentlichung für Fuzzysuche: Verwenden Sie die Fuzzybatchsuche, um eine Anforderung mit bis zu 10.000 Adressen, Orten, Orientierungspunkten oder Points of Interest zu erstellen und sie über einen bestimmten Zeitraum verarbeiten zu lassen. Alle Daten werden auf dem Server parallel verarbeitet. Nach Abschluss des Vorgangs kann das vollständige Resultset heruntergeladen werden.

In der folgenden Tabelle werden die Parameter der Google Maps-API den vergleichbaren API-Parametern in Azure Maps gegenübergestellt.

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
address query
bounds topLeft und btmRight
components streetNumber
streetName
crossStreet
postalCode
municipality: Stadt/Ort
municipalitySubdivision: Umgebung, Vorort/Metropolenregion
countrySubdivision: Bundesland oder Kanton
countrySecondarySubdivision: Landkreis
countryTertiarySubdivision: Verwaltungsbezirk
countryCode: Länder-/Regionscode (zwei Ziffern)
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
region countrySet

Weitere Informationen zur Verwendung des Suchdiensts finden Sie unter Suchen nach einem Standort mit Azure Maps Suchdiensten. Machen Sie sich unbedingt mit den bewährten Methoden für die Suche vertraut.

Tipp

Die Freiform-Geocodierung von Adressen und die APIs für die Fuzzysuche können im AutoVervollständigen-Modus verwendet werden, indem der Anforderungs-URL &typeahead=true hinzugefügt wird. Dadurch wird dem Server mitgeteilt, dass der Eingabetext wahrscheinlich unvollständig ist, woraufhin die Suche in den Vorhersagemodus wechselt.

Umgekehrte Geocodierung einer Koordinate

Bei der umgekehrten Geocodierung werden geografische Koordinaten in eine ungefähre Adresse konvertiert. Koordinaten mit dem Längengrad -122,1298 und dem Breitengrad 47,64005 werden beispielsweise in "1 Microsoft Way, Redmond, WA“ konvertiert.

Azure Maps bietet mehrere Methoden für die umgekehrte Geocodierung:

  • Suchadresse invers abrufen: Geben Sie eine einzelne geografische Koordinate an, um die ungefähre Adresse zu erhalten, die dieser Koordinate entspricht. Die Anforderung wird nahezu in Echtzeit verarbeitet.
  • Suchadresse für Querstraße invers abrufen: Geben Sie eine einzelne geografische Koordinate an, um in der Nähe gelegene Straßenkreuzungen abzurufen und die Anforderung sofort zu verarbeiten. Ein Beispiel für ein Ergebnis wäre etwa die Straßenkreuzung „1st Ave und Main St.“.
  • Batch für inverse Suchadresse veröffentlichen: Erstellen Sie eine Anforderung mit bis zu 10.000 Koordinaten, und lassen Sie sie über einen bestimmten Zeitraum verarbeiten. Alle Daten werden auf dem Server parallel verarbeitet. Nach Abschluss der Anforderung kann das vollständige Resultset heruntergeladen werden.

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern in Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
latlng query
location_type N/V
result_type entityType

Weitere Informationen finden Sie unter Best Practices für die Suche.

Die Azure Maps-API für die umgekehrte Geocodierung bietet einige andere Funktionen, die in Google Maps nicht verfügbar sind. Es empfiehlt sich ggf., diese Features im Zuge der App-Migration in Ihre Anwendung zu integrieren:

  • Abrufen von Daten zu Geschwindigkeitsbegrenzungen
  • Abrufen von Informationen zur Straßennutzung: lokale Straße, Umgehungsstraße, eingeschränkte Zufahrt, Auffahrt und Ähnliches
  • Abrufen der Straßenseite einer Koordinate

Suchen nach Points of Interest

Daten zu Points of Interest können in Google Maps mithilfe der Such-API für Orte gesucht werden. Diese API bietet drei verschiedene Möglichkeiten zum Suchen nach Points of Interest:

  • Suchen von Orten aus Text: Sucht nach einem Point of Interest anhand des Namens, der Adresse oder der Telefonnummer.
  • Umgebungssuche: Sucht nach Points of Interest innerhalb einer bestimmten Entfernung zum Standort.
  • Textsuche: Sucht nach Orten anhand von Freiformtext (mit Point of Interest und Standortangabe). Beispiele sind „Pizza in New York“ oder „Restaurants auf der Hauptstraße“.

Azure Maps stellt mehrere Such-APIs für Points of Interest bereit:

  • POI für die Suche abrufen: Sucht nach Points of Interest nach dem Namen. Beispiel: „Starbucks“.
  • POI-Kategorie für die Suche abrufen: Sucht nach Points of Interest nach der Kategorie. Beispiel: „Restaurant“.
  • Suche in der Nähe abrufen: Sucht nach Points of Interest innerhalb einer bestimmten Entfernung zum Standort.
  • Fuzzy für die Suche abrufen: Die API für die Fuzzysuche kombiniert die Geocodierung von Adressen mit der Suche nach Points of Interest (POI). Diese API übernimmt eine Freiform-Zeichenfolge, die eine Adresse, ein Ort, ein Orientierungspunkt, ein Point of Interest oder eine POI-Kategorie sein kann, und verarbeitet die Anforderung sofort. Diese API wird für Anwendungen empfohlen, in denen Benutzer im selben Textfeld nach Adressen oder Points of Interest suchen können.
  • Suche innerhalb der Geometrie veröffentlichen: Sucht nach Points of Interest innerhalb einer angegebenen Geometrie. Dadurch kann beispielsweise nach einem Point of Interest innerhalb eines Polygons gesucht werden.
  • Suche entlang einer Route veröffentlichen: Sucht nach Points of Interest entlang einer angegebenen Route.
  • Batchveröffentlichung für Fuzzysuche: Verwenden Sie die Fuzzybatchsuche, um eine Anforderung mit bis zu 10.000 Adressen, Orten, Orientierungspunkten oder Points of Interest zu erstellen und sie über einen bestimmten Zeitraum verarbeiten zu lassen. Alle Daten werden auf dem Server parallel verarbeitet. Nach Abschluss des Vorgangs kann das vollständige Resultset heruntergeladen werden.

Azure Maps verfügt aktuell über keine API, die mit der Textsuche-API in Google Maps vergleichbar ist.

Tipp

Die APIs für die POI-Suche, die POI-Kategoriesuche und die Fuzzysuche können im AutoVervollständigen-Modus verwendet werden, indem der Anforderungs-URL &typeahead=true hinzugefügt wird. Dadurch wird dem Server mitgeteilt, dass der Eingabetext wahrscheinlich unvollständig ist, woraufhin die Suche im Vorhersagemodus durchgeführt wird.

Weitere Informationen finden Sie unter Best Practices für die Suche.

Suchen von Orten aus Text

Verwenden Sie POI für die Suche abrufen und Fuzzy für die Suche abrufen von Azure Maps, um anhand von Name oder Adresse nach Points of Interest zu suchen.

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern von Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
fields N/V
input query
inputtype N/V
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
locationbias lat, lon und radius
topLeft und btmRight
countrySet

Verwenden Sie die API Suche in der Nähe abrufen in Azure Maps, um nahe gelegene Points of Interest abzurufen.

Die folgende Tabelle enthält die API-Parameter von Google Maps sowie die vergleichbaren API-Parameter von Azure Maps:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
keyword categorySet und brandSet
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
location lat und lon
maxprice N/V
minprice N/V
name categorySet und brandSet
opennow N/V
pagetoken ofs und limit
radius radius
rankby N/V
type categorySet –Weitere Informationen finden Sie unter Unterstützte Suchkategorien.

Berechnen von Routen und Wegbeschreibungen

Berechnen Sie Routen und Wegbeschreibungen mithilfe von Azure Maps. Azure Maps verfügt über viele der gleichen Funktionen wie der Routenplanungsdienst von Google Maps, z. B.:

  • Ankunfts- und Abfahrzeiten
  • Routen anhand des echtzeitbasierten und vorhergesagten Verkehrsaufkommens
  • Unterschiedliche Fortbewegungsarten Beispielsweise mit dem Auto, zu Fuß oder mit dem Fahrrad.

Hinweis

Bei Azure Maps müssen alle Wegpunkte Koordinaten sein. Adressen müssen zuerst geocodiert werden.

Der Routenplanungsdienst von Azure Maps stellt die folgenden APIs zum Berechnen von Routen bereit:

  • Abrufen von Wegbeschreibungen: Berechnen Sie die Route, und lassen Sie die Anforderung sofort verarbeiten. Diese API unterstützt sowohl GET- als auch POST-Anforderungen. POST-Anforderungen werden empfohlen, wenn eine große Anzahl von Wegpunkten angegeben wird oder wenn viele Routenoptionen verwendet werden, um sicherzustellen, dass die URL-Anforderung nicht zu lang wird und Probleme verursacht. Die POST-Anforderung im Zusammenhang mit der Routenbeschreibung in Azure Maps verfügt über eine Option, die Tausende von unterstützenden Punkten akzeptiert und diese verwendet, um eine logische Route zwischen ihnen zu erstellen (Ausrichtung an Straße).
  • Batchveröffentlichung von Wegbeschreibungen: Erstellen Sie eine Anforderung mit bis zu 1.000 Routenanforderungen, und lassen Sie sie über einen bestimmten Zeitraum verarbeiten. Alle Daten werden auf dem Server parallel verarbeitet. Nach Abschluss des Vorgangs kann das vollständige Resultset heruntergeladen werden.

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern in Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
alternatives maxAlternatives
arrival_time arriveAt
avoid avoid
departure_time departAt
destination query: Koordinaten im Format "lat0,lon0:lat1,lon1…."
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
mode travelMode
optimize computeBestOrder
origin query
region Nicht verfügbar: Dieses Feature hängt mit der Geocodierung zusammen. Verwenden Sie den Parameter countrySet, wenn Sie die Geocodierung-API von Azure Maps verwenden.
traffic_model Nicht verfügbar: Es kann nur angegeben werden, ob Verkehrsinfos mit dem Parameter traffic verwendet werden sollen.
units Nicht verfügbar: Bei Azure Maps wird ausschließlich das metrische System verwendet.
waypoints query

Tipp

Von der Routen-API von Azure Maps wird gibt standardmäßig nur eine Zusammenfassung zurückgegeben. Sie gibt die Entfernung und Zeiten sowie die Koordinaten für die Route zurück. Verwenden Sie den Parameter instructionsType, um ausführliche Anweisungen abzurufen. Verwenden Sie außerdem den Parameter routeRepresentation, um die Zusammenfassung und die Route herauszufiltern.

Die Routen-API von Azure Maps verfügt über andere Funktionen, die in Google Maps nicht verfügbar sind. Wenn Sie Ihre App migrieren, erwägen Sie, diese Features zu verwenden:

  • Unterstützung für den Routentyp: kürzeste, schnellste, attraktivste und kraftstoffeffizienteste
  • Die Unterstützung für andere Reisemodi: Bus, Motorrad, Taxi, LKW und Kleinbus.
  • Unterstützung für 150 Wegpunkte
  • Berechnung mehrerer Fahrzeiten in einer einzelnen Anforderung: bisheriger Verkehr, aktueller Verkehr, kein Verkehr
  • Die Vermeidung zusätzlicher Straßentypen: Straßen von Fahrgemeinschaften, ungepflasterte Straßen, bereits verwendete Straßen.
  • Eigene Angabe zu vermeidender Bereiche
  • Begrenzen Sie die Höhe für die Route.
  • Auf Motorangaben basierende Route: Berechnen Sie Routen für Fahrzeuge mit Verbrennungs- oder Elektromotor basierend auf Motorangaben und dem verbleibenden Kraftstoff bzw. Ladestand.
  • Unterstützung von Routenparametern für Nutzfahrzeuge Beispielsweise Fahrzeugabmessungen, Gewicht, Anzahl der Achsen, Art der Ladung und Ähnliches.
  • Angabe der maximale Fahrzeuggeschwindigkeit

Darüber hinaus unterstützt der Routendienst in Azure Maps das Abrufen des Routenbereichs. Diese werden auch als Isochrone bezeichnet. Hierzu wird ein Polygon für einen Bereich generiert, der von einem Ausgangspunkt aus in beliebiger Richtung zu erreichen ist (innerhalb eines bestimmten Zeitraums oder mit einer bestimmten Kraftstoffmenge bzw. einer bestimmten Akkuladung).

Weitere Informationen finden Sie unter Best Practices für das Routing.

Abrufen eines Kartenbilds

Azure Maps stellt eine API für das Rendern der statischen Kartenbilder mit überlagerten Daten bereit. Die Abrufen eines statischen Kartenbilds-API in Azure Maps ist mit der Google Maps-API für statische Karten vergleichbar.

Hinweis

Bei Azure Maps müssen der Mittelpunkt, alle Marker sowie die Pfadorte als Koordinaten im Format „Längengrad,Breitengrad“ vorliegen. Von Google Maps wird dagegen das Format „Breitengrad,Längengrad“ verwendet. Adressen müssen zunächst geocodiert werden.

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern in Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
center center
format format: wird als Teil des URL-Pfads angegeben. Derzeit wird nur PNG unterstützt.
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
maptype layer und style – Weitere Informationen finden Sie unter Unterstützte Kartenstile.
markers pins
path path
region N/V: Dieses Feature bezieht sich auf die Geocodierung. Verwenden Sie den Parameter countrySet, wenn Sie die Geocodierung-API von Azure Maps verwenden.
scale N/V
size width und height: Die maximale Größe beträgt 8192 x 8192.
style N/V
visible N/V
zoom zoom

Hinweis

Im Kachelsystem von Azure Maps sind die Kacheln doppelt so groß wie die in Google Maps verwendeten Kartenkacheln. Aus diesem Grund ist der Wert der Zoomebene in Azure Maps im Vergleich zu Google Maps um eine Zoomebene niedriger. Verringern Sie zur Kompensierung die Zoomstufe in den Anforderungen, die Sie migrieren.

Weitere Informationen finden Sie unter Rendern von benutzerdefinierten Daten in einer Rasterkarte.

Zusätzlich zu der Möglichkeit, ein statisches Kartenbild zu erzeugen, ermöglicht der Azure Maps Rendering Service den direkten Zugriff auf Kartenkacheln im Raster- (PNG) und Vektorformat:

Tipp

Viele Google Maps-Anwendungen wurden vor einigen Jahren von interaktiven Kartenbildern auf statische Kartenbilder umgestellt. Diese Maßnahme wurde ergriffen, um Kosten zu sparen. In Azure Maps ist es in der Regel kostengünstiger, das interaktive Kartensteuerelement im Web SDK zu verwenden. Die Abrechnung für das interaktive Kartensteuerelement basiert auf der Anzahl von Kachelladevorgängen. In Azure Maps werden große Kartenkacheln verwendet. Häufig sind nur wenige Kacheln erforderlich, um die gleiche Kartenansicht zu erhalten wie bei einer statischen Karte. Kartenkacheln werden vom Browser automatisch zwischengespeichert. Daher generiert das interaktive Kartensteuerelement bei der Nachbildung einer statischen Kartenansicht häufig nur einen Bruchteil einer Transaktion. Durch Schwenken und Zoomen werden weitere Kacheln geladen, es gibt jedoch Optionen im Kartensteuerelement, mit denen dieses Verhalten deaktiviert werden kann. Das interaktive Kartensteuerelement bietet außerdem deutlich mehr Visualisierungsoptionen als die statischen Kartendienste.

Vergleich der Formate von Marker-URL-Parametern

Vorher: Google Maps

Fügen Sie Marker mithilfe des Parameters markers in der URL hinzu. Der Parameter markers übernimmt einen Stil und eine Liste von Positionen, die auf der Karte mit diesem Stil gerendert werden sollen, wie im Folgenden dargestellt:

&markers=markerStyles|markerLocation1|markerLocation2|...

Wenn Sie andere Stile hinzufügen möchten, verwenden Sie die URL der markers Parameter mit einem anderen Stil und einer anderen Anzahl von Standorten.

Geben Sie Markerpositionen im Format „Breitengrad,Längengrad“ an.

Fügen Sie Markerstile im Format optionName:value hinzu, und trennen Sie mehrere Stile jeweils durch einen senkrechten Strich (|) voneinander: „Optionsname1:Wert1|Optionsname2:Wert2“. Beachten Sie, dass die Optionsnamen und -werte durch einen Doppelpunkt (:) getrennt sind. Verwenden sie die folgenden Stiloptionsnamen für die Gestaltung von Markern in Google Maps:

  • color: die Farbe des Standardmarkersymbols. Dabei kann es sich um eine hexadezimale 24-Bit-Farbe (0xrrggbb) oder einen der folgenden Werte handeln: black, brown, green, purple, yellow, blue, gray, orange, red, white.
  • label: ein einzelnes alphanumerisches Zeichen in Großschreibung, das oberhalb des Symbols angezeigt wird.
  • size: die Größe des Markers. Kann tiny, mid oder small sein.

Verwenden Sie die folgenden Stiloptionsnamen für benutzerdefinierte Symbole in Google Maps:

  • anchor: gibt an, wie das Symbolbild an der Koordinate ausgerichtet wird. Es kann sich um einen Pixelwert (x,y) oder einen der folgenden Werte handeln: top, bottom, left, right, center, topleft, topright, bottomleft oder bottomright.
  • icon: eine URL, die auf das Symbolbild verweist.

In diesem Beispiel fügen wir der Karte einen roten, mittelgroßen Marker mit dem Längengrad -110 und dem Breitengrad 45 hinzu:

&markers=color:red|size:mid|45,-110

Google Maps-Marker

Nachher: Azure Maps

Geben Sie in der URL den Parameter pins an, um einem statischen Kartenbild Marker hinzuzufügen. Geben Sie wie in Google Maps einen Stil und eine Liste mit Positionen im Parameter an. Der Parameter pins kann mehrmals angegeben werden, um Marker mit unterschiedlichen Stilen zu unterstützen.

&pins=iconType|pinStyles||pinLocation1|pinLocation2|...

Wenn Sie andere Stile hinzufügen möchten, fügen Sie der URL zusätzliche pins Parameter mit einem anderen Stil und einer anderen Anzahl von Standorten hinzu.

In Azure Maps muss die Stecknadelposition im Format „Längengrad Breitengrad“ angegeben werden. Von Google Maps wird das Format „Breitengrad,Längengrad“ verwendet. Im Azure Maps-Format sind Längen- und Breitengrad nicht durch ein Komma, sondern durch ein Leerzeichen getrennt.

iconType gibt die Art der zu erstellenden Stecknadel an. Die folgenden Werte sind möglich:

  • default: das Standardsymbol für Pins.
  • none: Es wird kein Symbol angezeigt, sondern nur die Bezeichnungen werden gerendert.
  • custom: gibt an, dass ein benutzerdefiniertes Symbol verwendet werden soll. Eine URL, die auf das Symbolbild verweist, kann am Ende des Parameters pins nach den Informationen zur Pinposition hinzugefügt werden.

Fügen Sie Stecknadelstile im Format optionNameValue hinzu. Trennen Sie mehrere Stile jeweils durch einen senkrechten Strich (|). Beispiel: iconType|optionName1Value1|optionName2Value2. Optionsname und -wert werden nicht voneinander getrennt. Verwenden Sie die folgenden Stiloptionsnamen für die Gestaltung von Markern:

  • al: gibt die Deckkraft (Alpha) des Markers an. Wählen Sie eine Zahl zwischen 0 und 1 aus.
  • an: gibt den Pinanker an. Geben Sie x- und y-Pixelwerte im Format „x y“ an.
  • co: die Farbe des Pins. Geben Sie eine hexadezimale 24-Bit-Farbe an: 000000 bis FFFFFF.
  • la: gibt den Bezeichnungsanker an. Geben Sie x- und y-Pixelwerte im Format „x y“ an.
  • lc: die Farbe der Bezeichnung. Geben Sie eine hexadezimale 24-Bit-Farbe an: 000000 bis FFFFFF.
  • ls: die Größe der Bezeichnung in Pixel. Wählen Sie eine Zahl größer Null aus.
  • ro: ein Wert in Grad, um den das Symbol gedreht werden soll. Wählen Sie eine Zahl zwischen -360 und 360 aus.
  • sc: ein Skalierungswert für das Pinsymbol. Wählen Sie eine Zahl größer Null aus.

Geben Sie Bezeichnungswerte für jede Stecknadelposition an. Diese Vorgehensweise ist effizienter als einen einzelnen Bezeichnungswert auf alle Marker in der Positionsliste anzuwenden. Der Bezeichnungswert kann eine Zeichenfolge mit mehreren Zeichen sein. Schließen Sie die Zeichenfolge in einfache Anführungszeichen ein, um sicherzustellen, dass sie nicht mit einem Stil- oder Positionswert verwechselt wird.

In diesem Beispiel fügen wir ein rotes (FF0000) Standardsymbol mit der Bezeichnung „Space Needle“ darunter (15 50) hinzu. Das Symbol hat den Längengrad -122,349300 und den Breitengrad 47,620180:

&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180

Azure Maps-Marker

Fügen Sie drei Stecknadeln mit den Bezeichnungswerten „1“, „2“ und „3“ hinzu:

&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Mehrere Azure Maps-Marker

Vergleich der Formate von Pfad-URL-Parametern

Vorher: Google Maps

Fügen Sie einem statischen Kartenbild mithilfe des Parameters path in der URL Linien und ein Polygon hinzu. Der Parameter path akzeptiert einen Stil und eine Liste von Positionen, die auf der Karte gerendert werden sollen:

&path=pathStyles|pathLocation1|pathLocation2|...

Verwenden Sie andere Stile, indem Sie der URL zusätzliche path Parameter mit einem anderen Stil und einer anderen Anzahl von Standorten hinzufügen.

Pfadpositionen werden im Format latitude1,longitude1|latitude2,longitude2|…angegeben. Pfade können codiert werden oder Adressen für Punkte enthalten.

Fügen Sie Pfadstile im Format optionName:value hinzu, und trennen Sie sie jeweils durch einen senkrechten Strich (|). Optionsnamen und -werte müssen auch jeweils durch einen Doppelpunkt (:) getrennt werden. Beispiel: optionName1:value1|optionName2:value2 Die folgenden Stiloptionsnamen können für den Stil von Pfaden in Google Maps verwendet werden:

  • color: die Farbe der Pfad- oder Polygonumrandung. Dabei kann es sich um eine hexadezimale 24-Bit-Farbe (0xrrggbb), eine hexadezimale 32-Bit-Farbe (0xrrggbbbaa) oder einen der folgenden Werte handeln: „black“, „brown“, „green“, „purple“, „yellow“, „blue“, „gray“, „orange“, „red“, „white“.
  • fillColor: die Farbe zum Ausfüllen des Pfadbereichs (Polygon). Dabei kann es sich um eine hexadezimale 24-Bit-Farbe (0xrrggbb), eine hexadezimale 32-Bit-Farbe (0xrrggbbbaa) oder einen der folgenden Werte handeln: „black“, „brown“, „green“, „purple“, „yellow“, „blue“, „gray“, „orange“, „red“, „white“.
  • geodesic: gibt an, ob der Pfad eine Linie sein soll, die der Erdkrümmung folgt.
  • weight: die Stärke der Pfadlinie in Pixel.

Fügen Sie der Karte im URL-Parameter eine rote Linie mit Deckkraft und Pixelstärke zwischen den Koordinaten hinzu. Im folgenden Beispiel hat die Linie eine Deckkraft von 50 Prozent und eine Stärke von vier Pixeln. Als Koordinaten werden der Längengrad -110 und der Breitengrad 45 und Längengrad: –100, Breitengrad: 50 verwendet.

&path=color:0xFF000088|weight:4|45,-110|50,-100

Google Maps-Polylinie

Nachher: Azure Maps

Geben Sie in der URL den Parameter path an, um einem statischen Kartenbild Linien und Polygone hinzuzufügen. Geben Sie in diesem Parameter wie in Google Maps einen Stil und eine Liste mit Positionen an. Geben Sie den Parameter path mehrmals an, um mehrere Kreise, Linien und Polygone mit unterschiedlichen Stilen zu rendern.

&path=pathStyles||pathLocation1|pathLocation2|...

Bei Azure Maps müssen die Koordinaten für Pfadpositionen im Format „Längengrad,Breitengrad“ angegeben werden. Von Google Maps wird das Format „Breitengrad,Längengrad“ verwendet. Im Azure Maps-Format sind Längen- und Breitengrad nicht durch ein Komma, sondern durch ein Leerzeichen getrennt. Azure Maps unterstützt keine codierten Pfade oder Adressen für Punkte.

Fügen Sie Pfadstile mit dem Format optionNameValue hinzu. Trennen Sie mehrere Stile jeweils durch einen senkrechten Strich (|): optionName1Value1|optionName2Value2. Optionsname und -wert werden nicht voneinander getrennt. Verwenden Sie die folgenden Stiloptionsnamen für die Gestaltung von Pfaden in Azure Maps:

  • fa: die Deckkraft der Füllfarbe (Alpha), die beim Rendern von Polygonen verwendet wird. Wählen Sie eine Zahl zwischen 0 und 1 aus.
  • fc: die Füllfarbe, die zum Rendern des Bereichs eines Polygons verwendet wird.
  • la: die Deckkraft der Linienfarbe (Alpha), die zum Rendern von Linien und der Umrandung von Polygonen verwendet wird. Wählen Sie eine Zahl zwischen 0 und 1 aus.
  • lc: die Linienfarbe, die zum Rendern von Linien und der Umrandung von Polygonen verwendet wird.
  • lw: die Breite der Linie in Pixel.
  • ra: gibt einen Kreisradius in Metern an.

Fügen Sie im URL-Parameter eine rote Linie mit Deckkraft und Pixelstärke zwischen den Koordinaten hinzu. Im folgenden Beispiel hat die Linie eine Deckkraft von 50 Prozent und eine Stärke von vier Pixeln. Als Koordinaten werden der Längengrad -110 und der Breitengrad 45 und Längengrad: –100, Breitengrad: 50 verwendet.

&path=lcFF0000|la.5|lw4||-110 45|-100 50

Azure Maps-Polylinie

Berechnen einer Entfernungsmatrix

In Azure Maps steht die Entfernungsmatrix-API zur Verfügung. Verwenden Sie diese API, um die Reisezeiten und Entfernungen zwischen einer Reihe von Positionen mit einer Entfernungsmatrix zu berechnen. Sie ist vergleichbar mit der Entfernungsmatrix-API in Google Maps.

  • Veröffentlichen der Routenmatrix: Berechnet asynchron die Reisezeiten und Entfernungen für einen Satz von Ausgangspunkten und Zielen. Unterstützt bis zu 700 Zellen pro Anforderung. Hierbei handelt es sich um die Anzahl von Ausgangspunkten multipliziert mit der Anzahl von Zielen. Mit dieser Einschränkung sind beispielsweise folgende Matrixabmessungen möglich: 700 × 1, 50 × 10, 10 × 10, 28 × 25, 10 × 70.

Hinweis

Eine Anforderung an die Entfernungsmatrix-API kann nur mithilfe einer POST-Anforderung erfolgen, die Informationen zum Ausgangs- und Zielpunkt im Anforderungstext enthält. Außerdem erfordert Azure Maps, dass alle Ausgangspunkte und Ziele als Koordinaten angegeben werden. Adressen müssen zunächst geocodiert werden.

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern von Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
arrival_time arriveAt
avoid avoid
departure_time departAt
destinations destination: wird im POST-Anforderungstext als GeoJSON angegeben.
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
mode travelMode
origins origins: wird im POST-Anforderungstext als GeoJSON angegeben.
region Nicht verfügbar: Dieses Feature hängt mit der Geocodierung zusammen. Verwenden Sie den Parameter countrySet, wenn Sie die Geocodierung-API von Azure Maps verwenden.
traffic_model Nicht verfügbar: Es kann nur angegeben werden, ob Verkehrsinfos mit dem Parameter traffic verwendet werden sollen.
transit_mode Nicht verfügbar: Transitbasierte Entfernungsmatrizen werden zurzeit nicht unterstützt.
transit_routing_preference Nicht verfügbar: Transitbasierte Entfernungsmatrizen werden zurzeit nicht unterstützt.
units Nicht verfügbar: Bei Azure Maps wird ausschließlich das metrische System verwendet.

Tipp

In der Entfernungsmatrix-API von Azure Maps werden alle erweiterten Routenplanungsoptionen unterstützt, die in der Routenplanungs-API von Azure Maps zur Verfügung stehen. Zu diesen erweiterten Routenplanungsoptionen zählen unter anderem LKW-Streckenplanung und Motorangaben.

Weitere Informationen finden Sie unter Best Practices für das Routing.

Abrufen einer Zeitzone

Azure Maps bietet eine API zum Abrufen der Zeitzone einer Koordinate. Die Azure Maps-Zeitzonen-API ist mit der Zeitzonen-API von Google Maps vergleichbar:

In der folgenden Tabelle werden die API-Parameter von Google Maps den vergleichbaren API-Parametern in Azure Maps gegenübergestellt:

Google Maps-API-Parameter Vergleichbarer Azure Maps-API-Parameter
key subscription-keyWeitere Informationen finden Sie unter Authentifizierung mit Azure Maps.
language language – Weitere Informationen finden Sie unter Lokalisierungsunterstützung in Azure Maps.
location query
timestamp timeStamp

Zusätzlich zu dieser API bietet Azure Maps eine Reihe von Zeitzonen-APIs. Diese APIs konvertieren die Zeit basierend auf den Namen oder IDs der Zeitzone:

Clientbibliotheken

Azure Maps stellt Clientbibliotheken für die folgenden Programmiersprachen bereit:

Die folgenden Open-Source-Clientbibliotheken stehen für andere Programmiersprachen zur Verfügung:

Bereinigen von Ressourcen

Es muss keine Bereinigung von Ressourcen durchgeführt werden.

Nächste Schritte

Weitere Informationen zu den Azure Maps-REST-Diensten:

Bewährte Suchmethoden