Search - Post Search Inside Geometry

Služba:: Maps

Verze rozhraní API:: 1.0

Umožňuje provádět bezplatné vyhledávání formulářů uvnitř jedné více geometrií.

API Post Search Inside Geometry je a HTTP POST požadavek, který vám umožňuje provádět bezplatné vyhledávání formulářů uvnitř jedné geometrie nebo více geometrií. Vrátí se výsledky hledání, které spadají do geometrie/geometrie.

K odeslání geometrie použijete požadavek POST, kde tělo požadavku bude obsahovat objekt reprezentovaný geometry jako GeoJSON a hlavička Content-Type bude nastavena na application/json. Geografické prvky, které se mají prohledávat, lze modelovat jako geometrie polygonů a/nebo kruhů reprezentované pomocí některého z následujících typů GeoJSON:

Kolekce funkcí GeoJSON
Může geometry být reprezentován jako objekt GeoJSON FeatureCollection . Toto je doporučená volba, pokud geometrie obsahuje polygony i kružnice. Může FeatureCollection obsahovat až 50 objektů GeoJSON Feature . Každý Feature objekt by měl představovat buď polygon nebo kružnici za následujících podmínek:
- Objekt Feature pro geometrii polygonu může mít až 50 souřadnic a jeho vlastnosti musí být prázdné.
- Objekt Feature pro geometrii Circle se skládá ze středu reprezentovaného pomocí typu GeoJSON Point a hodnoty poloměru (v metrech), která musí být zadána ve vlastnostech objektu spolu s vlastností subType , jejíž hodnota by měla být "Circle".
Viz Příklady ukázkové FeatureCollection reprezentace.
GeoJSON GeometryCollection
Může geometry být reprezentován jako objekt GeoJSON GeometryCollection . Toto je doporučená volba, pokud geometrie obsahuje pouze seznam polygonů. Může GeometryCollection obsahovat až 50 objektů GeoJSON Polygon . Každý Polygon objekt může mít až 50 souřadnic. Viz Příklady ukázkové GeometryCollection reprezentace.
GeoJSON Polygon
Může geometry být reprezentován jako objekt GeoJSON Polygon . Toto je doporučená volba, pokud geometrie obsahuje jeden polygon. Objekt Polygon může mít až 50 souřadnic. Viz Příklady ukázkové Polygon reprezentace.

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

S volitelnými parametry:

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}&limit={limit}&language={language}&categorySet={categorySet}&extendedPostalCodesFor={extendedPostalCodesFor}&idxSet={idxSet}&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 služby Azure Maps
query	query	True	string	Jméno POI, které se má hledat (např. "socha svobody", "starbucks", "pizza"). Musí být správně zakódovaná adresa URL.
categorySet	query		integer[]	Čárkami oddělený seznam ID sad kategorií, které je možné použít k omezení výsledku na konkrétní kategorie bodů zájmu. Na objednávce ID nezáleží. Maximální počet podporovaných hodnot `categorySet` na požadavek je 10. Pokud je k dispozici více identifikátorů kategorií, vrátí se pouze identifikátory POI, které patří (alespoň) do jedné z kategorií z poskytnutého seznamu. Seznam podporovaných kategorií je možné zjistit pomocí rozhraní API kategorie poi. Příklady použití: categorySet=7315 (body zájmu z kategorie Restaurace) categorySet=7315025 7315017 (body zájmu kategorie italské nebo francouzské restaurace)
extendedPostalCodesFor	query		SearchIndexes[]	Do výsledků by měly být zahrnuty indexy, pro které by měly být zahrnuté rozšířené POŠTOVNÍ směrovací čísla. Dostupné indexy jsou: Addr = Rozsahy adres geo = zeměpisné oblasti PAD = adresy bodů POI = Body zájmu Str = ulice XStr = křížové ulice (průsečíky) Hodnota by měla být čárkami oddělený seznam typů indexů (v libovolném pořadí) nebo Žádné pro žádné indexy. Ve výchozím nastavení jsou rozšířené PSČ zahrnuté pro všechny indexy s výjimkou Geo. Rozšířené seznamy PSČ pro zeměpisné oblasti můžou být poměrně dlouhé, takže je potřeba je explicitně vyžádat v případě potřeby. Příklady použití: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Rozšířené PSČ se vrátí jako extendedPostalCode vlastnost adresy. Dostupnost je závislá na oblasti.
idxSet	query		SearchIndexes[]	Čárkami oddělený seznam indexů, které by se měly použít pro vyhledávání. Pořadí položek nezáleží. Dostupné indexy jsou: Addr = Interpolace rozsahu adres, Geo = Zeměpisné údaje, PAD = Point Addresses, POI = Points of interest, Str = Streets, Xstr = Cross Streets (průsečíky)
language	query		string	Jazyk, ve kterém mají být vráceny výsledky hledání. Měla 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 dostupná, použije se výchozí jazyk. Podrobnosti najdete v podporovaných jazycích.
limit	query		integer minimum: 1 maximum: 100	Maximální počet odpovědí, které budou vráceny. Výchozí hodnota: 10, minimum: 1 a maximum: 100
openingHours	query		OperatingHoursRange	Počet hodin provozu pro poI (body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se neuskutečí, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays
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 geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušný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 přes Azure Maps, je zpřístupněn. Příklad: view=IN. 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	Označuje účet určený pro použití s modelem zabezpečení Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z rozhraní API účtu roviny správy Azure Maps. Další informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v tématu Správa ověřování v Azure Maps.

Text požadavku

Name	Typ	Description
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Platný objekt `GeoJSON`. Podrobnosti najdete v RFC 7946.

Odpovědi

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

Zabezpečení

AADToken

Jedná se o Microsoft Entra OAuth 2.0 Flow. Při spárování s přístupu na základě role Azure se dá řídit přístup k rozhraním REST API služby Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo více účtům prostředků Nebo dílčím prostředkům Azure Maps. 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 rozhraním REST API služby Azure Maps.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování . Stručně ř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 rozsahy.

Poznámka:

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

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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 na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

Díky tomuto klíči má každá aplikace přístup ke všem rozhraní REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, ve který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat důvěrných klientských aplikací přístup k rozhraním REST API služby Azure Maps, aby bylo možné klíč bezpečně uložit.

Typ: apiKey
V: query

SAS Token

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

S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.

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

Typ: apiKey
V: header

Příklady

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Ukázkový požadavek

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=burger&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "GeometryCollection",
    "geometries": [
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -122.43576049804686,
              37.7524152343544
            ],
            [
              -122.43301391601562,
              37.70660472542312
            ],
            [
              -122.36434936523438,
              37.712059855877314
            ],
            [
              -122.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      },
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -123.43576049804686,
              37.7524152343544
            ],
            [
              -123.43301391601562,
              37.70660472542312
            ],
            [
              -123.36434936523438,
              37.712059855877314
            ],
            [
              -123.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "summary": {
    "query": "burger",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 2,
    "offset": 0,
    "totalResults": 4,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "9P2i9inRyndAA-_V40J8oA",
      "score": 2.0041828156,
      "info": "search:ta:840061003419653-US",
      "poi": {
        "name": "Burger Joint",
        "phone": "+1 415-349-4331",
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "categories": [
          "fast food",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "hkr-N07YS6Gv2dOciQ9lwA",
      "score": 2.0041515827,
      "info": "search:ta:840067000526682-US",
      "poi": {
        "name": "Sound of Burgers",
        "categorySet": [
          {
            "id": 7315
          }
        ],
        "categories": [
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    }
  ]
}

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Ukázkový požadavek

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=pizza&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.143035,
                47.653536
              ],
              [
                -122.187164,
                47.617556
              ],
              [
                -122.114981,
                47.570599
              ],
              [
                -122.132756,
                47.654009
              ],
              [
                -122.143035,
                47.653536
              ]
            ]
          ]
        },
        "properties": {}
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -122.126986,
            47.639754
          ]
        },
        "properties": {
          "subType": "Circle",
          "radius": 100
        }
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "summary": {
    "query": "pizza",
    "queryType": "NON_NEAR",
    "queryTime": 34,
    "numResults": 2,
    "offset": 0,
    "totalResults": 21,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "-UuwTye4GGsea4KmCLvoqQ",
      "score": 2.1455535889,
      "info": "search:ta:840537000108972-US",
      "poi": {
        "name": "Biryani & Pizza House",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "15025",
        "streetName": "Northeast 24th Street",
        "municipality": "Redmond",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98052",
        "extendedPostalCode": "98052-5531",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15025 Northeast 24th Street, Redmond, WA 98052",
        "localName": "Redmond"
      },
      "position": {
        "lat": 47.630786,
        "lon": -122.139302
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.63169,
          "lon": -122.14064
        },
        "btmRightPoint": {
          "lat": 47.62989,
          "lon": -122.13797
        }
      },
      "entryPoints": [
        {
          "type": "minor",
          "position": {
            "lat": 47.63079,
            "lon": -122.13931
          }
        },
        {
          "type": "main",
          "position": {
            "lat": 47.63147,
            "lon": -122.13935
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "7r095LCcCSkdoGoeLcnvsQ",
      "score": 2.1454992294,
      "info": "search:ta:840537000103468-US",
      "poi": {
        "name": "Pagliacci Pizza",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "url": "www.pagliacci.com/",
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-20",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-20",
                "hour": 11,
                "minute": 0
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "15238",
        "streetName": "Bel Red Road",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98007",
        "extendedPostalCode": "98007-3815",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15238 Bel Red Road, Bellevue, WA 98007",
        "localName": "Bellevue"
      },
      "position": {
        "lat": 47.628008,
        "lon": -122.13646
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.62891,
          "lon": -122.13779
        },
        "btmRightPoint": {
          "lat": 47.62711,
          "lon": -122.13513
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6283,
            "lon": -122.13611
          }
        }
      ]
    }
  ]
}

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Ukázkový požadavek

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=subs&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.43576049804686,
          37.7524152343544
        ],
        [
          -122.43301391601562,
          37.70660472542312
        ],
        [
          -122.36434936523438,
          37.712059855877314
        ],
        [
          -122.43576049804686,
          37.7524152343544
        ]
      ]
    ]
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "summary": {
    "query": "subs",
    "queryType": "NON_NEAR",
    "queryTime": 42,
    "numResults": 2,
    "offset": 0,
    "totalResults": 5,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "HOIWGiNwVv0z6bF8MO3EbA",
      "score": 2.1455111504,
      "info": "search:ta:840069009512242-US",
      "poi": {
        "name": "Adams Grub Truck",
        "phone": "+1 415-307-8844",
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "1465",
        "streetName": "Carroll Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Bayview",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94124",
        "extendedPostalCode": "94124-3604",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "1465 Carroll Avenue, San Francisco, CA 94124",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.72328,
        "lon": -122.39091
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.72418,
          "lon": -122.39205
        },
        "btmRightPoint": {
          "lat": 37.72238,
          "lon": -122.38977
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72348,
            "lon": -122.39073
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "bXbc0QxTRlkSo8GnU7EU-Q",
      "score": 2.1454677582,
      "info": "search:ta:840061001992959-US",
      "poi": {
        "name": "SUBWAY San Francisco San Francisco",
        "phone": "+1 415-657-9898",
        "brands": [
          {
            "name": "SUBWAY"
          }
        ],
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-13",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-13",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-15",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-15",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-16",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-16",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 8,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 20,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 21,
                "minute": 30
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "2599",
        "streetName": "San Bruno Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Portola",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-1504",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "2599 San Bruno Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.729004,
        "lon": -122.403956
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.7299,
          "lon": -122.40509
        },
        "btmRightPoint": {
          "lat": 37.7281,
          "lon": -122.40282
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72892,
            "lon": -122.40414
          }
        }
      ]
    }
  ]
}

Definice

Name	Description
Address	Adresa výsledku.
AddressRanges	Popisuje rozsah adres na obou stranách ulice pro výsledek hledání. Jsou zahrnuty souřadnice počátečního a koncového umístění rozsahu adres.
BoundingBox	Oblast zobrazení, která pokrývá výsledek reprezentovaný souřadnicemi oblasti zobrazení v levém horním a pravém dolním rohu.
BoundingBoxCompassNotation	Ohraničující rámeček umístění.
Brand	Značka přidružená k poi
Classification	Klasifikace vrácené poI
ClassificationName	Název klasifikace
DataSources	Volitelný oddíl. Referenční ID pro použití s rozhraním API Get Search Polygon.
Entity	Zdroj typu entity ohraničujícího rámečku. V případě zpětného geokódování se toto umístění vždy rovná pozici.
EntryPoint	Vstupní bod pro vrácenou žádost o zadání.
EntryPointType	Typ vstupního bodu. Hodnota může být hlavní nebo menší.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
GeographicEntityType	Typ entity zeměpisu Je k dispozici pouze v případech, kdy byla požadována entita EntityType a je k dispozici.
GeoJsonFeature	Platný typ objektu `GeoJSON Feature`. Podrobnosti najdete v RFC 7946.
GeoJsonFeatureCollection	Platný typ objektu `GeoJSON FeatureCollection`. Podrobnosti najdete v RFC 7946.
GeoJsonGeometry	Platný objekt geometrie `GeoJSON`. Typ musí být jedním z sedmi platných typů geometrie GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon a GeometryCollection. Podrobnosti najdete v RFC 7946.
GeoJsonGeometryCollection	Platný typ objektu `GeoJSON GeometryCollection`. Podrobnosti najdete v RFC 7946.
GeoJsonLineString	Platný typ geometrie `GeoJSON LineString`. Podrobnosti najdete v RFC 7946.
GeoJsonMultiLineString	Platný typ geometrie `GeoJSON MultiLineString`. Podrobnosti najdete v RFC 7946.
GeoJsonMultiPoint	Platný typ geometrie `GeoJSON MultiPoint`. Podrobnosti najdete v RFC 7946.
GeoJsonMultiPolygon	Platný typ objektu `GeoJSON MultiPolygon`. Podrobnosti najdete v RFC 7946.
GeoJsonPoint	Platný typ geometrie `GeoJSON Point`. Podrobnosti najdete v RFC 7946.
GeoJsonPolygon	Platný typ geometrie `GeoJSON Polygon`. Podrobnosti najdete v RFC 7946.
Geometry	Informace o geometrickém tvaru výsledku Je k dispozici pouze v případě, že typ == Zeměpis.
LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka s krátkými názvy "lat" & "lon".
LocalizedMapView	Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušný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 přes Azure Maps, je zpřístupněn. Příklad: view=IN. Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.
MatchType	Typy shody pro operaci zpětného vyhledávání adres
OperatingHours	Otevírací doba pro poi (body zájmu).
OperatingHoursRange	Počet hodin provozu pro poI (body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se neuskutečí, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays
OperatingHoursTime	Představuje datum a čas.
OperatingHoursTimeRange	Otevření časového rozsahu pro den
PointOfInterest	Podrobnosti o vrácené poI, včetně informací, jako je jméno, telefon, adresa URL a klasifikace.
PointOfInterestCategorySet	Kategorie POI
QueryType	Typ vráceného dotazu: NEDALE nebo NON_NEAR. Důležité: Tato vlastnost je zastaralá a může být v odpovědi vynechána.
ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
SearchAddressResult	Tento objekt se vrátí z úspěšných volání hledání.
SearchAddressResultItem	Objekt výsledku pro odpověď rozhraní API vyhledávání
SearchAddressResultType	Jedna z těchto možností: bod zájmu Ulice Zeměpis Adresa bodu Rozsah adres Křížová ulice
SearchIndexes	Do výsledků by měly být zahrnuty indexy, pro které by měly být zahrnuté rozšířené POŠTOVNÍ směrovací čísla. Dostupné indexy jsou: Addr = Rozsahy adres geo = zeměpisné oblasti PAD = adresy bodů POI = Body zájmu Str = ulice XStr = křížové ulice (průsečíky) Hodnota by měla být čárkami oddělený seznam typů indexů (v libovolném pořadí) nebo Žádné pro žádné indexy. Ve výchozím nastavení jsou rozšířené PSČ zahrnuté pro všechny indexy s výjimkou Geo. Rozšířené seznamy PSČ pro zeměpisné oblasti můžou být poměrně dlouhé, takže je potřeba je explicitně vyžádat v případě potřeby. Příklady použití: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Rozšířené PSČ se vrátí jako extendedPostalCode vlastnost adresy. Dostupnost je závislá na oblasti.
SearchInsideGeometryRequest	Tento typ představuje text požadavku pro službu Hledat uvnitř geometrie.
SearchSummary	Souhrnný objekt odpovědi rozhraní API služby Search

Address

Objekt

Adresa výsledku.

Name	Typ	Description
boundingBox	BoundingBoxCompassNotation	Definuje ohraničovací rámeček pro dané umístění. Tato vlastnost je vrácena pouze rozhraními API pro zpětnou vazbu vyhledávací adresy. Všechna ostatní rozhraní API pro vyhledávání vracejí `viewport` vlastnost `SearchAddressResultItem` objektu.
buildingNumber	string	Číslo budovy na ulici. Důležité: Tato vlastnost je zastaralá. Místo toho použijte `streetNumber`.
country	string	Název země/regionu.
countryCode	string	Dvoupísmenný abecední kód definovaný standardem ISO 3166-1 Alpha-2 pro reprezentaci země/regionu a závislých území.
countryCodeISO3	string	Třípísmenný abecední kód definovaný standardem ISO 3166-1 Alpha-3 pro reprezentaci země/regionu a závislých území.
countrySecondarySubdivision	string	Druhá úroveň administrativního členění v rámci země/regionu. Identifikuje pododdělení, které je pod primární podjednotkou, například státem nebo provincií, ale nad menšími jednotkami, jako jsou obce nebo čtvrti. Příklady zahrnují County ve Spojených státech a District ve Spojeném království.
countrySubdivision	string	Hlavní správní členění v rámci země, například stát, provincie. Používá se k reprezentaci první úrovně pododdělení pod národní úrovní.
countrySubdivisionCode	string	`countrySubdivisionCode` 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. Tato vlastnost není dostupná v `Get Search Nearby` API and `Get Search POI` API.
countrySubdivisionName	string	Představuje plný název první úrovně správní jednotky (například stát, provincie nebo region) v rámci země nebo regionu. Tato nemovitost je zahrnuta pouze tehdy, pokud `countrySubdivision` je hodnota uvedena ve zkrácené podobě. V současnosti podporováno ve Spojených státech, Kanadě a Spojeném království.
countryTertiarySubdivision	string	Třetí úroveň administrativního členění v rámci země/regionu. Poskytuje ještě jemnější detailnost než sekundární pododdělení (například okres nebo okres). Příklady zahrnují obce jako město, obec, vesnici, městečko nebo obec a čtvrti menší, neformální geografické oblasti v rámci obce, jako jsou Capitol Hill, Green Lake a Wallingford v Seattlu.
crossStreet	string	Název ulice, která se překříží. Tato vlastnost je dostupná pouze v `Get Search Address Reverse Cross Street` API.
extendedPostalCode	string	Rozšířené poštovní směrovací číslo označuje formát poštovního směrovacího čísla, který přesahuje standardní sadu číslic a poskytuje větší přesnost polohy. Běžně se používá v systémech jako U.S. ZIP+4 kód nebo podobných rozšířených formátech v jiných zemích/regionech. Dostupnost závisí na regionu. Není dostupné v `Get Search Address Reverse Cross Street` API.
freeformAddress	string	Adresní řádek formátovaný podle formátovacích pravidel země/regionu původu výsledku, nebo v případě země/regionu jeho plného názvu země/regionu.
localName	string	Součást adresy, která představuje název geografické 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í vlastnosti `freeformAddress`. `localName` představuje 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 místo `localNamemunicipality` .
municipality	string	Město / město Poznámka: `municipality` představuje místní obec. V závislosti na umístění se hodnota `municipality` 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 nebo obce se doporučuje `localName` použít hodnotu místo hodnoty `municipality` .
municipalitySubdivision	string	Část v rámci obce. Představuje menší administrativní nebo geografickou jednotku uvnitř města, obce nebo jiné obecní jednotky.
neighbourhood	string	Čtvrť 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	K adrese přidávala série čísel nebo písmen (nebo obojí), aby pomohla identifikovat konkrétní geografickou oblast. PSČ je americká verze poštovního směrovacího čísla, jiné země/regiony používají jiné formáty, jako je PSČ, PSČ a PLZ.
routeNumbers	string[]	Kódy používané k jednoznačné identifikaci ulice. K dispozici pouze pro reverzní rozhraní API pro vyhledávání adres.
street	string	Název ulice. Důležité: Tato vlastnost je zastaralá. Místo toho použijte `streetName`.
streetName	string	Název ulice.
streetNameAndNumber	string	Název a číslo ulice. K dispozici pouze pro reverzní rozhraní API pro vyhledávání adres.
streetNumber	string	Číslo budovy na ulici. Není dostupné v `Get Search Address Reverse Cross Street` API.

AddressRanges

Objekt

Popisuje rozsah adres na obou stranách ulice pro výsledek hledání. Jsou zahrnuty 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 s krátkými názvy "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 s krátkými názvy "lat" & "lon".

BoundingBox

Objekt

Oblast zobrazení, která pokrývá výsledek reprezentovaný souřadnicemi oblasti zobrazení v levém horním a pravém dolním rohu.

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

BoundingBoxCompassNotation

Objekt

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

Name	Typ	Description
entity	Entity	Zdroj typu entity ohraničujícího rámečku. V případě zpětného geokódování se toto umístění vždy rovná pozici.
northEast	string	Severní východ zeměpisné šířky, souřadnice zeměpisné délky ohraničujícího rámečku jako čárkami oddělené plováky
southWest	string	Zeměpisná šířka – západ, souřadnice zeměpisné délky ohraničujícího rámečku jako čárkami oddělené plováky

Brand

Objekt

Značka přidružená k poi

Name	Typ	Description
name	string	Název značky

Classification

Objekt

Klasifikace vrácené poI

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

ClassificationName

Objekt

Název klasifikace

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

DataSources

Objekt

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

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

Entity

Výčet

Zdroj typu entity ohraničujícího rámečku. V případě zpětného geokódování se toto umístění vždy rovná pozici.

Hodnota	Description
position	Entita Pozice

EntryPoint

Objekt

Vstupní bod pro vrácenou žádost o zadání.

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

EntryPointType

Výčet

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

Hodnota	Description
main
minor

ErrorAdditionalInfo

Objekt

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

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

ErrorDetail

Objekt

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

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

GeographicEntityType

Výčet

Typ entity zeměpisu Je k dispozici pouze v případech, kdy byla požadována entita EntityType a je k dispozici.

Hodnota	Description
Country	název země/oblasti
CountrySubdivision	Stát nebo provincie
CountrySecondarySubdivision	Kraj
CountryTertiarySubdivision	Pojmenovaná oblast
Municipality	Město / město
MunicipalitySubdivision	Ponorka / Super City
Neighbourhood	Sousedství
PostalCodeArea	PSČ / PSČ

GeoJsonFeature

Objekt

Platný typ objektu GeoJSON Feature. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
featureType	string	Typ funkce. Hodnota závisí na datovém modelu, na který je aktuální funkce součástí. Některé datové modely můžou mít prázdnou hodnotu.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Platný objekt geometrie `GeoJSON`. Typ musí být jedním z sedmi platných typů geometrie GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon a GeometryCollection. Podrobnosti najdete v RFC 7946.
id	string	Identifikátor funkce.
type	string: Feature	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.

GeoJsonFeatureCollection

Objekt

Platný typ objektu GeoJSON FeatureCollection. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
features	GeoJsonFeature[]	Obsahuje seznam platných `GeoJSON Feature` objektů.
type	string: FeatureCollection	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.

GeoJsonGeometry

Objekt

Platný objekt geometrie GeoJSON. Typ musí být jedním z sedmi platných typů geometrie GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon a GeometryCollection. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
type	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.

GeoJsonGeometryCollection

Objekt

Platný typ objektu GeoJSON GeometryCollection. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Obsahuje seznam platných objektů geometrie `GeoJSON`. Poznámka, že souřadnice v GeoJSON jsou v x, pořadí y (zeměpisná délka, zeměpisná šířka).
type	string: GeometryCollection	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.

GeoJsonLineString

Objekt

Platný typ geometrie GeoJSON LineString. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Souřadnice pro geometrii `GeoJson LineString`.
type	string: LineString	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.

GeoJsonMultiLineString

Objekt

Platný typ geometrie GeoJSON MultiLineString. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Souřadnice pro geometrii `GeoJson MultiLineString`.
type	string: MultiLineString	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.

GeoJsonMultiPoint

Objekt

Platný typ geometrie GeoJSON MultiPoint. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Souřadnice pro geometrii `GeoJson MultiPoint`.
type	string: MultiPoint	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.

GeoJsonMultiPolygon

Objekt

Platný typ objektu GeoJSON MultiPolygon. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Obsahuje seznam platných `GeoJSON Polygon` objektů. Poznámka, že souřadnice v GeoJSON jsou v x, pořadí y (zeměpisná délka, zeměpisná šířka).
type	string: MultiPolygon	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.

GeoJsonPoint

Objekt

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

Name	Typ	Description
coordinates	number[] (double)	`Position` je matice čísel se dvěma nebo více prvky. První dva prvky jsou zeměpisné délky a zeměpisnou šířkupřesně v daném pořadí. nadmořské výšky nebo zvýšení výšky je volitelný třetí prvek. Podrobnosti najdete v RFC 7946.
type	string: Point	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.

GeoJsonPolygon

Objekt

Platný typ geometrie GeoJSON Polygon. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Souřadnice pro typ geometrie `GeoJson Polygon`.
type	string: Polygon	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.

Geometry

Objekt

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

Name	Typ	Description
id	string	Předejte ho jako geometryId do Get Search Polygon API k načtení informací o geometrii pro tento výsledek.

LatLongPairAbbreviated

Objekt

Umístění reprezentované jako zeměpisná šířka a délka s krátkými názvy "lat" & "lon".

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

LocalizedMapView

Výčet

Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s příslušný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 přes Azure Maps, je zpřístupněn. Příklad: view=IN.

Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.

Hodnota	Description
AE	Spojené arabské emiráty (zobrazení arabštiny)
AR	Argentina (argentinský pohled)
BH	Arabština (zobrazení arabštiny)
IN	Indie (indické zobrazení)
IQ	Irák (arabské zobrazení)
JO	Jordánsko (arabské zobrazení)
KW	Kuvajt (arabské zobrazení)
LB	Libanon (zobrazení arabštiny)
MA	Maroko (marocký pohled)
OM	Omán (zobrazení arabštiny)
PK	Pákistán (pákistánské zobrazení)
PS	Palestinská autorita (arabské zobrazení)
QA	Katar (zobrazení arabštiny)
SA	Saúdská Arábie (zobrazení arabštiny)
SY	Sýrie (zobrazení arabštiny)
US	Spojené státy americké
YE	Jemen (arabské zobrazení)
Auto	Vrátí data mapy na základě IP adresy požadavku.
Unified	Jednotné zobrazení (ostatní)

MatchType

Výčet

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

Hodnota	Description
AddressPoint
HouseNumberRange
Street

OperatingHours

Objekt

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

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

OperatingHoursRange

Výčet

Počet hodin provozu pro poI (body zájmu). Dostupnost hodin provozu se bude lišit v závislosti na dostupných datech. Pokud se neuskutečí, nebudou vráceny žádné informace o otevírací době. Podporovaná hodnota: nextSevenDays

Hodnota	Description
nextSevenDays	Zobrazuje hodiny operace pro příští týden počínaje aktuálním dnem v místním čase ukazatele pouzdře.

OperatingHoursTime

Objekt

Představuje datum a čas.

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

OperatingHoursTimeRange

Objekt

Otevření časového rozsahu pro den

Name	Typ	Description
endTime	OperatingHoursTime	Bod v následujícím 7denním rozsahu, kdy je daná poI uzavřena, nebo začátek rozsahu, pokud byl uzavřen před rozsahem.
startTime	OperatingHoursTime	Bod v následujícím 7denním rozsahu, kdy se daná poI otevírá, nebo začátek rozsahu, pokud byl otevřen před rozsahem.

PointOfInterest

Objekt

Podrobnosti o vrácené 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ácenou žádost o pomoc.
categories	string[]	Pole kategorií
categorySet	PointOfInterestCategorySet[]	Seznam nejvýraznějších kategorií poi
classifications	Classification[]	Pole klasifikace
name	string	Název vlastnosti POI
openingHours	OperatingHours	Otevírací doba pro poi (body zájmu).
phone	string	Vlastnost telefonního čísla
url	string	Vlastnost url webu

PointOfInterestCategorySet

Objekt

Kategorie POI

Name	Typ	Description
id	integer	ID kategorie

QueryType

Výčet

Typ vráceného dotazu: NEDALE nebo NON_NEAR.

Důležité: Tato vlastnost je zastaralá a může být v odpovědi vynechána.

Hodnota	Description
NEARBY	Vyhledávání probíhalo v oblasti určité zeměpisné šířky a délky s definovaným poloměrem.
NON_NEAR	Vyhledávání bylo provedeno globálně, bez předsudků na určitou zeměpisnou šířku a délku a bez definovaného poloměru.

ResponseFormat

Výčet

Požadovaný formát odpovědi Hodnota může být json nebo xml.

Hodnota	Description
json	formát výměny dat javascriptového objektu
xml	rozšiřitelného jazyka značek

SearchAddressResult

Objekt

Tento objekt se vrátí z úspěšných volání hledání.

Name	Typ	Description
results	SearchAddressResultItem[]	Seznam výsledků rozhraní API vyhledávání
summary	SearchSummary	Souhrnný objekt odpovědi rozhraní API služby Search

SearchAddressResultItem

Objekt

Objekt výsledku pro odpověď rozhraní API vyhledávání

Name	Typ	Description
address	Address	Adresa výsledku.
addressRanges	AddressRanges	Popisuje rozsah adres na obou stranách ulice pro výsledek hledání. Jsou zahrnuty souřadnice počátečního a koncového umístění rozsahu adres.
dataSources	DataSources	Volitelný oddíl. ID referenční geometrie pro použití s rozhraním API Get Search Polygon.
detourTime	integer	Doba objížďky v sekundách. Vráceno pouze pro volání rozhraní API pro vyhledávání podél trasy.
dist	number (double)	Přímá vzdálenost mezi výsledkem a umístěním geobias v metrech.
entityType	GeographicEntityType	Typ entity zeměpisu Je k dispozici pouze v případech, kdy byla požadována entita EntityType a je k dispozici.
entryPoints	EntryPoint[]	Pole vstupních bodů. Ty popisují typy vchodů, které jsou k dispozici na místě. Typ může být "main" pro hlavní vchody, jako jsou přední dveře nebo předsálí, a "vedlejší", pro boční a zadní dveře.
id	string	Vlastnost ID
info	string	Informace o původním zdroji dat výsledku Používá se pro žádosti o podporu.
matchType	MatchType	Informace o typu shody Jedna z těchto možností: Adresní bod Rozsah_čísel domu Ulice
poi	PointOfInterest	Podrobnosti o vrácené poI, včetně informací, jako je jméno, telefon, adresa URL a klasifikace.
position	LatLongPairAbbreviated	Umístění reprezentované jako zeměpisná šířka a délka s krátkými názvy "lat" & "lon".
score	number (double)	Hodnota v sadě výsledků označující relativní odpovídající skóre mezi výsledky. To můžete použít k určení, že výsledek x je dvakrát tak pravděpodobné, že bude relevantní jako výsledek y, pokud je hodnota x 2x hodnota y. Hodnoty se mezi dotazy liší a jsou určeny pouze jako relativní hodnota pro jednu sadu výsledků. Důležité: Tato vlastnost je zastaralá a může být v odpovědi vynechána.
type	SearchAddressResultType	Jedna z těchto možností: bod zájmu Ulice Zeměpis Adresa bodu Rozsah adres Křížová ulice
viewport	BoundingBox	Oblast zobrazení, která pokrývá výsledek reprezentovaný souřadnicemi oblasti zobrazení v levém horním a pravém dolním rohu.

SearchAddressResultType

Výčet

Jedna z těchto možností:

bod zájmu
Ulice
Zeměpis
Adresa bodu
Rozsah adres
Křížová ulice

Hodnota	Description
POI
Street
Geography
Point Address
Address Range
Cross Street

SearchIndexes

Výčet

Do výsledků by měly být zahrnuty indexy, pro které by měly být zahrnuté rozšířené POŠTOVNÍ směrovací čísla.

Dostupné indexy jsou:

Addr = Rozsahy adres

geo = zeměpisné oblasti

PAD = adresy bodů

POI = Body zájmu

Str = ulice

XStr = křížové ulice (průsečíky)

Hodnota by měla být čárkami oddělený seznam typů indexů (v libovolném pořadí) nebo Žádné pro žádné indexy.

Ve výchozím nastavení jsou rozšířené PSČ zahrnuté pro všechny indexy s výjimkou Geo. Rozšířené seznamy PSČ pro zeměpisné oblasti můžou být poměrně dlouhé, takže je potřeba je explicitně vyžádat v případě potřeby.

Příklady použití:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Rozšířené PSČ se vrátí jako extendedPostalCode vlastnost adresy. Dostupnost je závislá na oblasti.

Hodnota	Description
Addr
Geo
PAD
POI
Str
Xstr

SearchInsideGeometryRequest

Objekt

Tento typ představuje text požadavku pro službu Hledat uvnitř geometrie.

Name	Typ	Description
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Platný objekt `GeoJSON`. Podrobnosti najdete v RFC 7946.

SearchSummary

Objekt

Souhrnný objekt odpovědi rozhraní API služby Search

Name	Typ	Description
fuzzyLevel	integer	Maximální úroveň přibližné hodnoty potřebná k zadání výsledků.
geoBias	LatLongPairAbbreviated	Označení, kdy interní vyhledávací modul použil geoprostorový předsudky ke zlepšení hodnocení výsledků. V některých metodách to může být ovlivněno nastavením parametrů lat a lon, pokud jsou k dispozici. V jiných případech je to čistě interní.
limit	integer	Maximální počet vrácených odpovědí
numResults	integer	Počet výsledků v odpovědi
offset	integer	Počáteční posun vrácených výsledků v celé sadě výsledků.
query	string	Parametr dotazu, který se použil k vytvoření těchto výsledků hledání.
queryTime	integer	Čas strávený překladem dotazu v milisekundách
queryType	QueryType	Typ vráceného dotazu: NEDALE nebo NON_NEAR. Důležité: Tato vlastnost je zastaralá a může být v odpovědi vynechána.
totalResults	integer	Celkový počet nalezených výsledků

Sdílet prostřednictvím

Search - Post Search Inside Geometry

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

AADToken

Rozsahy

subscription-key

SAS Token

Příklady

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Ukázkový požadavek

Ukázková odpověď

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Ukázkový požadavek

Ukázková odpověď

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Ukázkový požadavek

Ukázková odpověď

Definice

Address

AddressRanges

BoundingBox

BoundingBoxCompassNotation

Brand

Classification

ClassificationName

DataSources

Entity

EntryPoint

EntryPointType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeographicEntityType

GeoJsonFeature

GeoJsonFeatureCollection

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonPoint

GeoJsonPolygon

Geometry

LatLongPairAbbreviated

LocalizedMapView

MatchType

OperatingHours

OperatingHoursRange

OperatingHoursTime

OperatingHoursTimeRange

PointOfInterest

PointOfInterestCategorySet

QueryType

ResponseFormat

SearchAddressResult

SearchAddressResultItem

SearchAddressResultType

SearchIndexes

SearchInsideGeometryRequest

SearchSummary