Search - Post Search Inside Geometry

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.0

További geometriákban végezhet ingyenes űrlapkereséseket.

A Post Search Inside Geometry API és a HTTP 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 POSTrequest where the request body will contain thegeometriaobject 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** Thegeometriacan be represented as aGeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50GeoJSON featureobjects. EachFeatureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AFeatureobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>AFunkcióobject for the Circle geometry is composed of a _center_ represented using aGeoJSON-ponttype 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** Thegeometriacan 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** Thegeometriacan 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' ábrázolása.

.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
format	path	True	ResponseFormat	A válasz kívánt formátuma. Az érték lehet json vagy xml.
api-version	query	True	string	Az Azure Maps API verziószáma.
query	query	True	string	A keresendő POI-név (pl. "szabadságszobor", "starbucks", "pizza"). Az URL-címnek megfelelően kell kódolva lennie.
categorySet	query		integer[]	A kategóriakészlet azonosítóinak vesszővel tagolt listája, amellyel az eredményt meghatározott érdeklődési pontok kategóriáira korlátozhatja. Az azonosító sorrendje nem számít. A kérelemenként támogatott `categorySet` értékek maximális száma 10. Ha több kategóriaazonosítót ad meg, a rendszer csak azokat a POI-kat adja vissza, amelyek a megadott lista valamelyik kategóriájához tartoznak (legalább). A támogatott kategóriák listája POI-kategóriák API használatával deríthető fel. Használati példák: categorySet=7315 (Keresési pontok az Étterem kategóriából) categorySet=7315025,7315017 (Az olasz vagy francia étterem kategória keresőpontjai)
extendedPostalCodesFor	query		SearchIndexes[]	Az eredményekben szerepelnie kell azoknak az indexeknek, amelyekhez kiterjesztett irányítószámokat kell megadni. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi területek PAD = Pontcímek POI = Érdekes pontok Str = Utcák XStr = Keresztutcák (metszetek) Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), vagy Nincs indexek nélkül. Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák elég hosszúak lehetnek, ezért szükség esetén explicit módon kell őket kérni. Használati példák: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő.
idxSet	query		SearchIndexes[]	A kereséshez használandó indexek vesszővel tagolt listája. Az elemsorrend nem számít. Az elérhető indexek a következők: Addr = Címtartomány interpolációja, Geo = Geographies, PAD = Point Addresses, POI = Points of interest, Str = Streets, Xstr = Cross Streets (metszetek)
language	query		string	Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvi címkék egyikének kell lennie, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven lévő adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg támogatott nyelvek.
limit	query		integer minimum: 1 maximum: 100	A visszaadott válaszok maximális száma. Alapértelmezett: 10, minimum: 1 és maximum: 100
openingHours	query		OperatingHoursRange	Nyitvatartási idő egy POI-hoz (érdekes pontok). A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem érkezik meg, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays
view	query		LocalizedMapView	A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter akkor is "Egyesített" értékre van állítva, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozókat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalom elérhetővé válik. Példa: view=IN. A részletekért tekintse meg támogatott nézeteket, és tekintse meg az elérhető nézeteket.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Megadja, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.

Kérelem törzse

Name	Típus	Description
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Érvényes `GeoJSON` objektum. Részletekért tekintse meg RFC 7946.

Válaszok

Name	Típus	Description
200 OK	SearchAddressResult	OKÉ
Other Status Codes	ErrorResponse	Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok . Ha Azure-beli szerepköralapú hozzáférés- vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörön vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörön keresztül.

Forgatókönyvek implementálásához javasoljuk, hogy tekintse meg hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást kínál az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Megjegyzés

Ez a biztonsági definíciós megköveteli, hogy a x-ms-client-id fejléc használatával jelezze, hogy melyik Azure Maps-erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps felügyeleti API-ból szerezhető be.
A Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra-azonosító konfigurációkkal rendelkeznek.
Az Azure szerepköralapú hozzáférés-vezérlés a Azure felügyeleti síkjáról van konfigurálva, az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kkal vagy REST API-kkal.
Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esethez.
További információ a Microsoft identitásplatformról: Microsoft Identitásplatform áttekintése.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiók létrehozása az Azure Portalon, vagy PowerShell, CLI, Azure SDK vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy használja a bizalmas ügyfélalkalmazásokat, megközelítést az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre a Azure Maps-erőforráson az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult az Azure szerepköralapú hozzáférés-vezérlőivel való hozzáférésre, valamint az adott jogkivonat lejáratának, sebességének és régióinak részletes szabályozására. Más szóval az SAS-jogkivonat segítségével az alkalmazások biztonságosabban szabályozhatják a hozzáférést, mint a megosztott kulcs.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfigurálja a -fiók erőforrás- engedélyezett forrásainak listáját a renderelési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

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

Mintakérelem

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
            ]
          ]
        ]
      }
    ]
  }
}

Mintaválasz

Állapotkó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

Mintakérelem

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
        }
      }
    ]
  }
}

Mintaválasz

Állapotkó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

Mintakérelem

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
        ]
      ]
    ]
  }
}

Mintaválasz

Állapotkó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
          }
        }
      ]
    }
  ]
}

Definíciók

Name	Description
Address	Az eredmény címe
AddressRanges	Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményekhez. A címtartomány kezdő és záró helyének koordinátáit is tartalmazza a rendszer.
BoundingBox	A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport.
BoundingBoxCompassNotation	A hely határolókerete.
Brand	A POI-hoz társított márka
Classification	A visszaadott POI besorolása
ClassificationName	A besorolás neve
DataSources	Nem kötelező szakasz. Referenciaazonosítók a Keresési sokszög lekérése API-hoz.
Entity	A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval.
EntryPoint	A visszaadott POI belépési pontja.
EntryPointType	A belépési pont típusa. Az érték lehet fő vagy kisebb.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
GeographicEntityType	Földrajzi entitás típusa. Csak az entityType kérése után jelenik meg, és elérhető.
GeoJsonFeature	Érvényes `GeoJSON Feature` objektumtípus. Részletekért tekintse meg RFC 7946.
GeoJsonFeatureCollection	Érvényes `GeoJSON FeatureCollection` objektumtípus. Részletekért tekintse meg RFC 7946.
GeoJsonGeometry	Érvényes `GeoJSON` geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon és GeometryCollection. Részletekért tekintse meg RFC 7946.
GeoJsonGeometryCollection	Érvényes `GeoJSON GeometryCollection` objektumtípus. Részletekért tekintse meg RFC 7946.
GeoJsonLineString	Érvényes `GeoJSON LineString` geometriatípus. Részletekért tekintse meg RFC 7946.
GeoJsonMultiLineString	Érvényes `GeoJSON MultiLineString` geometriatípus. Részletekért tekintse meg RFC 7946.
GeoJsonMultiPoint	Érvényes `GeoJSON MultiPoint` geometriatípus. Részletekért tekintse meg RFC 7946.
GeoJsonMultiPolygon	Érvényes `GeoJSON MultiPolygon` objektumtípus. Részletekért tekintse meg RFC 7946.
GeoJsonPoint	Érvényes `GeoJSON Point` geometriatípus. Részletekért tekintse meg RFC 7946.
GeoJsonPolygon	Érvényes `GeoJSON Polygon` geometriatípus. Részletekért tekintse meg RFC 7946.
Geometry	Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely.
LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.
LocalizedMapView	A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter akkor is "Egyesített" értékre van állítva, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozókat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalom elérhetővé válik. Példa: view=IN. A részletekért tekintse meg támogatott nézeteket, és tekintse meg az elérhető nézeteket.
MatchType	A fordított címkeresési művelet egyezésének típusai.
OperatingHours	A POI nyitvatartási ideje (érdekes pontok).
OperatingHoursRange	Nyitvatartási idő egy POI-hoz (érdekes pontok). A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem érkezik meg, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays
OperatingHoursTime	Dátumot és időt jelöl
OperatingHoursTimeRange	Nyitott időtartomány egy napra
PointOfInterest	A visszaadott poI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások.
PointOfInterestCategorySet	POI-kategória
QueryType	A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.
ResponseFormat	A válasz kívánt formátuma. Az érték lehet json vagy xml.
SearchAddressResult	Ezt az objektumot egy sikeres keresési hívás adja vissza.
SearchAddressResultItem	Keresési API-válasz eredményobjektuma.
SearchAddressResultType	Az alábbiak egyike: POI Utca Földrajz Pont címe Címtartomány Kereszt utca
SearchIndexes	Az eredményekben szerepelnie kell azoknak az indexeknek, amelyekhez kiterjesztett irányítószámokat kell megadni. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi területek PAD = Pontcímek POI = Érdekes pontok Str = Utcák XStr = Keresztutcák (metszetek) Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), vagy Nincs indexek nélkül. Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák elég hosszúak lehetnek, ezért szükség esetén explicit módon kell őket kérni. Használati példák: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő.
SearchInsideGeometryRequest	Ez a típus a Search Inside Geometry szolgáltatás kéréstörzsét jelöli.
SearchSummary	Keresési API-válasz összegzési objektuma.

Address

Objektum

Az eredmény címe

Name	Típus	Description
boundingBox	BoundingBoxCompassNotation	A hely határolókerete.
buildingNumber	string	Az utca épületszáma. ELAVULT, használja helyette a streetNumber függvényt.
country	string	ország/régió neve
countryCode	string	Ország (Megjegyzés: Ez egy kétbetűs kód, nem ország/régió neve.)
countryCodeISO3	string	ISO alpha-3 országkód
countrySecondarySubdivision	string	Megye
countrySubdivision	string	Állam vagy tartomány
countrySubdivisionCode	string	`countrySubdivisionCode` `countryCode` (countryCode-countrySubdivisionCode) előtagja és a kötőjel képezi az ISO 3166-2 kódot. Példák: TX for Texas, SCT for Scotland és ON for Ontario.
countrySubdivisionName	string	Az ország-/régiószintű felügyeleti hierarchia első szintjének teljes neve. Ez a mező csak abban az esetben jelenik meg, ha a CountrySubdivision rövidített formában jelenik meg. Csak az USA, Kanada és az Egyesült Királyság esetében támogatott.
countryTertiarySubdivision	string	Elnevezett terület
crossStreet	string	A keresztezett utca neve.
extendedPostalCode	string	Kiterjesztett irányítószám (a rendelkezésre állás a régiótól függ).
freeformAddress	string	Egy eredmény származási országának/régiójának formázási szabályai szerint formázott címsor, illetve ország/régió esetén annak teljes országa/régiója neve.
localName	string	Olyan címösszetevő, amely egy olyan földrajzi terület vagy hely nevét jelöli, amely címzés céljából több címezhető objektumot csoportosít, rendszergazdai egység nélkül. Ez a mező a `freeformAddress` tulajdonság létrehozásához használható. `localName` a postai önkormányzatot képviseli. A helytől függően a `localName` egy város vagy város általánosan ismert neve. Egy város vagy város köznapi neveként használja a `localName` helyett `municipality`.
municipality	string	Város / Város Megjegyzés: `municipality` a lakóközösséget jelöli. A helytől függően a `municipality` érték eltérhet egy város vagy város általánosan ismert nevétől. A város vagy város általánosan ismert neve esetén a `localName` érték használata javasolt a `municipality` érték helyett.
municipalitySubdivision	string	Al- és szuperváros
neighbourhood	string	A szomszédság egy földrajzilag honosított terület egy városon vagy városon belül, megkülönböztető jellemzőkkel és a lakosok közötti társadalmi interakciókkal.
postalCode	string	Irányítószám / Irányítószám
routeNumbers	string[]	Az utca egyértelmű azonosítására használt kódok
street	string	Az utcanév. ELAVULT, használja helyette a streetName nevet.
streetName	string	Az utcanév.
streetNameAndNumber	string	Az utcanév és a szám.
streetNumber	string	Az utca épületszáma.

AddressRanges

Objektum

Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményekhez. A címtartomány kezdő és záró helyének koordinátáit is tartalmazza a rendszer.

Name	Típus	Description
from	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.
rangeLeft	string	Címtartomány az utca bal oldalán.
rangeRight	string	Címtartomány az utca jobb oldalán.
to	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.

BoundingBox

Objektum

A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport.

Name	Típus	Description
btmRightPoint	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.
topLeftPoint	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.

BoundingBoxCompassNotation

Objektum

A hely határolókerete.

Name	Típus	Description
entity	Entity	A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval.
northEast	string	Északkeleti szélesség,a határolókeret hosszúsági koordinátája vesszővel tagolt úszóként
southWest	string	Dél-nyugati szélesség, a határolókeret hosszúsági koordinátája vesszővel tagolt úszóként

Brand

Objektum

A POI-hoz társított márka

Name	Típus	Description
name	string	A márka neve

Classification

Objektum

A visszaadott POI besorolása

Name	Típus	Description
code	string	Kód jellemzője
names	ClassificationName[]	Névtömb

ClassificationName

Objektum

A besorolás neve

Name	Típus	Description
name	string	Név tulajdonság
nameLocale	string	Név területi beállítása tulajdonság

DataSources

Objektum

Nem kötelező szakasz. Referenciaazonosítók a Keresési sokszög lekérése API-hoz.

Name	Típus	Description
geometry	Geometry	Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely.

Entity

Enumerálás

A határolókeret entitástípus-forrása. Fordított geokódolás esetén ez mindig egyenlő a pozícióval.

Érték	Description
position	Pozíció entitás

EntryPoint

Objektum

A visszaadott POI belépési pontja.

Name	Típus	Description
position	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.
type	EntryPointType	A belépési pont típusa. Az érték lehet fő vagy kisebb.

EntryPointType

Enumerálás

A belépési pont típusa. Az érték lehet fő vagy kisebb.

Érték	Description
main
minor

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

GeographicEntityType

Enumerálás

Földrajzi entitás típusa. Csak az entityType kérése után jelenik meg, és elérhető.

Érték	Description
Country	ország/régió neve
CountrySecondarySubdivision	Megye
CountrySubdivision	Állam vagy tartomány
CountryTertiarySubdivision	Elnevezett terület
Municipality	Város / Város
MunicipalitySubdivision	Al- és szuperváros
Neighbourhood	Szomszédság
PostalCodeArea	Irányítószám / Irányítószám

GeoJsonFeature

Objektum

Érvényes GeoJSON Feature objektumtípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
featureType	string	A szolgáltatás típusa. Az érték attól függ, hogy az aktuális funkció melyik adatmodell része. Egyes adatmodellek üres értékkel rendelkezhetnek.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Érvényes `GeoJSON` geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon és GeometryCollection. Részletekért tekintse meg RFC 7946.
id	string	A szolgáltatás azonosítója.
type	string: Feature	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonFeatureCollection

Objektum

Érvényes GeoJSON FeatureCollection objektumtípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
features	GeoJsonFeature[]	Az érvényes `GeoJSON Feature` objektumok listáját tartalmazza.
type	string: FeatureCollection	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonGeometry

Objektum

Érvényes GeoJSON geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon és GeometryCollection. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
type	GeoJsonObjectType	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonGeometryCollection

Objektum

Érvényes GeoJSON GeometryCollection objektumtípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Érvényes `GeoJSON` geometriai objektumok listáját tartalmazza. Vegye figyelembe, hogy a GeoJSON koordinátái x, y sorrendben vannak (hosszúság, szélesség).
type	string: GeometryCollection	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonLineString

Objektum

Érvényes GeoJSON LineString geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `GeoJson LineString` geometria koordinátái.
type	string: LineString	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiLineString

Objektum

Érvényes GeoJSON MultiLineString geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `GeoJson MultiLineString` geometria koordinátái.
type	string: MultiLineString	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiPoint

Objektum

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `GeoJson MultiPoint` geometria koordinátái.
type	string: MultiPoint	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonMultiPolygon

Objektum

Érvényes GeoJSON MultiPolygon objektumtípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	Az érvényes `GeoJSON Polygon` objektumok listáját tartalmazza. Vegye figyelembe, hogy a GeoJSON koordinátái x, y sorrendben vannak (hosszúság, szélesség).
type	string: MultiPolygon	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonPoint

Objektum

Érvényes GeoJSON Point geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `Position` két vagy több elemet tartalmazó számtömb. Az első két elem hosszúsági és szélességi, pontosan ebben a sorrendben. magassági/magassági nem kötelező harmadik elem. Részletekért tekintse meg RFC 7946.
type	string: Point	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonPolygon

Objektum

Érvényes GeoJSON Polygon geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `GeoJson Polygon` geometriatípus koordinátái.
type	string: Polygon	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

Geometry

Objektum

Információ az eredmény geometriai alakjáról. Csak akkor jelenik meg, ha a típus == Földrajzi hely.

Name	Típus	Description
id	string	Adja át ezt geometriaazonosítóként a Keresési sokszög lekérése API-nak az eredmény geometriai adatainak lekéréséhez.

LatLongPairAbbreviated

Objektum

Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.

Name	Típus	Description
lat	number (double)	Latitude tulajdonság
lon	number (double)	Hosszúság tulajdonság

LocalizedMapView

Enumerálás

A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter akkor is "Egyesített" értékre van állítva, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozókat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalom elérhetővé válik. Példa: view=IN.

A részletekért tekintse meg támogatott nézeteket, és tekintse meg az elérhető nézeteket.

Érték	Description
AE	Egyesült Arab Emírségek (arab nézet)
AR	Argentína (argentin nézet)
Auto	Adja vissza a leképezési adatokat a kérés IP-címe alapján.
BH	Bahrein (arab nézet)
IN	India (indiai nézet)
IQ	Irak (arab nézet)
JO	Jordánia (arab nézet)
KW	Kuvait (arab nézet)
LB	Libanon (arab nézet)
MA	Marokkó (marokkói nézet)
OM	Omán (arab nézet)
PK	Pakisztán (pakisztáni nézet)
PS	Palesztin Hatóság (arab nézet)
QA	Katar (arab nézet)
SA	Szaúd-Arábia (arab nézet)
SY	Szíria (arab nézet)
Unified	Egyesített nézet (egyebek)
YE	Jemen (arab nézet)

MatchType

Enumerálás

A fordított címkeresési művelet egyezésének típusai.

Érték	Description
AddressPoint
HouseNumberRange
Street

OperatingHours

Objektum

A POI nyitvatartási ideje (érdekes pontok).

Name	Típus	Description
mode	string	A kérelemben használt érték: nincs vagy "nextSevenDays"
timeRanges	OperatingHoursTimeRange[]	A következő 7 nap időtartományainak listája

OperatingHoursRange

Enumerálás

Nyitvatartási idő egy POI-hoz (érdekes pontok). A rendelkezésre álló munkaórák elérhetősége a rendelkezésre álló adatoktól függően változik. Ha nem érkezik meg, akkor a rendszer nem ad vissza nyitvatartási adatokat. Támogatott érték: nextSevenDays

Érték	Description
nextSevenDays	A következő hét műveleti óráit jeleníti meg, kezdve a poI helyi idejének aktuális napjával.

OperatingHoursTime

Objektum

Dátumot és időt jelöl

Name	Típus	Description
date	string	Az aktuális naptárdátumot jelöli a POI időzónájában, például "2019-02-07".
hour	integer	Az órák 24 órás formátumban vannak a POI helyi idején; lehetséges értékek: 0 – 23.
minute	integer	A percek a poI helyi idejében vannak; lehetséges értékek: 0 –59.

OperatingHoursTimeRange

Objektum

Nyitott időtartomány egy napra

Name	Típus	Description
endTime	OperatingHoursTime	A következő 7 napos tartomány azon pontja, amikor egy adott POI zárva van, vagy a tartomány elejére, ha az a tartomány előtt volt lezárva.
startTime	OperatingHoursTime	A következő 7 napos tartomány azon pontja, amikor egy adott POI-t nyit meg, vagy a tartomány elejét, ha a tartomány előtt nyitották meg.

PointOfInterest

Objektum

A visszaadott poI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások.

Name	Típus	Description
brands	Brand[]	Márkák tömb. A visszaadott POI márkaneve.
categories	string[]	Kategóriák tömb
categorySet	PointOfInterestCategorySet[]	A legspecifikusabb POI-kategóriák listája
classifications	Classification[]	Besorolási tömb
name	string	A POI tulajdonság neve
openingHours	OperatingHours	A POI nyitvatartási ideje (érdekes pontok).
phone	string	Telefonszám tulajdonság
url	string	Webhely URL-címe tulajdonság

PointOfInterestCategorySet

Objektum

POI-kategória

Name	Típus	Description
id	integer	Kategóriaazonosító

QueryType

Enumerálás

A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.

Érték	Description
NEARBY	A keresés egy meghatározott sugarú szélességi és hosszúsági kör körül történt
NON_NEAR	A keresés globálisan, egy adott szélességre és hosszúságra való torzítás nélkül, meghatározott sugár nélkül történt

ResponseFormat

Enumerálás

A válasz kívánt formátuma. Az érték lehet json vagy xml.

Érték	Description
json	A JavaScript objektum jelölési adatcseréjének formátuma
xml	Bővíthető korrektúranyelv

SearchAddressResult

Objektum

Ezt az objektumot egy sikeres keresési hívás adja vissza.

Name	Típus	Description
results	SearchAddressResultItem[]	A Search API eredményeinek listája.
summary	SearchSummary	Keresési API-válasz összegzési objektuma

SearchAddressResultItem

Objektum

Keresési API-válasz eredményobjektuma.

Name	Típus	Description
address	Address	Az eredmény címe
addressRanges	AddressRanges	Az utca mindkét oldalán található címtartományt ismerteti a keresési eredményekhez. A címtartomány kezdő és záró helyének koordinátáit is tartalmazza a rendszer.
dataSources	DataSources	Nem kötelező szakasz. Referenciageometriai azonosító a Keresési sokszög API-val való használatához.
detourTime	integer	Kitérő idő másodpercben. Csak a Search Along Route API-ra irányuló hívások esetén ad vissza.
dist	number (double)	Egyenes vonal távolsága az eredmény és a geobiák helye között méterben.
entityType	GeographicEntityType	Földrajzi entitás típusa. Csak az entityType kérése után jelenik meg, és elérhető.
entryPoints	EntryPoint[]	EntryPoint-tömb. Ezek a helyszínen elérhető bejáratok típusait írják le. A típus lehet "fő" a főbejáratokhoz, például a bejárati ajtóhoz vagy az előszobához, valamint a "minor" típushoz az oldalsó és a hátsó ajtók esetében.
id	string	Azonosító tulajdonság
info	string	Információk az eredmény eredeti adatforrásáról. Támogatási kérelmekhez használható.
matchType	MatchType	Információ az egyezés típusáról. Az alábbiak egyike: AddressPoint HouseNumberRange Utca
poi	PointOfInterest	A visszaadott poI részletei, beleértve az olyan információkat, mint a név, a telefon, az URL-cím és a besorolások.
position	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként ábrázolt hely a "lat" & "lon" rövid nevek használatával.
score	number (double)	Az eredményhalmazon belüli érték, amely az eredmények közötti relatív egyező pontszámot jelzi. Ezzel megállapíthatja, hogy az x eredmény kétszer akkora valószínűséggel lesz releváns, mint y, ha az x értéke 2x az y értékével. Az értékek lekérdezésenként eltérőek, és csak egy eredményhalmaz relatív értékeként szolgálnak.
type	SearchAddressResultType	Az alábbiak egyike: POI Utca Földrajz Pont címe Címtartomány Kereszt utca
viewport	BoundingBox	A nézetport bal felső és jobb alsó koordinátái által képviselt eredményt lefedő nézetport.

SearchAddressResultType

Enumerálás

Az alábbiak egyike:

POI
Utca
Földrajz
Pont címe
Címtartomány
Kereszt utca

Érték	Description
Address Range
Cross Street
Geography
POI
Point Address
Street

SearchIndexes

Enumerálás

Az eredményekben szerepelnie kell azoknak az indexeknek, amelyekhez kiterjesztett irányítószámokat kell megadni.

Az elérhető indexek a következők:

Addr = Címtartományok

Geo = Földrajzi területek

PAD = Pontcímek

POI = Érdekes pontok

Str = Utcák

XStr = Keresztutcák (metszetek)

Az értéknek az indextípusok vesszővel tagolt listájának kell lennie (bármilyen sorrendben), vagy Nincs indexek nélkül.

Alapértelmezés szerint a kiterjesztett irányítószámokat a Geo kivételével minden index tartalmazza. A földrajzi helyekre vonatkozó kiterjesztett irányítószám-listák elég hosszúak lehetnek, ezért szükség esetén explicit módon kell őket kérni.

Használati példák:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

A kiterjesztett irányítószám egy cím extendedPostalCode tulajdonságaként lesz visszaadva. A rendelkezésre állás régiófüggő.

Érték	Description
Addr
Geo
PAD
POI
Str
Xstr

SearchInsideGeometryRequest

Objektum

Ez a típus a Search Inside Geometry szolgáltatás kéréstörzsét jelöli.

Name	Típus	Description
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Érvényes `GeoJSON` objektum. Részletekért tekintse meg RFC 7946.

SearchSummary

Objektum

Keresési API-válasz összegzési objektuma.

Name	Típus	Description
fuzzyLevel	integer	Az eredmények megadásához szükséges maximális fuzzy szint.
geoBias	LatLongPairAbbreviated	Annak jelzése, hogy a belső keresőmotor mikor alkalmazott térinformatikai torzításokat az eredmények rangsorolásának javítása érdekében. Bizonyos módszerekben ez a lat és a lon paraméterek beállításával befolyásolható, ahol elérhető. Más esetekben ez tisztán belső.
limit	integer	A visszaadott válaszok maximális száma
numResults	integer	A válaszban szereplő eredmények száma.
offset	integer	A visszaadott eredmények kezdő eltolása a teljes eredménykészleten belül.
query	string	A keresési eredmények előállításához használt lekérdezési paraméter.
queryTime	integer	A lekérdezés feloldásával töltött idő ezredmásodpercben.
queryType	QueryType	A visszaadott lekérdezés típusa: KÖZELI vagy NON_NEAR.
totalResults	integer	A talált eredmények teljes száma.

Megosztás a következőn keresztül:

Search - Post Search Inside Geometry

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Biztonság

AADToken

Hatókörök

subscription-key

SAS Token

Példák

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

Mintakérelem

Mintaválasz

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

Mintakérelem

Mintaválasz

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

Mintakérelem

Mintaválasz

Definíciók

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

További források