Megosztás a következőn keresztül:

Data - Download

  • Referencia
Szolgáltatás:
Maps
API-verzió:
2.0

Az adatok feltöltésével korábban feltöltött adatok letöltésére használható.

Megjegyzés

Az Azure Maps data service kivezetése

Az Azure Maps adatszolgáltatás ( v1 és v2) elavult, és 24.09.16-án megszűnik. A szolgáltatáskimaradások elkerülése érdekében az adatszolgáltatáshoz intézett összes hívást frissíteni kell az Azure Maps Data Registry szolgáltatás használatához 2024. 09. 16-ig. További információ: Adatregisztrációs adatbázis létrehozása.

Az Data Download API és a HTTP-kérés GET lehetővé teszi, hogy a hívó letöltsön egy korábban feltöltött adattartalmat.

Ezt az API-t olyan forgatókönyvekben használhatja, mint a korábban feltöltött geokerítések egy meglévő gyűjteményének letöltése az Azure Maps Geofencing Service-ben való használatra az Adatfeltöltés API használatával.

Fontos

Ezzel a funkcióval elfogadja az előzetes verzióra vonatkozó jogi feltételeket. További részletekért tekintse meg az előzetes verzió kiegészítő feltételeit .

Letöltési kérelem elküldése

A tartalom letöltéséhez használjon egy kérést GET , amelyben az elérési út tartalmazza a udid letölteni kívánt adatokat. Ha szeretné, megadhat egy Accept fejlécet is az adatválasz beállításához Content-Type .

Ha például az Upload API használatával korábban feltöltött geokerítések gyűjteményét szeretné letölteni, állítsa a paramétert az udid elérési útban a udid korábban a feltöltési API-válaszban kapott adatokra, és állítsa a Accept fejlécet az alábbi médiatípusok valamelyikére:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Adatválasz letöltése

A Download API HTTP-választ 200 OKudid ad vissza, ha megtalálható az átadott adaterőforrás, ahol a választörzs tartalmazni fogja az adaterőforrás tartalmát.

A rendszer HTTP-hibaválaszt 400 Bad Requestudid ad vissza, ha az átadott adaterőforrás nem található.

Íme egy mintaválasz törzse a korábban az Upload API használatával feltöltött egyszerű geofence-hez GeoJSON :

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}

GET https://{geography}.atlas.microsoft.com/mapData/{udid}?api-version=2.0

URI-paraméterek

Name In Kötelező Típus Description
geography
 path True

string

Ez a paraméter határozza meg, hogy hol található az Azure Maps Creator-erőforrás. Érvényes értékek vagyunk és eu.
udid
 path True

string

A tartalom egyedi adatazonosítója. A udid sikeres adatfeltöltési hívásból kell beszerezni.
api-version
 query True

string

Az Azure Maps API verziószáma.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID security Azure Mapsben való használatához az alábbi cikkek nyújtanak útmutatást.

Válaszok

Name Típus Description
200 OK

file

Az adatletöltési kérelem sikeresen befejeződött. A válasz törzse tartalmazni fogja az átadott fájl tartalmát.udid

Media Types: "application/json", "application/vnd.geo+json", "application/octet-stream"

Fejlécek

Content-Type: string
Other Status Codes

ErrorResponse

Váratlan hiba történt.

Media Types: "application/json", "application/vnd.geo+json", "application/octet-stream"

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0-folyamatok . Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

  • Ehhez a biztonsági definícióhoz a x-ms-client-id fejléc használatával kell jelezni, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Maps management API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure-beli szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy PowerShell, CLI, Azure SDK-k vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázása műveletéből jön létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

Download previously uploaded GeoJSON data containing geometries that represent a collection of geofences

Sample request

GET https://us.atlas.microsoft.com/mapData/25084fb7-307a-4720-8f91-7952a0b91012?api-version=2.0

Sample response

Status code:
200 
"{file}"

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hiba célja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.