Mappe di Azure (anteprima)

Mappe di Azure fornisce API geospaziali per mapping, routing, geocodifica e geocodifica inversa.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Class Regions
Copilot Studio Standard Tutte le aree Power Automate ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
App per la logica Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Azure cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Standard Tutte le aree Power Apps ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
Power Automate Standard Tutte le aree Power Automate ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
Contact
Nome Microsoft
URL https://www.microsoft.com/
Metadati del connettore
Editore Microsoft
Sito web https://azure.microsoft.com/products/azure-maps
Informativa sulla privacy https://privacy.microsoft.com/privacystatement
Categorie Dati; Produttività

connettore Mappe di Azure

Digitare: Senza codice | Livello: Standard | Stato: Anteprima

Fornisce funzionalità di mapping, routing, geocodifica e geocodifica inversa tramite l'API REST Mappe di Azure. Le richieste vengono gestite interamente dai criteri di Gestione API: non esiste alcuna app Web del connettore.

Authentication

Autenticazione con chiave API. Le connessioni richiedono una chiave di sottoscrizione Mappe di Azure.

Parametro TIPO Obbligatorio Descrizione
subscription_key securestring Sì Chiave di sottoscrizione di Mappe di Azure

La chiave viene estratta dal token di connessione e passata a Mappe di Azure come parametro di subscription-key query dal criterio ( / CheckForTokenGetAuthHeaderValue).

Disponibilità cloud

Cloud Available
Public Sì
Fairfax (GCC) Sì
GCC High Sì
Dipartimento della Difesa (DoD) Sì

Azioni

Get route — GetRoute

Calcolare un percorso di guida o a piedi tra due punti di marcia. I punti di direzione devono essere coppie di coordinate (latitude,longitude). Gli indirizzi non sono supportati: geocodificarli prima usando Recupera posizione per indirizzo.

Endpoint (dopo i criteri):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

Il criterio converte i parametri di query di tipo GET in un corpo GeoJSON FeatureCollection POST, capovolge le coordinate in longitude,latitude ordine e esegue il mapping dei valori di evitare/ottimizzare i valori in Mappe di Azure equivalenti.

Parametro Obbligatorio TIPO Descrizione
Waypoint 1 (wp.0) Sì string Punto iniziale come latitude,longitude (ad esempio 47.610,-122.107)
Waypoint 2 (wp.1) Sì string Punto finale come latitude,longitude (ad esempio 47.612,-122.204)
Modalità di viaggio (travelMode) No string driving (impostazione predefinita) o walking
Evitare autostrade No booleano Esegue il mapping a avoid=limitedAccessHighways
Evitare pedaggi No booleano Esegue il mapping a avoid=tollRoads
Evitare i traghetti No booleano Esegue il mapping a avoid=ferries
Evitare di attraversare i confini del paese No booleano Esegue il mapping a avoid=borderCrossings
Optimize No string fastestWithoutTraffic, fastestWithTraffic o shortest

Risposta: Riepilogo itinerario con distanza di viaggio (metri), durata (secondi), durata con traffico (secondi) e dettagli delle corse.

Nota: Il routing di transito non è supportato. Mappe di Azure route directions supporta driving solo e walking.

Ottenere la posizione in base all'indirizzo : GetLocationByAddress

Geocodifica un indirizzo strutturato per coordinate e dettagli sulla posizione.

Endpoint:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

Parametro Obbligatorio TIPO Descrizione
Riga indirizzo (addressLine) No string Linea stradale (ad esempio 15595 NE 36th St)
Località (locality) No string Città (ad esempio Redmond)
Distretto amministrativo (adminDistrict) No string Abbreviazione dello stato (ad esempio WA)
Codice postale (postalCode) No string CAP (ad esempio 98052)
Paese (countryRegion) No string Codice paese ISO a 2 lettere (ad esempio US)
Numero massimo di risultati (top) No integer 1-20, valore predefinito 5

Risposta: GeoJSON FeatureCollection. Ogni funzionalità include:

  • geometry.coordinates — [longitude, latitude]
  • properties.confidence — High, Mediumo Low
  • properties.address— addressLine, localityadminDistricts, , postalCode, countryRegion (oggetto con name e ISO)formattedAddress

Nota: Mappe di Azure geocodifica non supporta gli indirizzi in Cina.

Ottenere la posizione in base al punto — GetLocationByPoint

Coordinate di latitudine/longitudine di geocodifica inversa in un indirizzo.

Endpoint (dopo i criteri):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

I criteri combinano i parametri e longitude separati latitude nel coordinates parametro di query in longitude,latitude ordine.

Parametro Obbligatorio TIPO Descrizione
Latitudine punto (latitude) Sì double Ad esempio: 47.64054
Longitudine punto (longitude) Sì double Ad esempio: -122.12934

Risposta: Stesso schema di Get location by address (GetLocationByAddress_Response).

Ottenere una mappa statica - GetMap

Ottenere un'immagine mappa statica centrata su un punto.

Endpoint (dopo i criteri):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Il criterio combina latitudine/longitudine nel center parametro (longitude,latitude), esegue il mapping imagerySet al valore Mappe di Azure style e passa la puntina facoltativa come pins parametro.

Parametro Obbligatorio TIPO Descrizione
Latitudine centrale (latitude) Sì double Ad esempio: 47.64054
Longitudine centrale (longitude) Sì double Ad esempio: -122.12934
Stile mappa (imagerySet) Sì string Vedere il mapping di stile riportato di seguito
Livello di zoom (zoomLevel) Sì string 0-20, impostazione predefinita 10
Larghezza (pixel) No integer Valore predefinito 512
Altezza (pixel) No integer Valore predefinito 512
Formato immagine No string jpeg o png (impostazione predefinita png). GIF non è supportato.
Latitudine puntina da disegno No double Latitudine della posizione della puntina da disegno
Longitudine puntina da disegno No double Longitudine della posizione della puntina da disegno
Etichetta puntina da disegno No string Testo etichetta breve

Mapping dei set di immagini:

Input imagerySet Mappe di Azure style
Road main
Aerial satellite
AerialWithLabels satellite_road_labels
CanvasDark dark
CanvasLight road_shaded_relief
CanvasGray grayscale_light

Risposta: Immagine binaria (image/jpeg o image/png). In Power Automate il corpo della risposta è codificato in base64. Per visualizzare o salvare l'immagine:

  • Usare l'espressione per eseguire la conversione prima del base64ToBinary() salvataggio in OneDrive/SharePoint.
  • Usare una tabella HTML o Inviare un'azione di posta elettronica con un <img src="data:image/png;base64,{body/$content}"> tag per eseguire il rendering inline.

Note sui criteri

  • subscription-key viene inserito dal criterio; non viene mai passato dal chiamante.
  • Le x-ms-apim-tokens intestazioni e origin vengono rimosse in ingresso.
  • Content-Type: application/json è forzata su tutte le richieste non di immagine; Le risposte alle immagini ripristinano il tipo di contenuto corretto image/* in uscita.
  • GetRoute converte una semplice richiesta di parametro di query in un POST con un corpo GeoJSON: i chiamanti non devono costruire il corpo stesso.

File

File Purpose
apiDefinition.swagger.json Definizione OpenAPI
Distribuzione/policies.xml Criteri di Gestione API
Distribuzione/PolicySourceCode.cs Logica C# dei criteri
connector-config-internal.json Autenticazione e configurazione dell'ambiente
connector-config-cli.json Funzionalità (actions)
connector-config-certification.json Nome API (azuremaps) e livello (Standard)
connector-config-metadata.json Metadati di proprietà

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:
Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Nome TIPO Descrizione Obbligatorio
Chiave di sottoscrizione securestring Chiave di sottoscrizione di Mappe di Azure True

Azioni

Get route (anteprima)

Calcolare un percorso di guida o a piedi usando i punti di marcia. I punti di direzione devono essere specificati come coordinate di latitudine, longitudine.
Ottenere la posizione in base al punto (anteprima)

Ottenere le informazioni sulla posizione associate alle coordinate di latitudine e longitudine.
Ottenere la posizione in base all'indirizzo (anteprima)

Geocodifica un indirizzo per ottenere le coordinate e i dettagli della posizione.
Ottenere una mappa statica (anteprima)

Ottenere un'immagine mappa statica centrata su un punto. GIF non è supportata; usare JPEG o PNG.

Get route (anteprima)

ID operazione:
GetRoute

Calcolare un percorso di guida o a piedi usando i punti di marcia. I punti di direzione devono essere specificati come coordinate di latitudine, longitudine.

Parametri

Nome Chiave Necessario Tipo Descrizione
Waypoint 1
 wp.0 True string

Punto di partenza come latitudine, longitudine (ad esempio 47,610,-122.107).
Waypoint 2
 wp.1 True string

Punto di arrivo come latitudine, longitudine (ad esempio 47,612,-122.204).
Modalità viaggio
 travelMode string

Modalità di viaggio per il percorso.
Evitare autostrade
 avoid_highways boolean

Evita l'uso delle autostrade nel percorso.
Evitare pedaggi
 avoid_tolls boolean

Evita l'uso di strade a pedaggio nel percorso.
Evitare i traghetti
 avoid_ferry boolean

Evita l'uso di traghetti nel percorso.
Evitare di attraversare i confini del paese
 avoid_borderCrossing boolean

Evita di attraversare i confini del paese nel percorso.
Optimize
 optimize string

Specifica gli elementi per cui ottimizzare la route.

Valori restituiti

Corpo
GetRoute_Response

Ottenere la posizione in base al punto (anteprima)

ID operazione:
GetLocationByPoint

Ottenere le informazioni sulla posizione associate alle coordinate di latitudine e longitudine.

Parametri

Nome Chiave Necessario Tipo Descrizione
Latitudine del punto
 latitude True double

Coordinata della latitudine da invertire il codice geografico. Esempio: 47.64054
Longitudine punto
 longitude True double

Coordinata della longitudine da invertire il codice geografico. Esempio: -122.12934

Valori restituiti

Corpo
GetLocationByAddress_Response

Ottenere la posizione in base all'indirizzo (anteprima)

ID operazione:
GetLocationByAddress

Geocodifica un indirizzo per ottenere le coordinate e i dettagli della posizione.

Parametri

Nome Chiave Necessario Tipo Descrizione
Riga indirizzo
 addressLine string

La linea stradale di un indirizzo (tra cui città, stato e così via).
Località (Città)
 locality string

La località, ad esempio una città degli Stati Uniti.
Distretto amministrativo (Stato)
 adminDistrict string

Suddivisione, ad esempio un'abbreviazione di stato degli Stati Uniti (ad esempio WA).
Codice postale
 postalCode string

Codice postale o postale.
Area geografica del paese
 countryRegion string

Codice paese ISO a 2 lettere (ad esempio, Stati Uniti).
Numero massimo di risultati
 top integer

Numero massimo di risultati da restituire (1-20). Impostazione predefinita: 5.

Valori restituiti

Corpo
GetLocationByAddress_Response

Ottenere una mappa statica (anteprima)

ID operazione:
GetMap

Ottenere un'immagine mappa statica centrata su un punto. GIF non è supportata; usare JPEG o PNG.

Parametri

Nome Chiave Necessario Tipo Descrizione
Latitudine centrale
 latitude True double

Latitudine del centro mappa. Esempio: 47.64054
Longitudine centrale
 longitude True double

Longitudine del centro mappa. Esempio: -122.12934
Stile mappa
 imagerySet True string

Stile della mappa da visualizzare.
Livello di zoom
 zoomLevel True string

Livello di zoom compreso tra 0 e 20. Impostazione predefinita: 10
Larghezza (pixel)
 width integer

Larghezza dell'immagine di output in pixel. Impostazione predefinita: 512
Altezza (pixel)
 height integer

Altezza dell'immagine di output in pixel. Impostazione predefinita: 512
Formato immagine
 format string

Formato dell'immagine. Impostazione predefinita: png
Latitudine puntina da disegno
 pushpinLatitude double

Latitudine della puntina da disegno.
Longitudine puntina da disegno
 pushpinLongitude double

Longitudine puntina da disegno.
Etichetta puntina da disegno
 pushpinLabel string

Etichetta puntina da disegno (fino a 3 caratteri).

Valori restituiti

response
GetMap_Response

Definizioni

GetRoute_Response

Nome Percorso Tipo Descrizione
TIPO
 type string

Tipo GeoJSON (sempre FeatureCollection).
Features
 features array of object

Matrice di funzionalità GeoJSON: Waypoint (inizio/fine), ManeuverPoint (passaggi turn-by-turn) e RoutePath (riepilogo route).
Tipo di funzionalità
 features.type string
Geometry
 features.geometry object
Tipo di funzionalità
 features.properties.type string

Tipo di funzionalità: Waypoint (start/end points), ManeuverPoint (passaggio turn-by-turn) o RoutePath (riepilogo complessivo della route).
Distanza (metri)
 features.properties.distanceInMeters float

Distanza totale del percorso in metri. Presente nelle funzionalità di RoutePath.
Durata (secondi)
 features.properties.durationInSeconds integer

Tempo di viaggio stimato in secondi (senza traffico). Presente nelle funzionalità di RoutePath.
Ritardo del traffico (secondi)
 features.properties.trafficDelayInSeconds integer

Tempo aggiuntivo in secondi a causa del traffico. Presente nelle funzionalità di RoutePath.
Congestione del traffico
 features.properties.trafficCongestion string

Livello di congestione del traffico (ad esempio Basso, Medio, Alto). Presente nelle funzionalità di RoutePath.
Dati sul traffico usati
 features.properties.trafficDataUsed string

Tipo di dati di traffico usati ,ad esempio Nessuno, Flow. Presente nelle funzionalità di RoutePath.
Partenza all'indirizzo
 features.properties.departureAt string

Orario di partenza stimato (ISO 8601). Presente nelle funzionalità di RoutePath.
Arrivo all'arrivo
 features.properties.arrivalAt string

Ora di arrivo stimata (ISO 8601). Presente nelle funzionalità di RoutePath.
Testo istruzione
 features.properties.instruction.text string

Testo dell'istruzione leggibile (ad esempio, "Turn left on NE 8th St".
Tipo di manovra
 features.properties.instruction.maneuverType string

Codice del tipo di manovra (ad esempio TurnLeft, TurnRight, Straight, ArriveFinish).
Indice waypoint
 features.properties.order.inputIndex integer

Indice del punto di ingresso corrispondente (0 = inizio, 1 = fine).
Indice gamba
 features.properties.order.legIndex integer

Indice della gamba del percorso a cui appartiene questa funzionalità.

GetLocationByAddress_Response

Nome Percorso Tipo Descrizione
TIPO
 type string

Tipo GeoJSON (sempre FeatureCollection).
Features
 features array of object

Matrice di funzionalità di posizione geocodificata.
Tipo di funzionalità
 features.type string
Tipo geometry
 features.geometry.type string
Coordinate
 features.geometry.coordinates array of double

Coordinate come [longitudine, latitudine].
Tipo di funzionalità
 features.properties.type string

Tipo di funzionalità: Indirizzo o PopulatedPlace.
Fiducia
 features.properties.confidence string

Livello di confidenza della corrispondenza (alto, medio, basso).
Codici di corrispondenza
 features.properties.matchCodes array of string

Codici corrispondenti (Buono, Ambiguo, GerarchiaSuperiore).
Indirizzo riga
 features.properties.address.addressLine string

Linea dell'indirizzo stradale.
Località (Città)
 features.properties.address.locality string

Città o località.
Distretti amministrativi
 features.properties.address.adminDistricts array of object

Matrice di distretti amministrativi (ad esempio, stato, contea).
Nome breve
 features.properties.address.adminDistricts.shortName string
Nome
 features.properties.address.adminDistricts.name string
CAP
 features.properties.address.postalCode string

Cap o CAP.
Paese
 features.properties.address.countryRegion string

Nome paese o area geografica.
Indirizzo formattato
 features.properties.address.formattedAddress string

Stringa di indirizzo formattata completa.

GetMap_Response

Immagine mappa
binary