Search - Post Search Inside Geometry
Använd för att utföra kostnadsfria formulärsökningar i ytterligare en geometri.
Post Search Inside Geometry
API:et är och 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.<br><br>To send the geometry you will use a
POSTrequest where the request body will contain the
geometriobject represented as a
GeoJSONtype and the
Content-Typeheader will be set to
application/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** <br>The
geometrican be represented as a
GeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. The
FeatureCollectioncan contain a max of 50
GeoJSON Featureobjects. Each
Featureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>A
Featureobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>A
Funktionobject for the Circle geometry is composed of a _center_ represented using a
GeoJSON 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><br> Please see the Examples section below for a sample
FeatureCollectionrepresentation.<br><br></li><li>**GeoJSON GeometryCollection**<br>The
geometrican be represented as a
GeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. The
GeometryCollectioncan contain a max of 50
GeoJSON Polygonobjects. Each
Polygonobject can have a max of 50 coordinates. Please see the Examples section below for a sample
GeometryCollectionrepresentation.<br><br></li><li>**GeoJSON Polygon**<br>The
geometrican be represented as a
GeoJSON Polygonobject. This is the recommended option if the geometry contains a single Polygon. The
Polygonobject can have a max of 50 coordinates. Please see the Examples section below for a sample
Polygon representation.
.
POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}
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-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
format
|
path | True |
Önskat format för svaret. Värdet kan vara antingen json eller XML-. |
|
api-version
|
query | True |
string |
Versionsnummer för Azure Maps API. |
query
|
query | True |
string |
POI-namnet att söka efter (t.ex. "frihetsgudinnan", "starbucks", "pizza"). Måste vara korrekt URL-kodad. |
category
|
query |
integer[] |
En kommaavgränsad lista över kategoriuppsättnings-ID:er som kan användas för att begränsa resultatet till specifika kategorier av intressepunkter. ID-beställning spelar ingen roll. Maximalt antal
|
|
extended
|
query |
Index för vilka utökade postnummer ska ingå i resultaten. Tillgängliga index är: Addr = Adressintervall Geo = Geographies PAD = punktadresser POI = Intressanta platser Str = Gator XStr = Korsgator (korsningar) Värdet ska vara en kommaavgränsad lista över indextyper (i valfri ordning) eller Ingen för inga index. Som standard ingår utökade postnummer för alla index utom Geo. Utökade postnummerlistor för geografiska områden kan vara ganska långa, så de måste uttryckligen begäras när det behövs. Användningsexempel: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Utökat postnummer returneras som en extendedPostalCode- egenskap för en adress. Tillgängligheten är regionberoende. |
||
idx
|
query |
En kommaavgränsad lista över index som ska användas för sökningen. Objektordning spelar ingen roll. Tillgängliga index är: Addr = Adressintervallinterpolation, Geo = Geografiska områden, PAD = Punktadresser, POI = Intressanta platser, Str = Gator, Xstr = Korsgator (korsningar) |
||
language
|
query |
string |
Språk där sökresultat ska returneras. Bör vara en av IETF-språktaggar som stöds, skiftlägesokänsliga. När data på angivet språk inte är tillgängliga för ett visst fält används standardspråket. Mer information finns i språk som stöds. |
|
limit
|
query |
integer minimum: 1maximum: 100 |
Maximalt antal svar som ska returneras. Standard: 10, minimum: 1 och max: 100 |
|
opening
|
query |
Drifttimmar för en POI (intressepunkter). Tillgängligheten för drifttimmar varierar beroende på vilka data som är tillgängliga. Om den inte skickas returneras ingen information om öppettiderna. Värde som stöds: nextSevenDays |
||
view
|
query |
Med parametern Visa (kallas även parametern "användarregion" kan du visa rätt kartor för ett visst land/en viss region för geopolitiskt omtvistade regioner. Olika länder/regioner har olika vyer över sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som programmet kommer att betjäna. Som standard är view-parametern inställd på "Unified" även om du inte har definierat den i begäran. Det är ditt ansvar att fastställa platsen för dina användare och ange sedan view-parametern korrekt för den platsen. Du kan också ange "View=Auto", som returnerar kartdata baserat på IP-adressen för begäran. Parametern Visa i Azure Maps måste användas i enlighet med tillämpliga lagar, inklusive de som gäller mappning, för det land/den region där kartor, bilder och andra data och innehåll från tredje part som du har behörighet att komma åt via Azure Maps görs tillgängligt. Exempel: view=IN. Mer information finns i vyer som stöds och för att se tillgängliga vyer. |
Begärandehuvud
Name | Obligatorisk | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Anger vilket konto som är avsett för användning tillsammans med Microsoft Entra ID-säkerhetsmodellen. Det representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Konto-API:et för Azure Maps-hanteringsplan. Information om hur du använder Microsoft Entra ID-säkerhet i Azure Maps finns i följande artiklar för vägledning. |
Begärandetext
Name | Typ | Description |
---|---|---|
geometry | GeoJsonObject: |
Ett giltigt |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Ett oväntat fel uppstod. |
Säkerhet
AADToken
Det här är Microsoft Entra OAuth 2.0 Flows. När du parkopplas med rollbaserad åtkomst i Azure kontroll kan den användas för att styra åtkomsten till Azure Maps REST-API:er. Rollbaserade åtkomstkontroller i Azure används för att ange åtkomst till ett eller flera Azure Maps-resurskonton eller underresurser. Alla användare, grupper eller tjänstens huvudnamn kan beviljas åtkomst via en inbyggd roll eller en anpassad roll som består av en eller flera behörigheter till Azure Maps REST-API:er.
För att implementera scenarier rekommenderar vi att du visar autentiseringsbegrepp. Sammanfattningsvis tillhandahåller den här säkerhetsdefinitionen en lösning för modellering av program via objekt som kan få åtkomstkontroll för specifika API:er och omfång.
Anmärkning
- Den här säkerhetsdefinitionen kräver användningen av
x-ms-client-id
-huvudet för att ange vilken Azure Maps-resurs programmet begär åtkomst till. Detta kan hämtas från Maps-hantering-API:et. -
Authorization URL
är specifik för den offentliga Azure-molninstansen. Nationella moln har unika auktoriserings-URL:er och Microsoft Entra-ID-konfigurationer. - Den rollbaserade åtkomstkontrollen i Azure konfigureras från Azure-hanteringsplan via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
- Användning av Azure Maps Web SDK möjliggör konfigurationsbaserad konfiguration av ett program för flera användningsfall.
- Mer information om Microsofts identitetsplattform finns i Översikt över Microsofts identitetsplattform.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Det här är en delad nyckel som etableras när du Skapa ett Azure Maps-konto i Azure-portalen eller med hjälp av PowerShell, CLI, Azure SDK:er eller REST API.
Med den här nyckeln kan alla program komma åt alla REST API:er. Med andra ord kan den här nyckeln användas som en huvudnyckel i det konto som de har utfärdats i.
För offentligt exponerade program rekommenderar vi att du använder konfidentiella klientprogram metod för åtkomst till Azure Maps REST-API:er så att din nyckel kan lagras på ett säkert sätt.
Typ:
apiKey
I:
query
SAS Token
Det här är en signaturtoken för delad åtkomst som skapas från sas-åtgärden Lista på Azure Maps-resursen via Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
Med den här token har alla program behörighet att komma åt med rollbaserade Åtkomstkontroller i Azure och detaljerad kontroll till förfallodatum, frekvens och region för användning för den specifika token. Med andra ord kan SAS-token användas för att tillåta program att styra åtkomsten på ett mer säkert sätt än den delade nyckeln.
För offentligt exponerade program rekommenderar vi att du konfigurerar en specifik lista över tillåtna ursprung på Map-kontoresursen för att begränsa återgivningsmissbruket och regelbundet förnya SAS-token.
Typ:
apiKey
I:
header
Exempel
Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type
Exempelbegäran
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
]
]
]
}
]
}
}
Exempelsvar
{
"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
Exempelbegäran
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
}
}
]
}
}
Exempelsvar
{
"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
Exempelbegäran
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
]
]
]
}
}
Exempelsvar
{
"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
}
}
]
}
]
}
Definitioner
Name | Description |
---|---|
Address |
Resultatets adress |
Address |
Beskriver adressintervallet på båda sidor av gatan för ett sökresultat. Koordinater för start- och slutplatserna för adressintervallet ingår. |
Bounding |
Det visningsområde som täcker resultatet som representeras av koordinaterna överst till vänster och längst ned till höger i visningsområdet. |
Bounding |
Avgränsningsrutan för platsen. |
Brand |
Det varumärke som är associerat med POI |
Classification |
Klassificeringen för den POI som returneras |
Classification |
Namn på klassificeringen |
Data |
Valfritt avsnitt. Referens-ID:n för användning med API:et Get Search Polygon. |
Entity |
Entitetstypkälla för avgränsningsrutan. För omvänd geokodning är detta alltid lika med position. |
Entry |
Startpunkten för den POI som returneras. |
Entry |
Typ av startpunkt. Värdet kan vara antingen eller mindre. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Geographic |
Geografientitetstyp. Presentera endast när entityType begärdes och är tillgängligt. |
Geo |
En giltig |
Geo |
En giltig |
Geo |
Ett giltigt |
Geo |
En giltig |
Geo |
En giltig |
Geo |
En giltig |
Geo |
En giltig |
Geo |
En giltig |
Geo |
En giltig |
Geo |
En giltig |
Geometry |
Information om resultatets geometriska form. Presentera endast om du skriver == Geografi. |
Lat |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
Localized |
Med parametern Visa (kallas även parametern "användarregion" kan du visa rätt kartor för ett visst land/en viss region för geopolitiskt omtvistade regioner. Olika länder/regioner har olika vyer över sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som programmet kommer att betjäna. Som standard är view-parametern inställd på "Unified" även om du inte har definierat den i begäran. Det är ditt ansvar att fastställa platsen för dina användare och ange sedan view-parametern korrekt för den platsen. Du kan också ange "View=Auto", som returnerar kartdata baserat på IP-adressen för begäran. Parametern Visa i Azure Maps måste användas i enlighet med tillämpliga lagar, inklusive de som gäller mappning, för det land/den region där kartor, bilder och andra data och innehåll från tredje part som du har behörighet att komma åt via Azure Maps görs tillgängligt. Exempel: view=IN. Mer information finns i vyer som stöds och för att se tillgängliga vyer. |
Match |
Matchningstyper för en sökåtgärd för omvänd adress. |
Operating |
Öppettider för en POI (intressepunkter). |
Operating |
Drifttimmar för en POI (intressepunkter). Tillgängligheten för drifttimmar varierar beroende på vilka data som är tillgängliga. Om den inte skickas returneras ingen information om öppettiderna. Värde som stöds: nextSevenDays |
Operating |
Representerar ett datum och en tid |
Operating |
Öppet tidsintervall för en dag |
Point |
Information om den returnerade IP-adressen, inklusive information som namn, telefon, URL-adress och klassificeringar. |
Point |
POI-kategori |
Query |
Den typ av fråga som returneras: NEARBY eller NON_NEAR. |
Response |
Önskat format för svaret. Värdet kan vara antingen json eller XML-. |
Search |
Det här objektet returneras från ett lyckat sökanrop. |
Search |
Resultatobjekt för ett api-svar för sökning. |
Search |
En av:
|
Search |
Index för vilka utökade postnummer ska ingå i resultaten. Tillgängliga index är: Addr = Adressintervall Geo = Geographies PAD = punktadresser POI = Intressanta platser Str = Gator XStr = Korsgator (korsningar) Värdet ska vara en kommaavgränsad lista över indextyper (i valfri ordning) eller Ingen för inga index. Som standard ingår utökade postnummer för alla index utom Geo. Utökade postnummerlistor för geografiska områden kan vara ganska långa, så de måste uttryckligen begäras när det behövs. Användningsexempel: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Utökat postnummer returneras som en extendedPostalCode- egenskap för en adress. Tillgängligheten är regionberoende. |
Search |
Den här typen representerar begärandetexten för tjänsten Sök inuti geometri. |
Search |
Sammanfattningsobjekt för ett api-svar för sökning. |
Address
Resultatets adress
Name | Typ | Description |
---|---|---|
boundingBox |
Avgränsningsrutan för platsen. |
|
buildingNumber |
string |
Byggnadens nummer på gatan. INAKTUELL, använd streetNumber i stället. |
country |
string |
namn på land/region |
countryCode |
string |
Land (Obs! Det här är en kod med två bokstäver, inte ett namn på land/region.) |
countryCodeISO3 |
string |
ISO alfa-3 landskod |
countrySecondarySubdivision |
string |
Län |
countrySubdivision |
string |
Delstat eller provins |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
Det fullständiga namnet på en första nivå i den administrativa hierarkin för land/region. Det här fältet visas endast om countrySubdivision visas i ett förkortat formulär. Stöds endast för USA, Kanada och Storbritannien. |
countryTertiarySubdivision |
string |
Namngivet område |
crossStreet |
string |
Namnet på gatan som korsas. |
extendedPostalCode |
string |
Utökat postnummer (tillgängligheten är beroende av regionen). |
freeformAddress |
string |
En adressrad formaterad enligt formateringsreglerna för ett resultats ursprungsland/region, eller om det gäller ett land/en region, dess fullständiga namn på land/region. |
localName |
string |
En adresskomponent som representerar namnet på ett geografiskt område eller en lokal plats som grupperar flera adresserbara objekt i adresseringssyfte, utan att vara en administrativ enhet. Det här fältet används för att skapa egenskapen |
municipality |
string |
Stad/Stad |
municipalitySubdivision |
string |
Sub/Super City |
neighbourhood |
string |
Ett grannskap är ett geografiskt lokaliserat område inom en stad eller stad med distinkta egenskaper och sociala interaktioner mellan invånare. |
postalCode |
string |
Postnummer/postnummer |
routeNumbers |
string[] |
De koder som används för att entydigt identifiera gatan |
street |
string |
Gatunamnet. INAKTUELL, använd streetName i stället. |
streetName |
string |
Gatunamnet. |
streetNameAndNumber |
string |
Gatunamnet och numret. |
streetNumber |
string |
Byggnadens nummer på gatan. |
AddressRanges
Beskriver adressintervallet på båda sidor av gatan för ett sökresultat. Koordinater för start- och slutplatserna för adressintervallet ingår.
Name | Typ | Description |
---|---|---|
from |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
|
rangeLeft |
string |
Adressintervall till vänster på gatan. |
rangeRight |
string |
Adressintervall på höger sida av gatan. |
to |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
BoundingBox
Det visningsområde som täcker resultatet som representeras av koordinaterna överst till vänster och längst ned till höger i visningsområdet.
Name | Typ | Description |
---|---|---|
btmRightPoint |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
|
topLeftPoint |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
BoundingBoxCompassNotation
Avgränsningsrutan för platsen.
Name | Typ | Description |
---|---|---|
entity |
Entitetstypkälla för avgränsningsrutan. För omvänd geokodning är detta alltid lika med position. |
|
northEast |
string |
Nordostlig latitud, longitudkoordinat för avgränsningslådan som kommaavgränsade flyttal |
southWest |
string |
Sydvästlig latitud, longitudkoordinat för avgränsningslådan som kommaavgränsade flyttal |
Brand
Det varumärke som är associerat med POI
Name | Typ | Description |
---|---|---|
name |
string |
Namnet på varumärket |
Classification
Klassificeringen för den POI som returneras
Name | Typ | Description |
---|---|---|
code |
string |
Kodegenskap |
names |
Namnmatris |
ClassificationName
Namn på klassificeringen
Name | Typ | Description |
---|---|---|
name |
string |
Namnegenskap |
nameLocale |
string |
Namn på språkegenskap |
DataSources
Valfritt avsnitt. Referens-ID:n för användning med API:et Get Search Polygon.
Name | Typ | Description |
---|---|---|
geometry |
Information om resultatets geometriska form. Presentera endast om du skriver == Geografi. |
Entity
Entitetstypkälla för avgränsningsrutan. För omvänd geokodning är detta alltid lika med position.
Värde | Description |
---|---|
position |
Position entitet |
EntryPoint
Startpunkten för den POI som returneras.
Name | Typ | Description |
---|---|---|
position |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
|
type |
Typ av startpunkt. Värdet kan vara antingen eller mindre. |
EntryPointType
Typ av startpunkt. Värdet kan vara antingen eller mindre.
Värde | Description |
---|---|
main | |
minor |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
GeographicEntityType
Geografientitetstyp. Presentera endast när entityType begärdes och är tillgängligt.
Värde | Description |
---|---|
Country |
namn på land/region |
CountrySecondarySubdivision |
Län |
CountrySubdivision |
Delstat eller provins |
CountryTertiarySubdivision |
Namngivet område |
Municipality |
Stad/Stad |
MunicipalitySubdivision |
Sub/Super City |
Neighbourhood |
Grannskap |
PostalCodeArea |
Postnummer/postnummer |
GeoJsonFeature
En giltig GeoJSON Feature
objekttyp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
featureType |
string |
Typ av funktion. Värdet beror på datamodellen som den aktuella funktionen ingår i. Vissa datamodeller kan ha ett tomt värde. |
geometry | GeoJsonGeometry: |
Ett giltigt |
id |
string |
Identifierare för funktionen. |
type |
string:
Feature |
Anger |
GeoJsonFeatureCollection
En giltig GeoJSON FeatureCollection
objekttyp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
features |
Innehåller en lista över giltiga |
|
type |
string:
Feature |
Anger |
GeoJsonGeometry
Ett giltigt GeoJSON
geometriobjekt. Typen måste vara en av de sju giltiga GeoJSON-geometrityperna – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon och GeometryCollection. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
type |
Geo |
Anger |
GeoJsonGeometryCollection
En giltig GeoJSON GeometryCollection
objekttyp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Innehåller en lista över giltiga |
type |
string:
Geometry |
Anger |
GeoJsonLineString
En giltig GeoJSON LineString
geometrityp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
Koordinater för |
type |
string:
Line |
Anger |
GeoJsonMultiLineString
En giltig GeoJSON MultiLineString
geometrityp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
Koordinater för |
type |
string:
Multi |
Anger |
GeoJsonMultiPoint
En giltig GeoJSON MultiPoint
geometrityp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
Koordinater för |
type |
string:
Multi |
Anger |
GeoJsonMultiPolygon
En giltig GeoJSON MultiPolygon
objekttyp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
Innehåller en lista över giltiga |
type |
string:
Multi |
Anger |
GeoJsonPoint
En giltig GeoJSON Point
geometrityp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
En |
type |
string:
Point |
Anger |
GeoJsonPolygon
En giltig GeoJSON Polygon
geometrityp. Mer information finns i RFC 7946.
Name | Typ | Description |
---|---|---|
coordinates |
number[] (double) |
Koordinater för |
type |
string:
Polygon |
Anger |
Geometry
Information om resultatets geometriska form. Presentera endast om du skriver == Geografi.
Name | Typ | Description |
---|---|---|
id |
string |
Skicka detta som geometriId till api:et Get Search Polygon för att hämta geometriinformation för det här resultatet. |
LatLongPairAbbreviated
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon".
Name | Typ | Description |
---|---|---|
lat |
number (double) |
Latitude-egenskap |
lon |
number (double) |
Longitudegenskap |
LocalizedMapView
Med parametern Visa (kallas även parametern "användarregion" kan du visa rätt kartor för ett visst land/en viss region för geopolitiskt omtvistade regioner. Olika länder/regioner har olika vyer över sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som programmet kommer att betjäna. Som standard är view-parametern inställd på "Unified" även om du inte har definierat den i begäran. Det är ditt ansvar att fastställa platsen för dina användare och ange sedan view-parametern korrekt för den platsen. Du kan också ange "View=Auto", som returnerar kartdata baserat på IP-adressen för begäran. Parametern Visa i Azure Maps måste användas i enlighet med tillämpliga lagar, inklusive de som gäller mappning, för det land/den region där kartor, bilder och andra data och innehåll från tredje part som du har behörighet att komma åt via Azure Maps görs tillgängligt. Exempel: view=IN.
Mer information finns i vyer som stöds och för att se tillgängliga vyer.
Värde | Description |
---|---|
AE |
Förenade Arabemiraten (arabisk vy) |
AR |
Argentina (argentinsk vy) |
Auto |
Returnera kartdata baserat på IP-adressen för begäran. |
BH |
Bahrain (arabisk vy) |
IN |
Indien (indisk vy) |
IQ |
Irak (arabisk vy) |
JO |
Jordanien (arabisk vy) |
KW |
Kuwait (arabisk vy) |
LB |
Libanon (arabisk vy) |
MA |
Marocko (marockansk vy) |
OM |
Oman (arabisk vy) |
PK |
Pakistan (pakistansk vy) |
PS |
Palestinska myndigheten (arabisk vy) |
QA |
Qatar (arabisk vy) |
SA |
Saudiarabien (arabisk vy) |
SY |
Syrien (arabisk vy) |
Unified |
Enhetlig vy (andra) |
YE |
Jemen (arabisk vy) |
MatchType
Matchningstyper för en sökåtgärd för omvänd adress.
Värde | Description |
---|---|
AddressPoint | |
HouseNumberRange | |
Street |
OperatingHours
Öppettider för en POI (intressepunkter).
Name | Typ | Description |
---|---|---|
mode |
string |
Värde som används i begäran: ingen eller "nextSevenDays" |
timeRanges |
Lista över tidsintervall för de kommande 7 dagarna |
OperatingHoursRange
Drifttimmar för en POI (intressepunkter). Tillgängligheten för drifttimmar varierar beroende på vilka data som är tillgängliga. Om den inte skickas returneras ingen information om öppettiderna. Värde som stöds: nextSevenDays
Värde | Description |
---|---|
nextSevenDays |
Visar drifttimmarna för nästa vecka, med början den aktuella dagen i den lokala tiden för POI. |
OperatingHoursTime
Representerar ett datum och en tid
Name | Typ | Description |
---|---|---|
date |
string |
Representerar aktuellt kalenderdatum i tidszonen POI, t.ex. "2019-02-07". |
hour |
integer |
Timmarna är i 24-timmarsformatet i den lokala tiden för en POI; möjliga värden är 0–23. |
minute |
integer |
Minuter är i den lokala tiden för en POI; möjliga värden är 0–59. |
OperatingHoursTimeRange
Öppet tidsintervall för en dag
Name | Typ | Description |
---|---|---|
endTime |
Punkten inom de kommande 7 dagarnas intervall när en viss POI stängs, eller början av intervallet om den stängdes före intervallet. |
|
startTime |
Punkten under de kommande 7 dagarnas intervall när en viss POI öppnas, eller början av intervallet om den öppnades före intervallet. |
PointOfInterest
Information om den returnerade IP-adressen, inklusive information som namn, telefon, URL-adress och klassificeringar.
Name | Typ | Description |
---|---|---|
brands |
Brand[] |
Matris för varumärken. Namnet på varumärket för DEN POI som returneras. |
categories |
string[] |
Matris för kategorier |
categorySet |
Listan över de mest specifika POI-kategorierna |
|
classifications |
Klassificeringsmatris |
|
name |
string |
Namn på poi-egenskapen |
openingHours |
Öppettider för en POI (intressepunkter). |
|
phone |
string |
Telefonnummeregenskap |
url |
string |
Webbplats-URL-egenskap |
PointOfInterestCategorySet
POI-kategori
Name | Typ | Description |
---|---|---|
id |
integer |
Kategori-ID |
QueryType
Den typ av fråga som returneras: NEARBY eller NON_NEAR.
Värde | Description |
---|---|
NEARBY |
Sökningen utfördes runt en viss latitud och longitud med en definierad radie |
NON_NEAR |
Sökningen utfördes globalt, utan bias till en viss latitud och longitud, och ingen definierad radie |
ResponseFormat
Önskat format för svaret. Värdet kan vara antingen json eller XML-.
Värde | Description |
---|---|
json | |
xml |
SearchAddressResult
Det här objektet returneras från ett lyckat sökanrop.
Name | Typ | Description |
---|---|---|
results |
En lista över SÖKRESULTAT. |
|
summary |
Sammanfattningsobjekt för ett api-svar för sökning |
SearchAddressResultItem
Resultatobjekt för ett api-svar för sökning.
Name | Typ | Description |
---|---|---|
address |
Resultatets adress |
|
addressRanges |
Beskriver adressintervallet på båda sidor av gatan för ett sökresultat. Koordinater för start- och slutplatserna för adressintervallet ingår. |
|
dataSources |
Valfritt avsnitt. Referensgeometri-ID för användning med api:et Get Search Polygon. |
|
detourTime |
integer |
Omvägstid i sekunder. Returnerades endast för anrop till API:et Search Along Route. |
dist |
number (double) |
Rät linjeavstånd mellan resultatet och geobiasplatsen i meter. |
entityType |
Geografientitetstyp. Presentera endast när entityType begärdes och är tillgängligt. |
|
entryPoints |
Matris med EntryPoints. De beskriver de typer av ingångar som är tillgängliga på platsen. Typen kan vara "main" för huvudentréer som en ytterdörr, eller en lobby, och "mindre", för sido- och bakdörrar. |
|
id |
string |
ID-egenskap |
info |
string |
Information om den ursprungliga datakällan för resultatet. Används för supportbegäranden. |
matchType |
Information om typen av matchning. En av:
|
|
poi |
Information om den returnerade IP-adressen, inklusive information som namn, telefon, URL-adress och klassificeringar. |
|
position |
En plats som representeras som en latitud och longitud med kortnamnen "lat" & "lon". |
|
score |
number (double) |
Värdet i en resultatuppsättning som anger den relativa matchningspoängen mellan resultaten. Du kan använda detta för att fastställa att resultat x är dubbelt så sannolikt att vara lika relevant som resultat y om värdet för x är 2x värdet för y. Värdena varierar mellan frågor och är endast avsedda som ett relativt värde för en resultatuppsättning. |
type |
En av:
|
|
viewport |
Det visningsområde som täcker resultatet som representeras av koordinaterna överst till vänster och längst ned till höger i visningsområdet. |
SearchAddressResultType
En av:
- Intressepunkt
- Gata
- Geografi
- Punktadress
- Adressintervall
- Tvärs över gatan
Värde | Description |
---|---|
Address Range | |
Cross Street | |
Geography | |
POI | |
Point Address | |
Street |
SearchIndexes
Index för vilka utökade postnummer ska ingå i resultaten.
Tillgängliga index är:
Addr = Adressintervall
Geo = Geographies
PAD = punktadresser
POI = Intressanta platser
Str = Gator
XStr = Korsgator (korsningar)
Värdet ska vara en kommaavgränsad lista över indextyper (i valfri ordning) eller Ingen för inga index.
Som standard ingår utökade postnummer för alla index utom Geo. Utökade postnummerlistor för geografiska områden kan vara ganska långa, så de måste uttryckligen begäras när det behövs.
Användningsexempel:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
Utökat postnummer returneras som en extendedPostalCode- egenskap för en adress. Tillgängligheten är regionberoende.
Värde | Description |
---|---|
Addr | |
Geo | |
PAD | |
POI | |
Str | |
Xstr |
SearchInsideGeometryRequest
Den här typen representerar begärandetexten för tjänsten Sök inuti geometri.
Name | Typ | Description |
---|---|---|
geometry | GeoJsonObject: |
Ett giltigt |
SearchSummary
Sammanfattningsobjekt för ett api-svar för sökning.
Name | Typ | Description |
---|---|---|
fuzzyLevel |
integer |
Den maximala fuzzy-nivå som krävs för att ge resultat. |
geoBias |
Indikation när den interna sökmotorn har tillämpat en geospatial bias för att förbättra resultatordningen. I vissa metoder kan detta påverkas genom att ange parametrarna lat och lon där det är tillgängligt. I andra fall är det rent internt. |
|
limit |
integer |
Maximalt antal svar som ska returneras |
numResults |
integer |
Antal resultat i svaret. |
offset |
integer |
Startförskjutningen för de returnerade resultaten i den fullständiga resultatuppsättningen. |
query |
string |
Frågeparametern som användes för att skapa dessa sökresultat. |
queryTime |
integer |
Tid som ägnas åt att lösa frågan, i millisekunder. |
queryType |
Den typ av fråga som returneras: NEARBY eller NON_NEAR. |
|
totalResults |
integer |
Det totala antalet resultat som hittades. |