Search - Get Reverse Geocoding

Reference

Service:: Maps

API Version:: 2023-06-01

Slouží k získání adresy a polohy ze souřadnic zeměpisné délky a zeměpisné šířky.

Rozhraní Get Reverse Geocoding API je požadavek HTTP GET , který se používá k překladu souřadnic (například 37.786505, -122.3862) na srozumitelnou adresu. Užitečné při sledování aplikací, kde přijímáte informační kanál GPS ze zařízení nebo prostředku a chcete znát adresu spojenou se souřadnicemi. Tento koncový bod vrátí informace o adrese pro danou souřadnici.

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}

With optional parameters:

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
api-version	query	True	string	Číslo verze rozhraní API Azure Maps.
coordinates	query	True	number[]	Souřadnice umístění, které chcete převést na geokódování. Příklad: &coordinates=lon,lat
resultTypes	query		ReverseGeocodingResultTypeEnum[]	Zadejte typy entit, které chcete v odpovědi použít. Vrátí se pouze typy, které zadáte. Pokud bod nelze mapovat na typy entit, které zadáte, v odpovědi se nevrátí žádné informace o poloze. Výchozí hodnota jsou všechny možné entity. Seznam typů entit oddělených čárkami vybraných z následujících možností Adresa Okolí Vyplněné místo PSČ1 AdminDivision1 AdminDivision2 CountryRegion Tyto typy entit jsou seřazené od nejkonsekvnější entity k nejméně konkrétní entitě. Pokud se najdou entity s více než jedním typem entity, vrátí se pouze nejkonvičtější entita. Pokud například zadáte Address 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, který představuje iso 3166-1 Alpha-2 kód oblasti nebo 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 nedefinoval. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-id		string	Určuje, který účet je určen pro použití ve spojení s modelem zabezpečení Azure AD. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Azure AD zabezpečení v Azure Maps pokyny najdete v následujících článcích.
Accept-Language		string	Jazyk, ve kterém se mají vrátit výsledky hledání. Podrobnosti najdete v části Podporované jazyky .

Name

Vyžadováno

Typ

Description

x-ms-client-id

string

Určuje, který účet je určen pro použití ve spojení s modelem zabezpečení Azure AD. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Azure AD zabezpečení v Azure Maps pokyny najdete v následujících článcích.

Accept-Language

string

Jazyk, ve kterém se mají vrátit výsledky hledání.

Podrobnosti najdete v části Podporované jazyky .

Odpovědi

Name	Typ	Description
200 OK	GeocodingResponse	OK Media Types: "application/geo+json"
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě. Media Types: "application/geo+json"

Name

Typ

Description

200 OK

GeocodingResponse

Media Types: "application/geo+json"

Other Status Codes

ErrorResponse

Došlo k neočekávané chybě.

Media Types: "application/geo+json"

Zabezpečení

AADToken

Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.

Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.

Poznámka

Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
Je Authorization URL specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
Použití sady Azure Maps Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.

Type: 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

Jedná se o sdílený klíč, který se zřizuje při vytváření prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto klíčem má každá aplikace autorizaci pro přístup ke všem rozhraním REST API. Jinými slovy, ty je v současné době možné považovat za hlavní klíče k účtu, pro který jsou vystavené.

U veřejně vystavených aplikací doporučujeme použít přístup mezi servery Azure Maps rozhraní REST API, kde je možné tento klíč bezpečně uložit.

Type: apiKey
In: header

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v Azure Maps prostředku prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečeným způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.

Type: apiKey
In: header

Příklady

Search point -122.138681, 47.630358

Sample Request

HTTP

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=-122.138681,47.630358

Sample Response

Status code:: 200

Content-Type: application/geo+json

Response Body

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "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
AdminDistricts	Název dílčího dělení v zemi nebo oblasti pro adresu. Tento prvek je obvykle považován za pododdíl správy prvního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté dělení pořadí v zemi, závislosti nebo oblasti.
CalculationMethodEnum	Metoda, která se použila k výpočtu bodu geografického kódu.
ConfidenceEnum	Úroveň spolehlivosti, kterou výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte spolu s kódem shody k určení úplnějších informací o shodě. Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geograficky zakódovaného umístění a polohy uživatele, pokud je zadána.
CountryRegion
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě
ErrorResponse	Chybová odpověď
FeatureCollectionEnum	Typ FeatureCollection objektu musí být FeatureCollection.
FeaturesItem
FeatureTypeEnum	Typ funkce musí být Funkce.
GeocodePoints	Kolekce bodů geografického kódu, které se liší ve způsobu jejich výpočtu a navrhovaném použití.
GeocodingResponse	Tento objekt se vrátí z úspěšného volání geokódování.
GeoJsonPoint	Platný `GeoJSON Point` typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Intersection	Adresa výsledku
MatchCodesEnum	Jedna nebo více hodnot kódu shody, které představují úroveň geografického kódování pro každé umístění v odpovědi. Například geokódované umístění s odpovídajícími kódy `Good` a `Ambiguous` znamená, že pro informace o poloze bylo nalezeno více než jedno umístění geografického kódu a že služba geografického kódu neměla vyhledávání v hierarchii, aby našla shodu. Podobně geograficky zakódované umístění s kódy shody a `UpHierarchy` znamená, že nebylo nalezeno umístění geografického `Ambiguous` kódu, které by odpovídalo všem zadaným informacím o poloze, takže služba geografického kódu musela vyhledat hierarchii a najít více shod na této úrovni. Příklad výsledku `Ambiguous` a `UpHierarchy` je, když zadáte úplné informace o adrese, ale služba geografického kódu nemůže najít shodu pro adresu a místo toho vrátí informace pro více než jednu hodnotu RoadBlock. Možné hodnoty jsou: `Good`: Umístění má pouze jednu shodu nebo se všechny vrácené shody považují za silné shody. Například dotaz na New York vrátí několik dobrých shod. `Ambiguous`: Umístění je jednou ze sady možných shod. Například při dotazu na adresu ulice 128 Main St., odpověď může vrátit dvě umístění pro 128 North Main St. a 128 South Main St. , protože není k dispozici dostatek informací k určení, kterou možnost zvolit. `UpHierarchy`: Umístění představuje přesun v geografické hierarchii nahoru. K tomu dochází v případě, že nebyla nalezena shoda s žádostí o umístění, takže se vrátí méně přesný výsledek. Pokud se například nepodaří najít shodu požadované adresy, může se vrátit kód `UpHierarchy` shody s typem entity RoadBlock.
Properties
ReverseGeocodingResultTypeEnum	Zadejte typy entit, které chcete v odpovědi použít. Vrátí se pouze typy, které zadáte. Pokud bod nelze mapovat na typy entit, které zadáte, v odpovědi se nevrátí žádné informace o poloze. Výchozí hodnota jsou všechny možné entity. Seznam typů entit oddělených čárkami vybraných z následujících možností Adresa Okolí Vyplněné místo PSČ1 AdminDivision1 AdminDivision2 CountryRegion Tyto typy entit jsou seřazené od nejkonsekvnější entity k nejméně konkrétní entitě. Pokud se najdou entity s více než jedním typem entity, vrátí se pouze nejkonvičtější entita. Pokud například zadáte Address a AdminDistrict1 jako typy entit a entity byly nalezeny pro oba typy, vrátí se v odpovědi pouze informace o entitě Adresa.
UsageTypeEnum	Nejvhodnější použití pro bod geografického kódu. Každý bod geografického `Route` kódu je definován jako bod, `Display` bod nebo obojí. Pokud vytváříte trasu k umístění, použijte `Route` body. Pokud zobrazujete místo na mapě, použijte `Display` body. Pokud je umístěním například park, může bod určovat vstup do parku, `Route` kam můžete vjet autem, a `Display` bod může být bod, který určuje střed parku.

Address

Adresa výsledku

Name	Typ	Description
addressLine	string	AddressLine obsahující název ulice a číslo
adminDistricts	AdminDistricts[]	Název dílčího dělení v zemi nebo oblasti pro adresu. Tento prvek je obvykle považován za pododdíl správy prvního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté dělení pořadí v zemi, závislosti nebo oblasti.
countryRegion	CountryRegion
formattedAddress	string	Vlastnost Formátovaná adresa
intersection	Intersection	Adresa výsledku
locality	string	lokalita nemovitosti
neighborhood	string	nemovitost v sousedství
postalCode	string	Vlastnost PSČ

AdminDistricts

Název dílčího dělení v zemi nebo oblasti pro adresu. Tento prvek je obvykle považován za pododdíl správy prvního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté dělení pořadí v zemi, závislosti nebo oblasti.

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, například 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, například WA, For adminDistrict[1], může to být krátký název okresu.

CalculationMethodEnum

Metoda, která se použila k výpočtu bodu geografického kódu.

Name	Typ	Description
Interpolation	string	Bod geografického kódu byl spárován s bodem na silnici pomocí interpolace.
InterpolationOffset	string	Bod geografického kódu byl spárován s bodem na silnici pomocí interpolace s dodatečným posunem, aby se bod přesunul na stranu ulice.
Parcel	string	Bod geografického kódu byl spárován se středem parcely.
Rooftop	string	Geokódový bod byl spárován se střechou budovy.

ConfidenceEnum

Úroveň spolehlivosti, kterou výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte spolu s kódem shody k určení úplnějších informací o shodě.

Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geograficky zakódovaného umístění a polohy uživatele, pokud je zadána.

Name Typ Description

High

Name	Typ	Description
High	string	Pokud je hodnota spolehlivosti nastavená na `High`, byla nalezena jedna nebo více silných shod. Více `High` shod spolehlivosti je seřazeno v pořadí podle důležitosti, pokud je to možné. Například orientační body mají důležitost, ale adresy ne. Pokud žádost obsahuje umístění nebo zobrazení, může se pořadí odpovídajícím způsobem změnit. Například dotaz na umístění pro "Paříž" vrátí "Paříž, Francie" i "Paříž, TX" oba s `High` jistotou. "Paříž, Francie" je vzhledem k důležitosti vždy na prvním místě, pokud umístění uživatele neukazuje, že se uživatel nachází v Paříži nebo je velmi blízko, TX nebo zobrazení mapy značí, že uživatel hledá v dané oblasti.
Low	string
Medium	string	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 zadat informace o adrese a služba geografického kódu může odpovídat pouze PSČ. Pokud má v tomto případě služba geografického kódu jistotu, že PSČ odpovídá datům, je nastavena hodnota `Medium` spolehlivosti a kód shody je nastaven na `UpHierarchy` hodnotu , aby bylo možné určit, že nemůže odpovídat všem informacím a musel hledat v hierarchii. Pokud jsou informace o poloze v dotazu nejednoznačné a nejsou k dispozici žádné další informace k řazení umístění (například umístění uživatele nebo relativní důležitost umístění), je spolehlivost nastavená na `Medium`hodnotu . Například dotaz na umístění pro "148th Ave, Bellevue" může vrátit "148th Ave SE" a "148th Ave NE" oba s `Medium` jistotou. Pokud informace o poloze v dotazu neposkytují dostatek informací ke geografickému kódování konkrétního umístění, může se vrátit méně přesná hodnota polohy a spolehlivost je nastavená na `Medium`. Pokud je například zadána adresa, ale nenajde se shoda s číslem domu, může se vrátit výsledek geografického kódu s typem entity Roadblock.

string

Pokud je hodnota spolehlivosti nastavená na High, byla nalezena jedna nebo více silných shod. Více High shod spolehlivosti je seřazeno v pořadí podle důležitosti, pokud je to možné. Například orientační body mají důležitost, ale adresy ne.

Pokud žádost obsahuje umístění nebo zobrazení, může se pořadí odpovídajícím způsobem změnit. Například dotaz na umístění pro "Paříž" vrátí "Paříž, Francie" i "Paříž, TX" oba s High jistotou. "Paříž, Francie" je vzhledem k důležitosti vždy na prvním místě, pokud umístění uživatele neukazuje, že se uživatel nachází v Paříži nebo je velmi blízko, TX nebo zobrazení mapy značí, že uživatel hledá v dané oblasti.

Low

string

Medium

string

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 zadat informace o adrese a služba geografického kódu může odpovídat pouze PSČ. Pokud má v tomto případě služba geografického kódu jistotu, že PSČ odpovídá datům, je nastavena hodnota Medium spolehlivosti a kód shody je nastaven na UpHierarchy hodnotu , aby bylo možné určit, že nemůže odpovídat všem informacím a musel hledat v hierarchii.

Pokud jsou informace o poloze v dotazu nejednoznačné a nejsou k dispozici žádné další informace k řazení umístění (například umístění uživatele nebo relativní důležitost umístění), je spolehlivost nastavená na Mediumhodnotu . Například dotaz na umístění pro "148th Ave, Bellevue" může vrátit "148th Ave SE" a "148th Ave NE" oba s Medium jistotou.

Pokud informace o poloze v dotazu neposkytují dostatek informací ke geografickému kódování konkrétního umístění, může se vrátit méně přesná hodnota polohy a spolehlivost je nastavená na Medium. Pokud je například zadána adresa, ale nenajde se shoda s číslem domu, může se vrátit výsledek geografického kódu s typem entity Roadblock.

CountryRegion

Name	Typ	Description
ISO	string	ISO země/oblasti
name	string	název země/oblasti

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva
target	string	Cíl chyby.

ErrorResponse

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

FeatureCollectionEnum

Typ FeatureCollection objektu musí být FeatureCollection.

Name	Typ	Description
FeatureCollection	string

FeaturesItem

Name	Typ	Description
bbox	number[]	Ohraničující rámeček. Použitá projekce - EPSG:3857. Podrobnosti najdete v dokumentu RFC 7946 .
geometry	GeoJsonPoint	Platný `GeoJSON Point` typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
id	string	ID vrácené funkce
properties	Properties
type	FeatureTypeEnum	Typ funkce musí být Funkce.

FeatureTypeEnum

Typ funkce musí být Funkce.

Name	Typ	Description
Feature	string

GeocodePoints

Kolekce bodů geografického kódu, které se liší ve způsobu jejich výpočtu a navrhovaném použití.

Name	Typ	Description
calculationMethod	CalculationMethodEnum	Metoda, která se použila k výpočtu bodu geografického kódu.
geometry	GeoJsonPoint	Platný `GeoJSON Point` typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
usageTypes	UsageTypeEnum[]	Nejvhodnější použití pro bod geografického kódu. Každý bod geografického `Route` kódu je definován jako bod, `Display` bod nebo obojí. Pokud vytváříte trasu k umístění, použijte `Route` body. Pokud zobrazujete místo na mapě, použijte `Display` body. Pokud je umístěním například park, může bod určovat vstup do parku, `Route` kam můžete vjet autem, a `Display` bod může být bod, který určuje střed parku.

GeocodingResponse

Tento objekt se vrátí z úspěšného volání geokódování.

Name	Typ	Description
features	FeaturesItem[]
nextLink	string	Je odkaz na další stránku vrácených funkcí. Pokud se jedná o poslední stránku, toto pole není.
type	FeatureCollectionEnum	Typ FeatureCollection objektu musí být FeatureCollection.

GeoJsonPoint

Platný GeoJSON Point typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .

Name	Typ	Description
bbox	number[]	Ohraničující rámeček. Použitá projekce - EPSG:3857. Podrobnosti najdete v dokumentu RFC 7946 .
coordinates	number[]	A `Position` je matice čísel se dvěma nebo více prvky. První dva prvky jsou zeměpisná délka a zeměpisná šířka, přesně v daném pořadí. Třetím prvkem je nadmořská výška nebo nadmořská výška. Podrobnosti najdete v dokumentu RFC 7946 .
type	string: Point	Určuje `GeoJSON` typ. Musí být jedním z devíti platných typů objektů GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature a FeatureCollection.

Intersection

Adresa výsledku

Name	Typ	Description
baseStreet	string	Primární ulice pro umístění.
displayName	string	Úplný název průniku
intersectionType	string	Typ průniku.
secondaryStreet1	string	První protínající se ulice.
secondaryStreet2	string	Pokud existuje, druhá ulice se protíná.

MatchCodesEnum

Jedna nebo více hodnot kódu shody, které představují úroveň geografického kódování pro každé umístění v odpovědi.

Například geokódované umístění s odpovídajícími kódy Good a Ambiguous znamená, že pro informace o poloze bylo nalezeno více než jedno umístění geografického kódu a že služba geografického kódu neměla vyhledávání v hierarchii, aby našla shodu.

Podobně geograficky zakódované umístění s kódy shody a UpHierarchy znamená, že nebylo nalezeno umístění geografického Ambiguous kódu, které by odpovídalo všem zadaným informacím o poloze, takže služba geografického kódu musela vyhledat hierarchii a najít více shod na této úrovni. Příklad výsledku Ambiguous a UpHierarchy je, když zadáte úplné informace o adrese, ale služba geografického kódu nemůže najít shodu pro adresu a místo toho vrátí informace pro více než jednu hodnotu RoadBlock.

Možné hodnoty jsou:

Good: Umístění má pouze jednu shodu nebo se všechny vrácené shody považují za silné shody. Například dotaz na New York vrátí několik dobrých shod.

Ambiguous: Umístění je jednou ze sady možných shod. Například při dotazu na adresu ulice 128 Main St., odpověď může vrátit dvě umístění pro 128 North Main St. a 128 South Main St. , protože není k dispozici dostatek informací k určení, kterou možnost zvolit.

UpHierarchy: Umístění představuje přesun v geografické hierarchii nahoru. K tomu dochází v případě, že nebyla nalezena shoda s žádostí o umístění, takže se vrátí méně přesný výsledek. Pokud se například nepodaří najít shodu požadované adresy, může se vrátit kód UpHierarchy shody s typem entity RoadBlock.

Name	Typ	Description
Ambiguous	string
Good	string
UpHierarchy	string

Properties

Name	Typ	Description
address	Address	Adresa výsledku
confidence	ConfidenceEnum	Úroveň spolehlivosti, kterou výsledek geokódovaného umístění odpovídá. Tuto hodnotu použijte spolu s kódem shody k určení úplnějších informací o shodě. Spolehlivost geokódovaného umístění je založená na mnoha faktorech, včetně relativní důležitosti geograficky zakódovaného umístění a polohy uživatele, pokud je zadána.
geocodePoints	GeocodePoints[]	Kolekce bodů geografického kódu, které se liší ve způsobu jejich výpočtu a navrhovaném použití.
matchCodes	MatchCodesEnum[]	Jedna nebo více hodnot kódu shody, které představují úroveň geografického kódování pro každé umístění v odpovědi. Například geokódované umístění s odpovídajícími kódy `Good` a `Ambiguous` znamená, že pro informace o poloze bylo nalezeno více než jedno umístění geografického kódu a že služba geografického kódu neměla vyhledávání v hierarchii, aby našla shodu. Podobně geograficky zakódované umístění s kódy shody a `UpHierarchy` znamená, že nebylo nalezeno umístění geografického `Ambiguous` kódu, které by odpovídalo všem zadaným informacím o poloze, takže služba geografického kódu musela vyhledat hierarchii a najít více shod na této úrovni. Příklad výsledku `Ambiguous` a `UpHierarchy` je, když zadáte úplné informace o adrese, ale služba geografického kódu nemůže najít shodu pro adresu a místo toho vrátí informace pro více než jednu hodnotu RoadBlock. Možné hodnoty jsou: `Good`: Umístění má pouze jednu shodu nebo se všechny vrácené shody považují za silné shody. Například dotaz na New York vrátí několik dobrých shod. `Ambiguous`: Umístění je jednou ze sady možných shod. Například při dotazu na adresu ulice 128 Main St., odpověď může vrátit dvě umístění pro 128 North Main St. a 128 South Main St. , protože není k dispozici dostatek informací k určení, kterou možnost zvolit. `UpHierarchy`: Umístění představuje přesun v geografické hierarchii nahoru. K tomu dochází v případě, že nebyla nalezena shoda s žádostí o umístění, takže se vrátí méně přesný výsledek. Pokud se například nepodaří najít shodu požadované adresy, může se vrátit kód `UpHierarchy` shody s typem entity RoadBlock.
type	string	Jedna z těchto možností: Adresa Překážku Silničníintersection Okolí Vyplněné místo PSČ1 AdminDivision1 AdminDivision2 CountryRegion

ReverseGeocodingResultTypeEnum

Zadejte typy entit, které chcete v odpovědi použít. Vrátí se pouze typy, které zadáte. Pokud bod nelze mapovat na typy entit, které zadáte, v odpovědi se nevrátí žádné informace o poloze. Výchozí hodnota jsou všechny možné entity. Seznam typů entit oddělených čárkami vybraných z následujících možností

Adresa
Okolí
Vyplněné místo
PSČ1
AdminDivision1
AdminDivision2
CountryRegion

Tyto typy entit jsou seřazené od nejkonsekvnější entity k nejméně konkrétní entitě. Pokud se najdou entity s více než jedním typem entity, vrátí se pouze nejkonvičtější entita. Pokud například zadáte Address a AdminDistrict1 jako typy entit a entity byly nalezeny pro oba typy, vrátí se v odpovědi pouze informace o entitě Adresa.

Name	Typ	Description
Address	string
AdminDivision1	string
AdminDivision2	string
CountryRegion	string
Neighborhood	string
PopulatedPlace	string
Postcode1	string

UsageTypeEnum

Nejvhodnější použití pro bod geografického kódu. Každý bod geografického Route kódu je definován jako bod, Display bod nebo obojí. Pokud vytváříte trasu k umístění, použijte Route body. Pokud zobrazujete místo na mapě, použijte Display body. Pokud je umístěním například park, může bod určovat vstup do parku, Route kam můžete vjet autem, a Display bod může být bod, který určuje střed parku.

Name	Typ	Description
Display	string
Route	string

Share via

Search - Get Reverse Geocoding

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

AADToken

Scopes

subscription-key

SAS Token

Příklady

Search point -122.138681, 47.630358

Sample Request

Sample Response

Definice

Address

AdminDistricts

CalculationMethodEnum

ConfidenceEnum

CountryRegion

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureCollectionEnum

FeaturesItem

FeatureTypeEnum

GeocodePoints

GeocodingResponse

GeoJsonPoint

Intersection

MatchCodesEnum

Properties

ReverseGeocodingResultTypeEnum

UsageTypeEnum

Další materiály