Search - Post Search Inside Geometry

Reference

Služba:: Maps

Verze rozhraní API:: 1.0

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

Rozhraní API Post Search Inside Geometry je a POST request that allows you to perform a free form search inside a single geometry or multiple geometries. The search results that fall inside the geometry/geometries will be returned. To send the geometry you will use a GEOJSONrequest where the request body will contain thegeometrieobject represented as aGeoJSONtype and thecontent-typeheader will be set toapplication/json. The geographical features to be searched can be modeled as Polygon and/or Circle geometries represented using any one of the following GeoJSONtypes:<ul><li>**GeoJSON FeatureCollection** Thegeometriican be represented as aGeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50Funkce GeoJSONobjects. Eachfunkceobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>Aobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>AFeatureobject for the Circle geometry is composed of a _center_ represented using aGeoJSON Pointtype and a _radius_ value (in meters) which must be specified in the object's properties along with the _subType_ property whose value should be 'Circle'.</li></ul> Please see the Examples section below for a sampleFeatureCollectionrepresentation. </li><li>**GeoJSON GeometryCollection** Thegeometrycan be represented as aGeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeometryCollectioncan contain a max of 50GeoJSON Polygonobjects. EachPolygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleGeometryCollectionrepresentation. </li><li>**GeoJSON Polygon** Thegeometrycan be represented as aGeoJSON Polygonobject. This is the recommended option if the geometry contains a single Polygon. ThePolygonobject can have a max of 50 coordinates. Please see the Examples section below for a samplePolygon.

.

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	Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID pro účet Azure Maps a dá se načíst z rozhraní API účtu roviny správy Azure Maps. Informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v následujících článcích s pokyny.

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.
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í: POI 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	Ohraničující rámeček umístění.
buildingNumber	string	Číslo budovy na ulici. ZASTARALÉ, použijte místo toho argument streetNumber.
country	string	název země/oblasti
countryCode	string	Země (Poznámka: Jedná se o dvoumísmenný kód, nikoli název země/oblasti.)
countryCodeISO3	string	Kód země ISO alfa-3
countrySecondarySubdivision	string	Kraj
countrySubdivision	string	Stát nebo provincie
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.
countrySubdivisionName	string	Úplný název první úrovně hierarchie pro správu země/oblasti. Toto pole se zobrazí pouze v případě, že se zeměSubdivision 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á se překříží.
extendedPostalCode	string	Rozšířená PSČ (dostupnost závisí na oblasti).
freeformAddress	string	Řádek adresy naformátovaný podle pravidel formátování země nebo oblasti původu výsledku nebo v případě země/oblasti má úplný název země/oblasti.
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 `municipalitylocalName` .
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. U běžně známého názvu města nebo města se navrhuje, aby se místo hodnoty `municipality` použila hodnota `localName`.
municipalitySubdivision	string	Sub / Super City
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	PSČ / PSČ
routeNumbers	string[]	Kódy používané k jednoznačné identifikaci ulice
street	string	Název ulice. ZASTARALÉ, použijte místo toho název ulice.
streetName	string	Název ulice.
streetNameAndNumber	string	Název a číslo ulice.
streetNumber	string	Číslo budovy na ulici.

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
CountrySecondarySubdivision	Kraj
CountrySubdivision	Stát nebo provincie
CountryTertiarySubdivision	Pojmenovaná oblast
Municipality	Město / město
MunicipalitySubdivision	Sub / 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)
Auto	Vrátí data mapy na základě IP adresy požadavku.
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)
Unified	Jednotné zobrazení (ostatní)
YE	Jemen (arabské zobrazení)

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.

Hodnota	Description
NEARBY	Hledání bylo provedeno kolem 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í: AddressPoint HouseNumberRange 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ů.
type	SearchAddressResultType	Jedna z těchto možností: POI 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í:

POI
Ulice
Zeměpis
Adresa bodu
Rozsah adres
Křížová ulice

Hodnota	Description
Address Range
Cross Street
Geography
POI
Point Address
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.
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

Další materiály