Search - Get Reverse Geocoding
Slouží k získání informace o ulici a poloze ze souřadnic zeměpisné délky a šířky.
Rozhraní API Get Reverse Geocoding je požadavek HTTP GET, který se používá k překladu souřadnic (například 37.786505, -122.3862) do srozumitelné poštovní adresy člověka. Užitečné při sledování aplikací, kde obdržíte GPS informační kanál ze zařízení nebo prostředku a chcete znát adresu přidruženou ke souřadnicům. Tento koncový bod vrátí informace o adrese pro danou souřadnici.
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
|
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
|
coordinates
|
query | True |
number[] |
Souřadnice umístění, které chcete vrátit zpět ke geografickému kódu. Příklad: &souřadnic=lon,lat |
|
result
|
query |
Zadejte požadované typy entit v odpovědi. Vrátí se pouze zadané typy. Pokud bod nelze namapovat na zadané typy entit, v odpovědi se nevrátí žádné informace o poloze. Výchozí hodnota je všechny možné entity. Čárkami oddělený seznam typů entit vybraných z následujících možností.
Tyto typy entit jsou seřazené od nejtypičtější entity až po nejméně konkrétní entitu. Pokud jsou nalezeny entity více než jednoho typu entity, vrátí se pouze nejvýraznější entita. Pokud například zadáte Adresu a AdminDistrict1 jako typy entit a entity byly nalezeny pro oba typy, vrátí se v odpovědi pouze informace o entitě Adresa. |
||
|
view
|
query |
string |
Řetězec představující ISO 3166-1 Alfa-2 oblast/kód země. Tím se změní geopolitické sporné ohraničení a popisky tak, aby odpovídaly zadané oblasti uživatele. Ve výchozím nastavení je parametr View nastavený na "Auto", i když jste ho v požadavku nenadefinili. Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních. |
Hlavička požadavku
| Name | Vyžadováno | Typ | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Specifikuje, který účet je určen pro použití ve spojení s bezpečnostním modelem Azure AD. Představuje jedinečné ID pro účet Azure Maps a lze jej získat z API účtu na Azure Maps management plane. Pro více informací o používání Microsoft Entra ID bezpečnosti v Azure Maps viz Spravovat autentizaci v Azure Maps. |
|
| Accept-Language |
string |
Jazyk, ve kterém mají být vráceny výsledky hledání. Podrobnosti najdete v podporovaných jazycích. |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Požadavek byl úspěšný. Media Types: "application/geo+json", "application/json" |
|
| Other Status Codes |
Neočekávaná chybová odpověď Media Types: "application/geo+json", "application/json" Hlavičky x-ms-error-code: string |
Zabezpečení
AadToken
Jsou to Microsoft Entra OAuth 2.0 Flows. V kombinaci s Azure řízením přístupu založeného na rolích lze použít k řízení přístupu k Azure Maps REST API. Role Azure kontroly přístupu se používají k určení přístupu k jednomu nebo více účtům nebo podzdrojům Azure Maps. Každému uživateli, skupině nebo principálu služby může být udělen přístup prostřednictvím vestavěné role nebo vlastní role složené z jednoho či více oprávnění k Azure Maps REST API.\n\nPro implementaci scénářů doporučujeme zobrazit koncepty autentizace. Shrnuto, tato definice bezpečnosti poskytuje řešení pro modelování aplikací pomocí objektů schopných kontroly přístupu ke specifickým API a rozsahům.\n\n#### Poznámky\n* Tato bezpečnostní definice vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému Azure Maps zdroji aplikace žádá přístup. Tuto možnost lze získat z API pro správu Maps.\n* \nAuthorization URL je specifický pro instanci Azure veřejného cloudu. Suverénní cloudy mají unikátní autorizační URL a konfigurace Microsoft Entra ID. \n* \nŘízení přístupu založené na rolích Azure je konfigurováno z Azure management plane prostřednictvím Azure portálu, PowerShellu, CLI, Sady Azure SDK nebo REST API.\n* \nVyužití Azure Maps Web SDK umožňuje konfigurační nastavení aplikace pro více případů použití.\n* Pro více informací o Microsoft identity platform viz přehled Microsoft identity platform přehled.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Jedná se o sdílený klíč, který se zpřístupní, když Vytvoříte Azure Maps účet v Azure portálu nebo pomocí PowerShell, CLI, Sady Azure SDK či REST API.\n\n S tímto klíčem může jakákoli aplikace přistupovat ke všem REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, na který jsou vydávány.\n\n Pro veřejně přístupné aplikace doporučujeme použít přístup confidential client applications k přístupu Azure Maps REST API, aby mohl být klíč bezpečně uložen.
Typ:
apiKey
V:
header
SAS Token
Tento token sdíleného přístupového podpisu je vytvořen operací List SAS na Azure Maps resource přes Azure management plane přes Azure portál, PowerShell, CLI, Sady Azure SDK nebo REST API.\n\n S tímto tokenem je jakákoli aplikace oprávněna přistupovat pomocí Azure Kontroly přístupu založené na rolích a jemná opatření k expiraci, rychlosti a regionům využití konkrétního tokenu. Jinými slovy, SAS Token lze použít k tomu, aby aplikace mohly bezpečněji kontrolovat přístup než sdílený klíč.\n\n Pro veřejně vystavené aplikace doporučujeme nastavit konkrétní seznam povolených původů na zdroji účtu Map, aby se omezilo zneužívání vykreslování a pravidelně obnovovat SAS Token.
Typ:
apiKey
V:
header
Příklady
Search point -122.138681, 47.630358
Ukázkový požadavek
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates=-122.138681,47.630358
Ukázková odpověď
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"address": {
"countryRegion": {
"name": "United States"
},
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King County",
"shortName": "King Co."
}
],
"formattedAddress": "15127 NE 24th St, Redmond, Washington 98052",
"streetName": "NE 24th St",
"streetNumber": "15127",
"locality": "Redmond",
"postalCode": "98052",
"addressLine": "15127 NE 24th St"
},
"type": "Address",
"confidence": "Medium",
"matchCodes": [
"Good"
],
"geocodePoints": [
{
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Display"
]
},
{
"geometry": {
"type": "Point",
"coordinates": [
-122.1386787,
47.6302179
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Route"
]
}
]
},
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"bbox": [
-122.14632282407,
47.626495282429325,
-122.13103917593001,
47.63422071757068
]
}
]
}
Definice
| Name | Description |
|---|---|
| Address |
Adresa výsledku |
|
Address |
Název dílčího dělení v zemi nebo oblasti adresy. |
|
Address |
Země nebo oblast s uvedením jejího názvu a kódu ISO. |
|
Azure. |
Objekt chyby. |
|
Azure. |
Odpověď obsahující podrobnosti o chybě. |
|
Azure. |
Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors. |
|
Calculation |
Metoda, která se použila k výpočtu bodu geografického kódu. |
|
Confidence |
Úroveň spolehlivosti, že výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte s kódem shody k určení podrobnějších informací o shodě. Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geokódovaného umístění a umístění uživatele, pokud je zadáno. |
|
Feature |
Určuje typ |
|
Features |
Objekt funkce. |
|
Features |
Vlastnosti tohoto prvku. |
|
Feature |
Typ funkce musí být Funkce. |
|
Geocode |
Geokódový bod. |
|
Geocoding |
Tento objekt se vrátí z úspěšného volání geokódování. |
|
Geo |
Určuje typ |
|
Geo |
Platný typ geometrie |
| Intersection |
Adresa výsledku. |
|
Match |
Enum představující kód zápasu. |
|
Reverse |
Enum představující typ výsledku reverzního geokódování. |
|
Usage |
Enum představující typ použití. |
Address
Adresa výsledku
| Name | Typ | Description |
|---|---|---|
| addressLine |
string |
AddressLine , který obsahuje název ulice a číslo popisné |
| adminDistricts |
Název dílčího dělení v zemi nebo oblasti adresy. Tento prvek je obvykle považován za první dílčí dělení správního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté rozdělení pořadí v zemi, závislosti nebo oblasti. |
|
| countryRegion |
Země nebo oblast s uvedením jejího názvu a kódu ISO. |
|
| formattedAddress |
string |
Vlastnost formátované adresy |
| intersection |
Adresa výsledku. |
|
| locality |
string |
Nemovitost lokality |
| neighborhood |
string |
Nemovitosti v okolí |
| postalCode |
string |
Vlastnost PSČ |
| streetName |
string |
Název ulice z formattedAddress |
| streetNumber |
string |
Číslo na ulici, pokud je k dispozici, z formattedAddress |
AddressAdminDistrictsItem
Název dílčího dělení v zemi nebo oblasti adresy.
| Name | Typ | Description |
|---|---|---|
| name |
string |
Název odpovídajícího pole adminDistrict for adminDistrict[0], může to být úplný název státu, jako je Washington, For adminDistrict[1], může to být úplný název okresu. |
| shortName |
string |
Krátký název odpovídajícího pole adminDistrict for adminDistrict[0], může to být krátký název státu, jako je WA, For adminDistrict[1], může to být krátký název okresu. |
AddressCountryRegion
Země nebo oblast s uvedením jejího názvu a kódu ISO.
| Name | Typ | Description |
|---|---|---|
| ISO |
string |
ISO země/oblasti |
| name |
string |
název země/oblasti |
Azure.Core.Foundations.Error
Objekt chyby.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Jedna ze serverově definovaných kódů chyb. |
| details |
Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě. |
|
| innererror |
Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě. |
|
| message |
string |
Čitelné znázornění chyby člověkem. |
| target |
string |
Cíl chyby. |
Azure.Core.Foundations.ErrorResponse
Odpověď obsahující podrobnosti o chybě.
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
Azure.Core.Foundations.InnerError
Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Jedna ze serverově definovaných kódů chyb. |
| innererror |
Vnitřní chyba. |
CalculationMethodEnum
Metoda, která se použila k výpočtu bodu geografického kódu.
| Hodnota | Description |
|---|---|
| Interpolation |
Bod geokódu byl přiřazen k bodu na silnici pomocí interpolace. |
| InterpolationOffset |
Bod geokódu byl přiřazen k bodu na silnici pomocí interpolace s dodatečným odsazením pro posunutí bodu na stranu ulice. |
| Parcel |
Bod geokódu byl přiřazen ke středu parcely. |
| Rooftop |
Bod geokódu byl přiřazen ke střeše budovy. |
ConfidenceEnum
Úroveň spolehlivosti, že výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte s kódem shody k určení podrobnějších informací o shodě.
Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geokódovaného umístění a umístění uživatele, pokud je zadáno.
| Hodnota | Description |
|---|---|
| High |
Pokud je spolehlivost nastavena na Pokud požadavek obsahuje umístění nebo výběr, může se pořadí odpovídajícím způsobem změnit. Například dotaz na polohu pro "Paříž" vrátí "Paříž, Francie" a "Paříž, TX" s |
| Medium |
V některých situacích nemusí být vrácená shoda na stejné úrovni jako informace uvedené v požadavku. Požadavek může například obsahovat informace o adrese a služba geokódování může být schopna spárovat pouze poštovní směrovací číslo. V tomto případě, pokud má služba geokódu jistotu, že poštovní směrovací číslo odpovídá datům, je tato spolehlivost nastavena na Pokud jsou informace o umístění v dotazu nejednoznačné a nejsou k dispozici žádné další informace pro jejich pořadí (například umístění uživatele nebo relativní důležitost umístění), je spolehlivost nastavena na Pokud informace o poloze v dotazu neposkytují dostatek informací pro geografické kódování konkrétního umístění, může být vrácena méně přesná hodnota umístění a spolehlivost je nastavena na |
| Low |
Nízká úroveň |
FeatureCollectionEnum
Určuje typ GeoJSON. Jediný podporovaný typ objektu je FeatureCollection. Další informace naleznete v tématu RFC 7946.
| Hodnota | Description |
|---|---|
| FeatureCollection |
Určuje typ objektu |
FeaturesItem
Objekt funkce.
| Name | Typ | Description |
|---|---|---|
| bbox |
number[] (double) |
Ohraničující rámeček. Použitá projekce - EPSG:3857. Podrobnosti najdete v RFC 7946. |
| geometry |
Platný typ geometrie |
|
| id |
string |
ID pro vrácenou funkci |
| properties |
Vlastnosti tohoto prvku. |
|
| type |
Typ funkce musí být Funkce. |
FeaturesItemProperties
Vlastnosti tohoto prvku.
| Name | Typ | Description |
|---|---|---|
| address |
Adresa výsledku |
|
| confidence |
Úroveň spolehlivosti, že výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte s kódem shody k určení podrobnějších informací o shodě. Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geokódovaného umístění a umístění uživatele, pokud je zadáno. |
|
| geocodePoints |
Kolekce bodů geografického kódu, které se liší ve způsobu výpočtu a jejich navrhovaném použití. |
|
| matchCodes |
Jedna nebo více hodnot kódu, které představují úroveň geokódování pro každé umístění v odpovědi. Například geograficky zakódované umístění s kódy shody Podobně geokódované umístění s kódy shody Možné hodnoty:
|
|
| type |
string |
Jedna z: * Adresa * Silniční zátaras * Křižovatka silnic * Čtvrť * Osídlené místo * PSČ1 * Administrativní divize1 * Administrativní divize2 * ZeměRegion |
FeatureTypeEnum
Typ funkce musí být Funkce.
| Hodnota | Description |
|---|---|
| Feature |
Určuje typ objektu |
GeocodePointsItem
Geokódový bod.
| Name | Typ | Description |
|---|---|---|
| calculationMethod |
Metoda, která se použila k výpočtu bodu geografického kódu. |
|
| geometry |
Platný typ geometrie |
|
| usageTypes |
Nejlepší použití pro bod geografického kódu. Každý bod geografického kódu je definován jako bod |
GeocodingResponse
Tento objekt se vrátí z úspěšného volání geokódování.
| Name | Typ | Description |
|---|---|---|
| features |
Z dotazu se vrátila řada funkcí. |
|
| nextLink |
string |
Je odkaz na další stránku vrácených funkcí. Pokud se jedná o poslední stránku, žádné toto pole. |
| type |
Určuje typ |
GeoJsonObjectType
Určuje typ GeoJSON. Musí být jedním z devíti platných typů objektů GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature a FeatureCollection.
| Hodnota | Description |
|---|---|
| Point |
|
| MultiPoint |
|
| LineString |
|
| MultiLineString |
|
| Polygon |
|
| MultiPolygon |
|
| GeometryCollection |
|
| Feature |
|
| FeatureCollection |
|
GeoJsonPoint
Platný typ geometrie GeoJSON Point. Podrobnosti najdete v RFC 7946.
| Name | Typ | Description |
|---|---|---|
| bbox |
number[] (double) |
Ohraničující rámeček. Použitá projekce - EPSG:3857. Podrobnosti najdete v RFC 7946. |
| coordinates |
number[] (double) |
|
| type |
string:
Point |
Určuje typ |
Intersection
Adresa výsledku.
| Name | Typ | Description |
|---|---|---|
| baseStreet |
string |
Primární ulice pro umístění. |
| displayName |
string |
Úplný název průsečíku |
| intersectionType |
string |
Typ průsečíku |
| secondaryStreet1 |
string |
První protínající ulici. |
| secondaryStreet2 |
string |
Pokud existuje, druhá protíná ulici. |
MatchCodesEnum
Enum představující kód zápasu.
| Hodnota | Description |
|---|---|
| Good |
Dobré |
| Ambiguous |
Mnohoznačný |
| UpHierarchy |
UpHierarchy |
ReverseGeocodingResultTypeEnum
Enum představující typ výsledku reverzního geokódování.
| Hodnota | Description |
|---|---|
| Address |
Address |
| Neighborhood |
Sousedství |
| PopulatedPlace |
PopulatedPlace |
| Postcode1 |
Psč1 |
| AdminDivision1 |
AdminDivision1 |
| AdminDivision2 |
AdminDivision2 |
| CountryRegion |
Stát/Kraj |
UsageTypeEnum
Enum představující typ použití.
| Hodnota | Description |
|---|---|
| Display |
Display |
| Route |
Cesta |