Search - Post Search Inside Geometry

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.0

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

Az 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 FeatureCollection FeatureCollectioncan contain a max of 50object. This is the recommended option if the geometry contains both Polygons and Circles. TheGeoJSON featureobjects. EachFeatureobject 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** Thegeometriacan be represented as aGeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeoJSON Polygon GeometryCollectioncan contain a max of 50GeoJSON Polygonobjects. Eachobject 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 Polygon Polygon Polygonobject. This is the recommended option if the geometry contains a single Polygon. Theobject can have a max of 50 coordinates. Please see the Examples section below for a sampleSokszög á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	A 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 értékek maximális száma `categorySet` 10. Ha több kategóriaazonosítót ad meg, a rendszer csak azokat a POI-kat adja vissza, amelyek a megadott listában szereplő kategóriák valamelyikéhez tartoznak (legalább). A támogatott kategóriák listája a POI Categories API használatával deríthető fel. Használati példák: categorySet=7315 (Keresés Érdekességek az Étterem kategóriából) categorySet=7315025,7315017 (Keresés kategória érdekes pontjai olasz vagy francia étterem)
extendedPostalCodesFor	query		SearchIndexes[]	Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi helyek 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), indexek nélkül pedig Nincs . 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 meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell kérni őket. 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. A cikk sorrendje nem számít. A rendelkezésre álló 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	Nyelv, amelyben a keresési eredményeket vissza kell adni. Az egyik támogatott IETF-nyelvi címke, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven megadott adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. A részletekért tekintse meg a Támogatott nyelvek című témakört .
limit	query		integer	A visszaadott válaszok maximális száma. Alapértelmezett: 10, minimum: 1 és maximum: 100
openingHours	query		OperatingHoursRange	A POI (érdeklődési pontok) nyitvatartási ideje. 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 eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, 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érelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. A Azure Maps fiók egyedi azonosítóját jelöli, és lekérhető a Azure Maps felügyeleti sík fiók API-jából. A biztonsági Microsoft Entra ID Azure Maps az alábbi cikkekben talál útmutatást.

Kérelem törzse

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

Válaszok

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

Biztonság

AADToken

Ezek az OAuth 2.0-folyamatok Microsoft Entra. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható a 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örrel vagy egy vagy több, a REST API-khoz Azure Maps engedélyekkel rendelkező egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt 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ó a fejléc használatával x-ms-client-id jelzi, hogy az alkalmazás melyik Azure Maps erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.
Ez 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 ID konfigurációkkal rendelkeznek.
Az Azure szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.
A Azure Maps Webes SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esethez.
A Microsoft Identitásplatform kapcsolatos további információkért lásd: Microsoft Identitásplatform áttekintés.

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ókot hoz létre a Azure Portal vagy a PowerShell, a CLI, az Azure SDK-k vagy a 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.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével férhessen hozzá Azure Maps REST API-khoz, 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, amely a Azure Maps erőforrás SAS listázási műveletéből jön létre az Azure felügyeleti síkján keresztül Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy konfigurálja az engedélyezett források adott listáját a Térképfiók erőforráson a megjeleníté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.
BoundingBox	A nézetport bal felső és jobb alsó koordinátái által ábrázolt 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 Get Keresés Polygon API-val való használathoz.
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 alérték.
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 akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető.
GeoJsonFeature	Érvényes `GeoJSON Feature` objektumtípus. A részletekért tekintse meg az RFC 7946-ot .
GeoJsonFeatureCollection	Érvényes `GeoJSON FeatureCollection` objektumtípus. A részletekért tekintse meg az RFC 7946-ot .
GeoJsonGeometry	Érvényes `GeoJSON` geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részleteket az RFC 7946-os verziójában találja.
GeoJsonGeometryCollection	Érvényes `GeoJSON GeometryCollection` objektumtípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonLineString	Érvényes `GeoJSON LineString` geometriatípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonMultiLineString	Érvényes `GeoJSON MultiLineString` geometriatípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonMultiPoint	Érvényes `GeoJSON MultiPoint` geometriatípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonMultiPolygon	Érvényes `GeoJSON MultiPolygon` objektumtípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonPoint	Érvényes `GeoJSON Point` geometriatípus. A részleteket az RFC 7946-os verziójában találja.
GeoJsonPolygon	Érvényes `GeoJSON Polygon` geometriatípus. A részleteket az RFC 7946-os verziójában találja.
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 jelölt hely, "lat" rövid névvel, & "lon".
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 eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, 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érelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN. A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.
MatchType	A fordított címkeresési művelethez tartozó egyezések típusai.
OperatingHours	PoI nyitvatartási ideje (érdekes pontok).
OperatingHoursRange	A POI (érdeklődési pontok) nyitvatartási ideje. 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őpontot 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és hívás adja vissza.
SearchAddressResultItem	Eredményobjektum egy Keresés API-válaszhoz.
SearchAddressResultType	Az alábbiak egyike: POI Utca Földrajzi hely Pont címe Címtartomány Kereszt utca
SearchIndexes	Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe. Az elérhető indexek a következők: Addr = Címtartományok Geo = Földrajzi helyek 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), indexek nélkül pedig Nincs . 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 meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell kérni őket. 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 Keresés Inside Geometry szolgáltatás kéréstörzsét jelöli.
SearchSummary	Egy Keresés API-válasz összefoglaló objektuma.

Address

Az eredmény címe

Name	Típus	Description
boundingBox	BoundingBoxCompassNotation	A hely határolókerete.
buildingNumber	string	Az épület száma az utcán. ELAVULT, használja helyette a streetNumber parancsot.
country	string	ország/régió neve
countryCode	string	Country (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` az előtagja `countryCode` ( countryCode-countrySubdivisionCode ) és a kötőjel alkotja az ISO 3166-2 kódot. Példák: TX Texashoz, SCT Skóciához és ON Ontarióhoz.
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	Az 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ágának/régiójának neve.
localName	string	Egy olyan címösszetevő, amely egy olyan földrajzi terület vagy hely nevét jelöli, amely több címezhető objektumot csoportosít címzés céljából, felügyeleti egység nélkül. Ez a mező a tulajdonság összeállítására `freeformAddress` szolgál. `localName` a postai önkormányzatot jelöli. A helytől `localName` függően a város vagy város általánosan ismert neve. Egy város vagy város általánosan ismert neveként használja `localName` a következőt: `municipality`.
municipality	string	Város /város Megjegyzés: `municipality` a lakótelepi önkormányzatot jelöli. A helytől függően az `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 nevének használata javasolt az `localName` érték helyett `municipality` .
municipalitySubdivision	string	Al- és Szuperváros
neighbourhood	string	A szomszédság egy földrajzilag honosított terület egy városban vagy városban, jellegzetes jellemzőkkel és a lakosság 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 utca neve és száma.
streetNumber	string	Az épület száma az utcán.

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.

Name	Típus	Description
from	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".
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 jelölt hely, "lat" rövid névvel, & "lon".

BoundingBox

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

Name	Típus	Description
btmRightPoint	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".
topLeftPoint	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".

BoundingBoxCompassNotation

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	Észak-keleti szélesség, a határolókeret hosszúsági koordinátája vesszővel tagolt lebegőpontos lebegőpontosként
southWest	string	Dél-nyugati szélesség, a határolókeret hosszúsági koordinátája vesszővel tagolt úszókként

Brand

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

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

Classification

A visszaadott POI besorolása

Name	Típus	Description
code	string	Kód tulajdonság
names	ClassificationName[]	Névtömb

ClassificationName

A besorolás neve

Name	Típus	Description
name	string	Name tulajdonság
nameLocale	string	Name Locale tulajdonság

DataSources

Nem kötelező szakasz. Referenciaazonosítók a Get Keresés Polygon API-val való használathoz.

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

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

Name	Típus	Description
position	string	Pozíció entitás

EntryPoint

A visszaadott POI belépési pontja.

Name	Típus	Description
position	LatLongPairAbbreviated	Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".
type	EntryPointType	A belépési pont típusa. Az érték lehet fő vagy alérték.

EntryPointType

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

Name	Típus	Description
main	string
minor	string

ErrorAdditionalInfo

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 adattípus.

ErrorDetail

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 hiba célja.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

GeographicEntityType

Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, és elérhető.

Name	Típus	Description
Country	string	ország/régió neve
CountrySecondarySubdivision	string	Megye
CountrySubdivision	string	Állam vagy tartomány
CountryTertiarySubdivision	string	Elnevezett terület
Municipality	string	Város /város
MunicipalitySubdivision	string	Al- és Szuperváros
Neighbourhood	string	Szomszédságában
PostalCodeArea	string	Irányítószám / Irányítószám

GeoJsonFeature

Érvényes GeoJSON Feature objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

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, Vonallánc, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részletekért tekintse meg az RFC 7946-ot .
id	string	A funkció azonosítója.
type	string: Feature	Megadja a típust `GeoJSON` . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

GeoJsonFeatureCollection

Érvényes GeoJSON FeatureCollection objektumtípus. A részletekért tekintse meg az RFC 7946-ot .

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

GeoJsonGeometry

Érvényes GeoJSON geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részleteket az RFC 7946-os verziójában találja.

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

GeoJsonGeometryCollection

Érvényes GeoJSON GeometryCollection objektumtípus. A részleteket az RFC 7946-os verziójában találja.

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

GeoJsonLineString

Érvényes GeoJSON LineString geometriatípus. A részleteket az RFC 7946-os verziójában találja.

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

GeoJsonMultiLineString

Érvényes GeoJSON MultiLineString geometriatípus. A részleteket az RFC 7946-os verziójában találja.

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

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. A részleteket az RFC 7946-os verziójában találja.

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

GeoJsonMultiPolygon

Érvényes GeoJSON MultiPolygon objektumtípus. A részleteket az RFC 7946-os verziójában találja.

Name	Típus	Description
coordinates	number[]	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 típust `GeoJSON` . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature és FeatureCollection.

GeoJsonPoint

Érvényes GeoJSON Point geometriatípus. A részleteket az RFC 7946-os verziójában találja.

Name	Típus	Description
coordinates	number[]	Az A `Position` két vagy több elemet tartalmazó számtömb. Az első két elem a hosszúság és a szélesség, pontosan ebben a sorrendben. A magasság/magasság nem kötelező harmadik elem. A részleteket az RFC 7946-os verziójában találja.
type	string: Point	Megadja a típust `GeoJSON` . A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature és FeatureCollection.

GeoJsonPolygon

Érvényes GeoJSON Polygon geometriatípus. A részleteket az RFC 7946-os verziójában találja.

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

Geometry

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 Get Keresés Polygon API-nak az eredmény geometriai információinak lekéréséhez.

LatLongPairAbbreviated

Földrajzi szélességként és hosszúságként jelölt hely, "lat" rövid névvel, & "lon".

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

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 eltérő nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen annak az országnak/régiónak, amelyet az alkalmazás használni fog. Alapértelmezés szerint a Nézet paraméter "Egyesített" értékre van állítva, még akkor is, 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érelem IP-címe alapján adja vissza a térképadatokat. A View paramétert Azure Maps a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a térképekkel kapcsolatos jogszabályokat is, azon ország/régió vonatkozásában, ahol a térképeket, képeket és egyéb adatokat, valamint a Azure Maps keresztüli hozzáférésre jogosult harmadik féltől származó tartalmakat elérhetővé teszik. Példa: view=IN.

A részletekért tekintse meg a Támogatott nézetek című témakört , és tekintse meg az elérhető nézeteket.

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

MatchType

A fordított címkeresési művelethez tartozó egyezések típusai.

Name	Típus	Description
AddressPoint	string
HouseNumberRange	string
Street	string

OperatingHours

PoI nyitvatartási ideje (érdekes pontok).

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

OperatingHoursRange

A POI (érdeklődési pontok) nyitvatartási ideje. 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

Name	Típus	Description
nextSevenDays	string	A következő hét működési idejét jeleníti meg a POI helyi idejének aktuális napjával kezdődően.

OperatingHoursTime

Dátumot és időpontot 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ében; lehetséges értékek: 0-23.
minute	integer	A percek a poI helyi idejében vannak; lehetséges értékek: 0-59.

OperatingHoursTimeRange

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 kezdete, ha az a tartomány előtt lett lezárva.
startTime	OperatingHoursTime	A következő 7 napos tartomány azon pontja, amikor egy adott POI meg van nyitva, vagy a tartomány kezdete, ha a tartomány előtt nyitották meg.

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.

Name	Típus	Description
brands	Brand[]	Brands 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	PoI nyitvatartási ideje (érdekes pontok).
phone	string	Telefonszám tulajdonság
url	string	Webhely URL-címe tulajdonság

PointOfInterestCategorySet

POI-kategória

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

QueryType

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

Name	Típus	Description
NEARBY	string	Keresés egy meghatározott sugarú szélesség és hosszúság körül hajtották végre
NON_NEAR	string	Keresés globálisan, egy bizonyos szélességre és hosszúságra való torzítás nélkül, meghatározott sugár nélkül hajtották végre

ResponseFormat

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

Name	Típus	Description
json	string	A JavaScript-objektum jelölési adatcseréjének formátuma
xml	string	A bővíthető korrektúra nyelve

SearchAddressResult

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

Name	Típus	Description
results	SearchAddressResultItem[]	Keresés API-eredmények listája.
summary	SearchSummary	Keresés API-válasz összefoglaló objektuma

SearchAddressResultItem

Eredményobjektum egy Keresés API-válaszhoz.

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.
dataSources	DataSources	Nem kötelező szakasz. Referenciageometria-azonosító a Get Keresés Polygon API-val való használathoz.
detourTime	integer	Kitérő idő másodpercben. Csak a Keresés Route API-nak indított hívások esetén adva vissza.
dist	number	Egyenes vonal távolsága az eredmény és a földrajzi hely között méterben.
entityType	GeographicEntityType	Földrajzi entitás típusa. Csak akkor jelenik meg, ha az entityType kérése megtörtént, é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áratok, mint például a bejárati ajtó, vagy egy előszoba, és a "minor", az oldalsó és hátsó ajtók.
id	string	Id tulajdonság
info	string	Információk az eredmény eredeti adatforrásáról. Támogatási kérelmekhez használatos.
matchType	MatchType	Az egyezés típusával kapcsolatos információk. 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 jelölt hely, "lat" rövid névvel, & "lon".
score	number	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 az 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öldrajzi hely Pont címe Címtartomány Kereszt utca
viewport	BoundingBox	A nézetport bal felső és jobb alsó koordinátái által ábrázolt eredményt lefedő nézetport.

SearchAddressResultType

Az alábbiak egyike:

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

Name	Típus	Description
Address Range	string
Cross Street	string
Geography	string
POI	string
Point Address	string
Street	string

SearchIndexes

Indexek, amelyekhez kiterjesztett irányítószámokat kell felvenni az eredményekbe.

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

Addr = Címtartományok

Geo = Földrajzi helyek

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), indexek nélkül pedig Nincs .

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 meglehetősen hosszúak lehetnek, ezért szükség esetén explicit módon kell kérni őket.

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ő.

Name	Típus	Description
Addr	string
Geo	string
PAD	string
POI	string
Str	string
Xstr	string

SearchInsideGeometryRequest

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

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

SearchSummary

Egy Keresés API-válasz összefoglaló 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 térinformatikai torzításokat alkalmazott az eredmények rangsorolásának javítására. Egyes metódusok ezt a lat és a lon paraméterek beállításával befolyásolhatják, ahol elérhető. Más esetekben ez tisztán belső.
limit	integer	A visszaadott válaszok maximális száma
numResults	integer	A válasz eredményeinek 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