Search - Get Search POI

Reference

Service:: Maps

API Version:: 1.0

Slouží k vyhledání bodů zájmu podle názvu.

Rozhraní Points of Interest (POI) Search API je požadavek HTTP GET , který umožňuje vyžádat si výsledky poi podle názvu. Podporuje také další parametry dotazů, jako je jazyk a filtrování výsledků podle oblasti zájmu podle země/oblasti nebo ohraničujícího rámečku. Koncový bod vrátí pouze výsledky poi odpovídající řetězci dotazu. Odpověď obsahuje podrobnosti o poi, jako je adresa, umístění souřadnic a kategorie.

GET https://atlas.microsoft.com/search/poi/{format}?api-version=1.0&query={query}

With optional parameters:

GET https://atlas.microsoft.com/search/poi/{format}?api-version=1.0&query={query}&typeahead={typeahead}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&lat={lat}&lon={lon}&radius={radius}&topLeft={topLeft}&btmRight={btmRight}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&brandSet={brandSet}&connectorSet={connectorSet}&view={view}&openingHours=nextSevenDays

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
format	path	True	ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
api-version	query	True	string	Číslo verze rozhraní API Azure Maps.
query	query	True	string	Název poi, který chcete vyhledat (např. "socha svobody", "starbucks"), musí být správně zakódovaný na adrese URL.
brandSet	query		string[]	Seznam názvů značek oddělených čárkami, který lze použít k omezení výsledku na konkrétní značky. Na pořadí položek nezáleží. Pokud je k dispozici více značek, vrátí se pouze výsledky, které patří do (alespoň) jedné ze zadaných značek. Značky, které v názvu obsahují ",", by měly být vloženy do uvozovek. Příklady použití: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C Čárka",Pruh
btmRight	query		string	Umístění pravého dolního ohraničujícího rámečku Např. 37,553,-122,453
categorySet	query		integer[]	Seznam ID sad kategorií oddělený čárkami, který lze použít k omezení výsledku na konkrétní kategorie Bodů zájmu. Na pořadí ID nezáleží. Maximální počet podporovaných `categorySet` hodnot na žádost je 10. Pokud je k dispozici více identifikátorů kategorií, budou vráceny pouze poi, které patří (alespoň) do jedné z kategorií ze zadaného seznamu. Seznam podporovaných kategorií je možné zjistit pomocí rozhraní API kategorií poi . Příklady použití: categorySet=7315 (Search z kategorie Restaurace) categorySet=7315025,7315017 (Search zajímavá místa kategorie Italská nebo francouzská restaurace)
connectorSet	query		ElectricVehicleConnector[]	Seznam typů konektorů oddělených čárkami, které lze použít k omezení výsledku na stanici elektrických vozidel podporujících konkrétní typy konektorů. Na pořadí položek nezáleží. Pokud je k dispozici více typů konektorů, vrátí se pouze výsledky, které patří (alespoň) do jednoho ze zadaného seznamu. Dostupné typy konektorů: `StandardHouseholdCountrySpecific` - Jedná se o standardní konektory pro domácnost pro určitou oblast. Všechny jsou střídavý jednofázový a standardní Napěťový a standardní Amperage. Viz také: Typy zásuvek & zásuvky – světové standardy. `IEC62196Type1` - Konektor typu 1 podle definice ve standardu IEC 62196-2. Také se nazývá Yazaki po původním výrobci nebo SAE J1772 po standardu, který ho poprvé publikoval. Nejčastěji se používá v kombinaci s 120V jednofázovou nebo až 240V jednofázovou infrastrukturou. `IEC62196Type1CCS` - Kombinovaný konektor typu 1 podle definice v normě IEC 62196-3. Konektor je založen na konektoru typu 1 – jak je definováno ve standardu IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem. `IEC62196Type2CableAttached` - Konektor typu 2 podle definice v normě IEC 62196-2. K dispozici jako kabel a zástrčka připojená k nabíjecímu bodu. `IEC62196Type2Outlet` - Konektor typu 2 podle definice v normě IEC 62196-2. K dispozici jako zásuvka nastavená do nabíjecího bodu. `IEC62196Type2CCS` - Kombinovaný konektor typu 2 podle definice ve standardu IEC 62196-3. Konektor je založen na konektoru typu 2 – jak je definováno ve standardu IEC 62196-2 – se dvěma dodatečnými kontakty stejnosměrný proud (DC), které umožňují rychlé nabíjení stejnosměrným proudem. `IEC62196Type3` - Konektor typu 3 podle definice v normě IEC 62196-2. Také se nazývá Scame podle původního výrobce. Nejčastěji se používá v kombinaci s až 240V jednofázovou nebo až 420V třífázovou infrastrukturou. `Chademo` - Konektor CHAdeMO pojmenovaný podle asociace, kterou vytvořila Tokyo Electric Power Company a průmysloví partneři. Z tohoto důvodu se také označuje jako konektor TEPCO. Podporuje rychlé dc nabíjení. `IEC60309AC1PhaseBlue` - Konektor Industrial Blue je konektor definovaný ve standardu IEC 60309. Někdy se označuje jako nějaká kombinace standardu, barvy a skutečnosti, že je jednofázová spojnice. Konektor má obvykle konfiguraci P+N+E, 6h. `IEC60309DCWhite` - Konektor Industrial White je stejnosměrný konektor definovaný ve standardu IEC 60309. `Tesla` - Konektor Tesla je regionálně specifický konektor Tesla Supercharger. To znamená, že se odkazuje buď na proprietární konektor Tesly, někdy označovaný jako Tesla Port, většinou omezený na Severní Amerika, nebo upravený typ 2 (DC nad typem 2) v Evropě. Příklady použití: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
countrySet	query		string[]	Čárkami oddělený řetězec s kódy země/oblasti, např. FR, ES. Tím se hledání omezí na zadané země nebo oblasti.
extendedPostalCodesFor	query		PointOfInterestExtendedPostalCodes[]	Indexy, jejichž rozšířená POŠTOVNÍ SMĚROVACÍ ČÍSLA by měla být zahrnuta do výsledků. Dostupné indexy jsou: POI = body zájmu Pokud chcete zakázat rozšířená PSČ, hodnota by měla být POI nebo Žádná . Ve výchozím nastavení jsou zahrnuta rozšířená POŠTOVNÍ SMĚROVACÍ ČÍSLA. Příklady použití: extendedPostalCodesFor=POI extendedPostalCodesFor=None Rozšířené PSČ se vrátí jako vlastnost extendedPostalCode adresy. Dostupnost závisí na oblasti.
language	query		string	Jazyk, ve kterém se mají vrátit výsledky hledání. Měl by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole k dispozici, použije se výchozí jazyk. Podrobnosti najdete v části Podporované jazyky .
lat	query		number double	Zeměpisná šířka, kde by výsledky měly být zkreslené. Např. 37,337
limit	query		integer	Maximální počet odpovědí, které budou vráceny. Výchozí hodnota: 10, minimum: 1 a maximum: 100
lon	query		number double	Zeměpisná délka, kde by výsledky měly být zkreslené. Například -121,89
ofs	query		integer	Počáteční posun vrácených výsledků v rámci celé sady výsledků. Výchozí hodnota: 0
openingHours	query		OperatingHoursRange	Provozní doba pro bod zájmu (Body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se nepředá, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays
radius	query		integer	Poloměr v metrech k pro výsledky, které mají být omezeny na definovanou oblast
topLeft	query		string	Levá horní pozice ohraničujícího rámečku. Např. 37,553,-122,453
typeahead	query		boolean	Boolean. Pokud je nastaven příznak hlavičky typeahead, dotaz se interpretuje jako částečný vstup a hledání přejde do prediktivního režimu.
view	query		LocalizedMapView	Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení těchto oblastí a parametr Zobrazení umožňuje, aby vaše aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified" i v případě, že jste ho v požadavku nedefinovali. Je na vás, abyste určili umístění uživatelů a pak pro toto umístění správně nastavili parametr View. Alternativně můžete nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení v Azure Maps musí být použit v souladu s platnými zákony, včetně těch týkajících se mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím Azure Maps. Příklad: view=IN. 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í Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a dá se načíst z rozhraní API účtu Azure Maps roviny správy. Pokud chcete použít zabezpečení Microsoft Entra ID v Azure Maps pokyny najdete v následujících článcích.

Odpovědi

Name	Typ	Description
200 OK	SearchAddressResult	OK
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě.

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, která se skládá 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 k určitým rozhraním API a oborům.

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. To je možné získat z rozhraní API pro správu map .
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řídí při vytvoření účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto klíčem může každá aplikace přistupovat ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve kterému je vystavený.

U veřejně vystavených aplikací doporučujeme pro přístup k Azure Maps rozhraní REST API použít přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.

Type: apiKey
In: query

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 for juice bars within 5 miles of Seattle Downtown and limit the response to 5 results

Sample Request

HTTP

GET https://atlas.microsoft.com/search/poi/json?api-version=1.0&query=juice bars&limit=5&lat=47.606038&lon=-122.333345&radius=8046&openingHours=nextSevenDays

Sample Response

Status code:: 200

{
  "summary": {
    "query": "juice bars",
    "queryType": "NON_NEAR",
    "queryTime": 36,
    "numResults": 5,
    "offset": 0,
    "totalResults": 12,
    "fuzzyLevel": 1,
    "geoBias": {
      "lat": 47.606038,
      "lon": -122.333345
    }
  },
  "results": [
    {
      "type": "POI",
      "id": "US/POI/p0/9223158",
      "score": 5.664,
      "dist": 667.2710170950347,
      "info": "search:ta:840539001755244-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-6240804",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "400",
        "streetName": "Pine St",
        "municipalitySubdivision": "Seattle, Central Business District",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98101",
        "extendedPostalCode": "981011628",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "400 Pine St, Seattle, WA 98101",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61138,
        "lon": -122.3374
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61228,
          "lon": -122.33873
        },
        "btmRightPoint": {
          "lat": 47.61048,
          "lon": -122.33607
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61134,
            "lon": -122.33737
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9222534",
      "score": 5.663,
      "dist": 1101.6849025777728,
      "info": "search:ta:840539001760125-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-4533785",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "315",
        "streetName": "E Pine St",
        "municipalitySubdivision": "Seattle, Broadway",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98122",
        "extendedPostalCode": "9812200",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "315 E Pine St, Seattle, WA 98122",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61518,
        "lon": -122.32768
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61608,
          "lon": -122.32901
        },
        "btmRightPoint": {
          "lat": 47.61428,
          "lon": -122.32635
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61523,
            "lon": -122.32768
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9133689",
      "score": 5.659,
      "dist": 2649.8700791555398,
      "info": "search:ta:840539001339220-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-2820651",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "604",
        "streetName": "1st Ave N",
        "municipalitySubdivision": "Seattle, Lower Queen Anne",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98109",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "604 1st Ave N, Seattle, WA 98109",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.6247,
        "lon": -122.35533
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.6256,
          "lon": -122.35666
        },
        "btmRightPoint": {
          "lat": 47.6238,
          "lon": -122.354
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6247,
            "lon": -122.3554
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9131285",
      "score": 5.646,
      "dist": 5097.757019046541,
      "info": "search:ta:840539001743255-US",
      "poi": {
        "name": "Custom Smoothie & Sports Nutrition",
        "phone": "+(1)-(206)-5475522",
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.customsmoothie.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "462",
        "streetName": "N 34th St",
        "municipalitySubdivision": "Seattle, Fremont",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981038600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "462 N 34th St, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.65016,
        "lon": -122.35182
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.65106,
          "lon": -122.35315
        },
        "btmRightPoint": {
          "lat": 47.64926,
          "lon": -122.35049
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.64991,
            "lon": -122.3519
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9228250",
      "score": 5.637,
      "dist": 6235.798481758295,
      "info": "search:ta:840531000416784-US",
      "poi": {
        "name": "Jamba Juice",
        "phone": "+(1)-(206)-6322060",
        "brands": [
          {
            "name": "Jamba Juice"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.jambajuice.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "4555",
        "streetName": "Stone Way N",
        "municipalitySubdivision": "Wallingford, Seattle",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981036600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "4555 Stone Way N, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.66179,
        "lon": -122.34233
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.66269,
          "lon": -122.34367
        },
        "btmRightPoint": {
          "lat": 47.66089,
          "lon": -122.34099
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.66188,
            "lon": -122.34211
          }
        }
      ]
    }
  ]
}

Definice

Name	Description
Address	Adresa výsledku
AddressRanges	Popisuje rozsah adres na obou stranách ulice pro výsledek hledání. Jsou zahrnuté souřadnice počátečního a koncového umístění rozsahu adres.
BoundingBox	Zobrazení, které pokrývá výsledek představovaný souřadnicemi vlevo nahoře a vpravo dole v oblasti zobrazení.
BoundingBoxCompassNotation	Ohraničující rámeček umístění.
Brand	Značka přidružená k poi
Classification	Klasifikace pro vrácené BŽS
ClassificationName	Název klasifikace
DataSources	Volitelný oddíl. Referenční ID pro použití s rozhraním Get Search Polygon API
ElectricVehicleConnector	Seznam typů konektorů oddělených čárkami, které lze použít k omezení výsledku na stanici elektrických vozidel podporujících konkrétní typy konektorů. Na pořadí položek nezáleží. Pokud je k dispozici více typů konektorů, budou vráceny pouze výsledky, které patří do (alespoň) jednoho ze zadaného seznamu. Dostupné typy konektorů jsou: `StandardHouseholdCountrySpecific` - Jedná se o standardní konektory pro domácnost pro určitou oblast. Všechny jsou jednofázové ac a standardní napěťové a standardní amperáže. Viz také: Typy zásuvek & – světové standardy. `IEC62196Type1` - Konektor typu 1 podle definice v normě IEC 62196-2. Také se nazývá Yazaki podle původního výrobce nebo SAE J1772 podle normy, která ji poprvé publikovala. Nejčastěji se používá v kombinaci s jednofázovou infrastrukturou 120V nebo až 240V jednofázovou infrastrukturou. `IEC62196Type1CCS` - Kombinovaný konektor typu 1 podle definice ve standardu IEC 62196-3. Konektor je založen na konektoru typu 1 – jak je definováno ve standardu IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem. `IEC62196Type2CableAttached` - Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako kabel a zástrčka připojená k nabíjecímu bodu. `IEC62196Type2Outlet` - Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako zásuvka nastavená do nabíjecího bodu. `IEC62196Type2CCS` - Kombinovaný konektor typu 2 podle definice v normě IEC 62196-3. Konektor je založen na konektoru typu 2 – jak je definováno v normě IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem. `IEC62196Type3` - Konektor typu 3 podle definice v normě IEC 62196-2. Také se nazývá Scame podle původního výrobce. Nejčastěji se používá v kombinaci s až 240V jednofázovou nebo až 420V třífázovou infrastrukturou. `Chademo` - Konektor CHAdeMO pojmenovaný podle sdružení, které vytvořila Tokyo Electric Power Company a průmyslové partnery. Z tohoto důvodu se také označuje jako konektor TEPCO. Podporuje rychlé dc nabíjení. `IEC60309AC1PhaseBlue` - Konektor Industrial Blue je konektor definovaný ve standardu IEC 60309. Někdy se označuje jako nějaká kombinace standardu, barvy a skutečnosti, že je jednofázová spojnice. Konektor má obvykle konfiguraci P+N+E, 6h. `IEC60309DCWhite` - Konektor Industrial White je stejnosměrný konektor definovaný ve standardu IEC 60309. `Tesla` - Konektor Tesla je regionálně specifický konektor Tesla Supercharger. To znamená, že odkazuje buď na proprietární konektor Tesly, někdy označovaný jako tesla port, většinou omezený na Severní Amerika, nebo na upravený typ 2 (DC přes typ 2) v Evropě. Příklady použití: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
Entity	Zdroj typu entity ohraničujícího rámečku. Pro reverzní geokódování je to vždy stejné jako pozice.
EntryPoint	Vstupní bod pro vrácené BŽ.
EntryPointType	Typ vstupního bodu. Hodnota může být hlavní nebo vedlejší.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě
ErrorResponse	Chybová odpověď
GeographicEntityType	Typ entity Zeměpis. K dispozici pouze v případech, kdy byl požadován typ entity a je k dispozici.
Geometry	Informace o geometrickém tvaru výsledku. Je k dispozici pouze v případě, že zadáte == Zeměpis.
LatLongPairAbbreviated	Umístění vyjádřené jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".
LocalizedMapView	Parametr View (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení takových oblastí a parametr View umožňuje, aby aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified", i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak pro toto umístění správně nastavit parametr View. Případně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr View v Azure Maps musí být použit v souladu s platnými zákony, včetně těch, které se týkají mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím Azure Maps jsou dostupné. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
MatchType	Typy shody pro operaci zpětného vyhledávání adres
OperatingHours	Otevírací doba pro poi (body zájmu)
OperatingHoursRange	Provozní doba pro bod zájmu (Body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se nepředá, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays
OperatingHoursTime	Představuje datum a čas.
OperatingHoursTimeRange	Otevřený časový rozsah pro den
PointOfInterest	Podrobnosti o vrácených poi, včetně informací, jako je jméno, telefon, adresa URL a klasifikace
PointOfInterestCategorySet	Kategorie POI
PointOfInterestExtendedPostalCodes	Indexy, jejichž rozšířená PSČ by měla být zahrnuta do výsledků. Dostupné indexy jsou: POI = body zájmu Pokud chcete zakázat rozšířená PSČ, hodnota by měla být BŽ neboŽádná . Ve výchozím nastavení jsou zahrnuta rozšířená PSČ. Příklady použití: extendedPostalCodesFor=POI extendedPostalCodesFor=None Rozšířené PSČ se vrátí jako vlastnost extendedPostalCode adresy. Dostupnost závisí na oblasti.
QueryType	Typ vráceného dotazu: BLÍZKÉ nebo NON_NEAR.
ResponseFormat	Požadovaný formát odpovědi. Hodnota může být json nebo xml.
SearchAddressResult	Tento objekt je vrácen z úspěšných volání Search.
SearchAddressResultItem	Objekt Result pro odpověď rozhraní API Search.
SearchAddressResultType	Jedna z těchto možností: POI Ulice Geografie Adresa bodu Rozsah adres Křížová ulice
SearchSummary	Souhrnný objekt pro odpověď rozhraní API Search.

Address

Adresa výsledku

Name	Typ	Description
boundingBox	BoundingBoxCompassNotation	Ohraničující rámeček umístění.
buildingNumber	string	Číslo budovy na ulici. ZASTARALÉ, použijte místo toho streetNumber.
country	string	název země/oblasti
countryCode	string	Země (Poznámka: Toto je dvoumísmenný kód, nikoli název země/oblasti.)
countryCodeISO3	string	Kód země ISO alfa-3
countrySecondarySubdivision	string	County
countrySubdivision	string	Země/region nebo kraj
countrySubdivisionCode	string	`countrySubdivisionCode` s předponou `countryCode` ( countryCode-countrySubdivisionCode ) a spojovník tvoří kód ISO 3166-2. Příklady: TX pro Texas, SCT pro Skotsko a ON pro Ontario.
countrySubdivisionName	string	Úplný název první úrovně hierarchie správy země/oblasti. Toto pole se zobrazí pouze v případě, že se countrySubdivision zobrazí ve zkrácené podobě. Podporováno pouze pro USA, Kanadu a Spojené království.
countryTertiarySubdivision	string	Pojmenovaná oblast
crossStreet	string	Název ulice, která je překřížena.
extendedPostalCode	string	Rozšířené PSČ (dostupnost závisí na oblasti).
freeformAddress	string	Řádek adresy formátovaný podle pravidel formátování země/oblasti původu výsledku nebo v případě země/oblasti úplný název země/oblasti.
localName	string	Komponenta adresy, která představuje název zeměpisné oblasti nebo lokality, která seskupuje více adresovatelných objektů pro účely adresování, aniž by to byla jednotka pro správu. Toto pole slouží k sestavení `freeformAddress` vlastnosti. `localName` zastupuje poštovní obec. V závislosti na umístění `localName` je běžně známý název města nebo města. Pro běžně známý název města nebo města použijte `localName` místo `municipality`.
municipality	string	Město / město Poznámka: `municipality` představuje obytnou obec. V závislosti na umístění `municipality` se hodnota může lišit od běžně známého názvu města nebo města. Pro běžně známý název města se doporučuje `localName` místo hodnoty použít `municipality` hodnotu.
municipalitySubdivision	string	Sub / Super City
neighbourhood	string	Sousedství je geograficky lokalizovaná oblast v rámci města nebo města s výraznými charakteristikami a sociálními interakcemi mezi obyvateli.
postalCode	string	PSČ
routeNumbers	string[]	Kódy používané k jednoznačné identifikaci ulice
street	string	Název ulice. ZASTARALÉ, použijte místo toho streetName.
streetName	string	Název ulice.
streetNameAndNumber	string	Název ulice a číslo.
streetNumber	string	Číslo budovy na ulici.

AddressRanges

Popisuje rozsah adres na obou stranách ulice pro výsledek hledání. Jsou zahrnuté souřadnice počátečního a koncového umístění rozsahu adres.

Name	Typ	Description
from	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".
rangeLeft	string	Rozsah adres na levé straně ulice.
rangeRight	string	Rozsah adres na pravé straně ulice.
to	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".

BoundingBox

Zobrazení, které pokrývá výsledek představovaný souřadnicemi vlevo nahoře a vpravo dole v oblasti zobrazení.

Name	Typ	Description
btmRightPoint	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".
topLeftPoint	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".

BoundingBoxCompassNotation

Ohraničující rámeček umístění.

Name	Typ	Description
entity	Entity	Zdroj typu entity ohraničujícího rámečku. Pro reverzní geokódování je to vždy stejné jako pozice.
northEast	string	Severní a východní zeměpisná šířka, souřadnice délky ohraničujícího rámečku jako čárkami oddělené floaty
southWest	string	Jihovýchodní zeměpisná šířka, souřadnice délky ohraničujícího rámečku jako plovoucí čárky oddělené čárkami

Brand

Značka přidružená k poi

Name	Typ	Description
name	string	Název značky

Classification

Klasifikace pro vrácené BŽS

Name	Typ	Description
code	string	Vlastnost kódu
names	ClassificationName[]	Pole Názvů

ClassificationName

Název klasifikace

Name	Typ	Description
name	string	Name – vlastnost
nameLocale	string	Vlastnost Name Locale

DataSources

Volitelný oddíl. Referenční ID pro použití s rozhraním Get Search Polygon API

Name	Typ	Description
geometry	Geometry	Informace o geometrickém tvaru výsledku. Je k dispozici pouze v případě, že zadáte == Zeměpis.

ElectricVehicleConnector

Seznam typů konektorů oddělených čárkami, které lze použít k omezení výsledku na stanici elektrických vozidel podporujících konkrétní typy konektorů. Na pořadí položek nezáleží. Pokud je k dispozici více typů konektorů, budou vráceny pouze výsledky, které patří do (alespoň) jednoho ze zadaného seznamu.

Dostupné typy konektorů jsou:

StandardHouseholdCountrySpecific - Jedná se o standardní konektory pro domácnost pro určitou oblast. Všechny jsou jednofázové ac a standardní napěťové a standardní amperáže. Viz také: Typy zásuvek & – světové standardy.
IEC62196Type1 - Konektor typu 1 podle definice v normě IEC 62196-2. Také se nazývá Yazaki podle původního výrobce nebo SAE J1772 podle normy, která ji poprvé publikovala. Nejčastěji se používá v kombinaci s jednofázovou infrastrukturou 120V nebo až 240V jednofázovou infrastrukturou.
IEC62196Type1CCS - Kombinovaný konektor typu 1 podle definice ve standardu IEC 62196-3. Konektor je založen na konektoru typu 1 – jak je definováno ve standardu IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem.
IEC62196Type2CableAttached - Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako kabel a zástrčka připojená k nabíjecímu bodu.
IEC62196Type2Outlet - Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako zásuvka nastavená do nabíjecího bodu.
IEC62196Type2CCS - Kombinovaný konektor typu 2 podle definice v normě IEC 62196-3. Konektor je založen na konektoru typu 2 – jak je definováno v normě IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem.
IEC62196Type3 - Konektor typu 3 podle definice v normě IEC 62196-2. Také se nazývá Scame podle původního výrobce. Nejčastěji se používá v kombinaci s až 240V jednofázovou nebo až 420V třífázovou infrastrukturou.
Chademo - Konektor CHAdeMO pojmenovaný podle sdružení, které vytvořila Tokyo Electric Power Company a průmyslové partnery. Z tohoto důvodu se také označuje jako konektor TEPCO. Podporuje rychlé dc nabíjení.
IEC60309AC1PhaseBlue - Konektor Industrial Blue je konektor definovaný ve standardu IEC 60309. Někdy se označuje jako nějaká kombinace standardu, barvy a skutečnosti, že je jednofázová spojnice. Konektor má obvykle konfiguraci P+N+E, 6h.
IEC60309DCWhite - Konektor Industrial White je stejnosměrný konektor definovaný ve standardu IEC 60309.
Tesla - Konektor Tesla je regionálně specifický konektor Tesla Supercharger. To znamená, že odkazuje buď na proprietární konektor Tesly, někdy označovaný jako tesla port, většinou omezený na Severní Amerika, nebo na upravený typ 2 (DC přes typ 2) v Evropě.

Příklady použití:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached

Name	Typ	Description
Chademo	string	Konektor CHAdeMO pojmenovaný po sdružení, které vytvořila společnost Tokyo Electric Power Company a průmyslové partnery. Z tohoto důvodu se také označuje jako konektor TEPCO. Podporuje rychlé dc nabíjení.
IEC60309AC1PhaseBlue	string	Konektor Industrial Blue je konektor definovaný ve standardu IEC 60309. Někdy se označuje jako nějaká kombinace standardu, barvy a skutečnosti, že je jednofázová spojnice. Konektor má obvykle konfiguraci P+N+E, 6h.
IEC60309DCWhite	string	Konektor Industrial White je stejnosměrný konektor definovaný ve standardu IEC 60309.
IEC62196Type1	string	Konektor typu 1 podle definice ve standardu IEC 62196-2. Také se nazývá Yazaki podle původního výrobce nebo SAE J1772 podle normy, která ji poprvé publikovala. Nejčastěji se používá v kombinaci s jednofázovou infrastrukturou 120V nebo až 240V jednofázovou infrastrukturou.
IEC62196Type1CCS	string	Kombinovaný konektor typu 1 podle definice ve standardu IEC 62196-3. Konektor je založen na konektoru typu 1 – jak je definováno ve standardu IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem.
IEC62196Type2CCS	string	Kombinovaný konektor typu 2 podle definice ve standardu IEC 62196-3. Konektor je založen na konektoru typu 2 – jak je definováno v normě IEC 62196-2 – se dvěma dalšími kontakty stejnosměrným proudem (DC), které umožňují rychlé nabíjení stejnosměrným proudem.
IEC62196Type2CableAttached	string	Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako kabel a zástrčka připojená k nabíjecímu bodu
IEC62196Type2Outlet	string	Konektor typu 2 podle definice v normě IEC 62196-2. Poskytuje se jako zásuvka nastavená do nabíjecího bodu.
IEC62196Type3	string	Konektor typu 3 podle definice v normě IEC 62196-2. Také se nazývá Scame podle původního výrobce. Nejčastěji se používá v kombinaci s až 240V jednofázovou nebo až 420V třífázovou infrastrukturou.
StandardHouseholdCountrySpecific	string	Jedná se o standardní konektory pro domácnost pro určitou oblast. Všechny jsou jednofázové ac a standardní napěťové a standardní amperáže. Viz také: Typy zásuvek & – světové standardy
Tesla	string	Konektor Tesla je regionálně specifický konektor Tesla Supercharger. To znamená, že odkazuje buď na proprietární konektor Tesly, někdy označovaný jako tesla port, většinou omezený na Severní Amerika, nebo na upravený typ 2 (DC přes typ 2) v Evropě.

Entity

Zdroj typu entity ohraničujícího rámečku. Pro reverzní geokódování je to vždy stejné jako pozice.

Name	Typ	Description
position	string	Pozice entity

EntryPoint

Vstupní bod pro vrácené BŽ.

Name	Typ	Description
position	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".
type	EntryPointType	Typ vstupního bodu. Hodnota může být hlavní nebo vedlejší.

EntryPointType

Typ vstupního bodu. Hodnota může být hlavní nebo vedlejší.

Name	Typ	Description
main	string
minor	string

ErrorAdditionalInfo

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

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

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.

GeographicEntityType

Typ entity Zeměpis. K dispozici pouze v případech, kdy byl požadován typ entity a je k dispozici.

Name	Typ	Description
Country	string	název země/oblasti
CountrySecondarySubdivision	string	County
CountrySubdivision	string	Země/region nebo kraj
CountryTertiarySubdivision	string	Pojmenovaná oblast
Municipality	string	Město / město
MunicipalitySubdivision	string	Sub / Super City
Neighbourhood	string	Sousedství
PostalCodeArea	string	PSČ

Geometry

Informace o geometrickém tvaru výsledku. Je k dispozici pouze v případě, že zadáte == Zeměpis.

Name	Typ	Description
id	string	Předejte ho jako geometryId rozhraní Get Search Polygon API, abyste získali informace o geometrii pro tento výsledek.

LatLongPairAbbreviated

Umístění vyjádřené jako zeměpisná šířka a délka pomocí krátkých názvů "lat" & "lon".

Name	Typ	Description
lat	number	Vlastnost Zeměpisná šířka
lon	number	Zeměpisná délka – vlastnost

LocalizedMapView

Parametr View (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení takových oblastí a parametr View umožňuje, aby aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified", i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak pro toto umístění správně nastavit parametr View. Případně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr View v Azure Maps musí být použit v souladu s platnými zákony, včetně těch, které se týkají mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím Azure Maps jsou dostupné. Příklad: view=IN.

Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.

Name	Typ	Description
AE	string	Spojené arabské emiráty (zobrazení v arabštině)
AR	string	Argentina (argentinské zobrazení)
Auto	string	Vrátí mapová data na základě IP adresy požadavku.
BH	string	Bahrajn (zobrazení v arabštině)
IN	string	Indie (indické zobrazení)
IQ	string	Irák (zobrazení v arabštině)
JO	string	Jordánsko (arabské zobrazení)
KW	string	Kuvajt (zobrazení v arabštině)
LB	string	Libanon (zobrazení arabštiny)
MA	string	Maroko (marocké zobrazení)
OM	string	Omán (zobrazení arabštiny)
PK	string	Pákistán (pákistánské zobrazení)
PS	string	Palestinská samospráva (zobrazení v arabštině)
QA	string	Katar (zobrazení v arabštině)
SA	string	Saúdská Arábie (arabské zobrazení)
SY	string	Sýrie (zobrazení arabštiny)
Unified	string	Sjednocené zobrazení (ostatní)
YE	string	Jemen (arabské zobrazení)

MatchType

Typy shody pro operaci zpětného vyhledávání adres

Name	Typ	Description
AddressPoint	string
HouseNumberRange	string
Street	string

OperatingHours

Otevírací doba pro poi (body zájmu)

Name	Typ	Description
mode	string	Hodnota použitá v požadavku: none nebo "nextSevenDays"
timeRanges	OperatingHoursTimeRange[]	Seznam časových rozsahů pro příštích 7 dnů

OperatingHoursRange

Provozní doba pro bod zájmu (Body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se nepředá, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays

Name	Typ	Description
nextSevenDays	string	Zobrazuje hodiny operace pro další týden počínaje aktuálním dnem v místním čase poi.

OperatingHoursTime

Představuje datum a čas.

Name	Typ	Description
date	string	Představuje aktuální kalendářní datum v časovém pásmu BZ, například "2019-02-07".
hour	integer	Hodiny jsou v místním čase poi ve formátu 24 hodin; možné hodnoty jsou 0 až 23.
minute	integer	Minuty jsou v místním čase poi; možné hodnoty jsou 0 až 59.

OperatingHoursTimeRange

Otevřený časový rozsah pro den

Name	Typ	Description
endTime	OperatingHoursTime	Bod v rozsahu příštích 7 dnů, kdy je dané poi uzavřeno, nebo začátek rozsahu, pokud byl uzavřen před rozsahem.
startTime	OperatingHoursTime	Bod v rozsahu příštích 7 dnů, kdy se dané poi otevírá, nebo začátek rozsahu, pokud byl otevřen před rozsahem.

PointOfInterest

Podrobnosti o vrácených poi, včetně informací, jako je jméno, telefon, adresa URL a klasifikace

Name	Typ	Description
brands	Brand[]	Pole značek. Název značky pro vrácené poi.
categories	string[]	Pole kategorií
categorySet	PointOfInterestCategorySet[]	Seznam nejkonsekvnějších kategorií poi
classifications	Classification[]	Pole klasifikace
name	string	Název vlastnosti POI
openingHours	OperatingHours	Otevírací doba pro bod zájmu (Body zájmu).
phone	string	Vlastnost Telefonní číslo
url	string	Vlastnost Adresa URL webu

PointOfInterestCategorySet

Kategorie POI

Name	Typ	Description
id	integer	ID kategorie

PointOfInterestExtendedPostalCodes

Indexy, jejichž rozšířená PSČ by měla být zahrnuta do výsledků.

Dostupné indexy jsou:

POI = body zájmu

Pokud chcete zakázat rozšířená PSČ, hodnota by měla být BŽ neboŽádná .

Ve výchozím nastavení jsou zahrnuta rozšířená PSČ.