Search - Post Search Inside Geometry
Använd för att utföra fria formulärsökningar i ytterligare en geometri.
API:et Post Search Inside Geometry
ä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
POST-geometrinrequest where the request body will contain the
object 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
Geometrycan 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
object 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
Featureobject 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 Polygon Polygonobject can have a max of 50 coordinates. Please see the Examples section below for a sample
objects. Each
GeometryCollectionrepresentation.<br><br></li><li>**GeoJSON Polygon**<br>The
geometrican be represented as a
GeoJSON Polygon Polygonobject. This is the recommended option if the geometry contains a single Polygon. The
object can have a max of 50 coordinates. Please see the Examples section below for a sample
Polygonens 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:t 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 = geografiska områden PAD = punktadresser POI = Orienteringspunkter Str = Gator XStr = Korsgator (korsningar) Värdet ska vara en kommaavgränsad lista över indextyper (i valfri ordning) eller Ingen utan 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 = Orienteringspunkter, 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å det angivna språket 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 |
Maximalt antal svar som ska returneras. Standard: 10, minimum: 1 och max: 100 |
|
opening
|
query |
Drifttimmar för en POI (orienteringspunkter). Tillgängligheten för drifttimmar varierar beroende på vilka data som är tillgängliga. Om det 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 för sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som ditt program 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 användarnas plats och sedan ange parametern Visa korrekt för den platsen. Alternativt kan du välja att 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äkerhetsmodell. Den representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Azure Maps hanteringsplans konto-API. Information om hur du använder Microsoft Entra ID säkerhet i Azure Maps finns i följande artiklar. |
Begärandetext
Name | Typ | Description |
---|---|---|
geometry | GeoJsonObject: |
Ett giltigt |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Det uppstod ett oväntat fel. |
Säkerhet
AADToken
Det här är Microsoft Entra OAuth 2.0-flöden. När den är kopplad till rollbaserad åtkomstkontroll i Azure 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 en eller flera Azure Maps resurskonto 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 för att 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.
Anteckning
- Den här säkerhetsdefinitionen
x-ms-client-id
kräver att huvudet används för att ange vilken Azure Maps resurs som programmet begär åtkomst till. Detta kan hämtas från Maps Management-API :et. -
Authorization URL
är specifikt 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-hanteringsplanet via Azure Portal, 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 Microsofts identitetsplattform översikt.
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 skapar ett Azure Maps-konto i Azure Portal eller använder PowerShell, CLI, Azure SDK:er eller REST API.
Med den här nyckeln kan alla program komma åt alla REST-API:et. Med andra ord kan den här nyckeln användas som en huvudnyckel i det konto som de utfärdas i.
För offentligt exponerade program rekommenderar vi att du använder metoden för konfidentiella klientprogram för att komma åt 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 åtgärden Lista SAS på den Azure Maps resursen via Azure-hanteringsplanet via Azure Portal, 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 av 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 återgivningsmissbruk 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 visningsplatsen. |
Bounding |
Platsens avgränsningsruta. |
Brand |
Det varumärke som är associerat med POI |
Classification |
Klassificeringen för den intressepunkt 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 huvudvärde eller mindre. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Geographic |
Geografi entitetstyp. 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. Endast tillgänglig 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 för sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som ditt program 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 parametern Visa korrekt för den platsen. Alternativt kan du välja att 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 med omvänd adress. |
Operating |
Öppettider för en POI (intressepunkter). |
Operating |
Drifttimmar för en INTRESSEPUNKT (intressepunkter). Tillgängligheten för drifttimmar varierar beroende på tillgängliga data. Om det inte godkänns 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 |
Typen 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 Search-anrop. |
Search |
Resultatobjekt för ett Search API-svar. |
Search |
Något av:
|
Search |
Index för vilka utökade postnummer ska ingå i resultaten. Tillgängliga index är: Addr = Adressintervall Geo = Geografiska områden 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 utan 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 Search Inside Geometry. |
Search |
Sammanfattningsobjekt för ett Search API-svar. |
Address
Resultatets adress
Name | Typ | Description |
---|---|---|
boundingBox |
Platsens avgränsningsruta. |
|
buildingNumber |
string |
Byggnadens nummer på gatan. INAKTUELL, använd streetNumber i stället. |
country |
string |
land/regionnamn |
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 för 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 |
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 särpräglade 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 visningsplatsen.
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
Platsens avgränsningsruta.
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 intressepunkt 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. Endast tillgänglig om du skriver == Geografi. |
Entity
Entitetstypkälla för avgränsningsrutan. För omvänd geokodning är detta alltid lika med position.
Name | Typ | Description |
---|---|---|
position |
string |
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 huvudvärde eller mindre. |
EntryPointType
Typ av startpunkt. Värdet kan vara antingen huvudvärde eller mindre.
Name | Typ | Description |
---|---|---|
main |
string |
|
minor |
string |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Den ytterligare informationstypen. |
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
Geografi entitetstyp. Presentera endast när entityType begärdes och är tillgängligt.
Name | Typ | Description |
---|---|---|
Country |
string |
land/regionnamn |
CountrySecondarySubdivision |
string |
Län |
CountrySubdivision |
string |
Delstat eller provins |
CountryTertiarySubdivision |
string |
Namngivet område |
Municipality |
string |
Stad/Stad |
MunicipalitySubdivision |
string |
Sub/Super City |
Neighbourhood |
string |
Grannskapet |
PostalCodeArea |
string |
Postnummer/postnummer |
GeoJsonFeature
En giltig GeoJSON Feature
objekttyp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
featureType |
string |
Funktionens typ. Värdet beror på vilken datamodell den aktuella funktionen är en del av. 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[] |
Koordinater för geometrin |
type |
string:
Line |
Anger |
GeoJsonMultiLineString
En giltig GeoJSON MultiLineString
geometrityp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Koordinater för geometrin |
type |
string:
Multi |
Anger |
GeoJsonMultiPoint
En giltig GeoJSON MultiPoint
geometrityp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Koordinater för geometrin |
type |
string:
Multi |
Anger |
GeoJsonMultiPolygon
En giltig GeoJSON MultiPolygon
objekttyp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
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[] |
A |
type |
string:
Point |
Anger |
GeoJsonPolygon
En giltig GeoJSON Polygon
geometrityp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Koordinater för |
type |
string:
Polygon |
Anger |
Geometry
Information om resultatets geometriska form. Endast tillgänglig om du skriver == Geografi.
Name | Typ | Description |
---|---|---|
id |
string |
Skicka detta som geometryId 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 |
Latitude-egenskap |
lon |
number |
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 för sådana regioner, och med parametern Visa kan ditt program uppfylla den vy som krävs av det land/den region som ditt program 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 parametern Visa korrekt för den platsen. Alternativt kan du välja att 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.
Name | Typ | Description |
---|---|---|
AE |
string |
Förenade Arabemiraten (arabisk vy) |
AR |
string |
Argentina (argentinsk vy) |
Auto |
string |
Returnera kartdata baserat på IP-adressen för begäran. |
BH |
string |
Bahrain (arabisk vy) |
IN |
string |
Indien (indisk vy) |
IQ |
string |
Irak (arabisk vy) |
JO |
string |
Jordanien (arabisk vy) |
KW |
string |
Kuwait (arabisk vy) |
LB |
string |
Libanon (arabisk vy) |
MA |
string |
Marocko (marockansk vy) |
OM |
string |
Oman (arabisk vy) |
PK |
string |
Pakistan (pakistansk vy) |
PS |
string |
Palestinska myndigheten (arabisk vy) |
QA |
string |
Qatar (arabisk vy) |
SA |
string |
Saudiarabien (arabisk vy) |
SY |
string |
Syrien (arabisk vy) |
Unified |
string |
Enhetlig vy (andra) |
YE |
string |
Jemen (arabisk vy) |
MatchType
Matchningstyper för en sökåtgärd med omvänd adress.
Name | Typ | Description |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
Öppettider för en POI (intressepunkter).
Name | Typ | Description |
---|---|---|
mode |
string |
Värde som används i begäran: none eller "nextSevenDays" |
timeRanges |
Lista över tidsintervall för de kommande 7 dagarna |
OperatingHoursRange
Drifttimmar för en INTRESSEPUNKT (intressepunkter). Tillgängligheten för drifttimmar varierar beroende på tillgängliga data. Om det inte godkänns returneras ingen information om öppettiderna. Värde som stöds: nextSevenDays
Name | Typ | Description |
---|---|---|
nextSevenDays |
string |
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 POI-tidszonen, t.ex. "2019-02-07". |
hour |
integer |
Timmar är i 24-timmarsformat 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 under de kommande 7 dagarna sträcker sig 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 dagarna sträcker sig 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å egenskapen POI |
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
Typen av fråga som returneras: NEARBY eller NON_NEAR.
Name | Typ | Description |
---|---|---|
NEARBY |
string |
Search utfördes runt en viss latitud och longitud med en definierad radie |
NON_NEAR |
string |
Search 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.
Name | Typ | Description |
---|---|---|
json |
string |
|
xml |
string |
SearchAddressResult
Det här objektet returneras från ett lyckat Search-anrop.
Name | Typ | Description |
---|---|---|
results |
En lista över Search API-resultat. |
|
summary |
Sammanfattningsobjekt för ett Search API-svar |
SearchAddressResultItem
Resultatobjekt för ett Search API-svar.
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. Returneras endast för anrop till API:et Search Längs vägen. |
dist |
number |
Rät linjeavstånd mellan resultatet och geobias plats i meter. |
entityType |
Geografi entitetstyp. 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. Något 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 |
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 |
Något 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 visningsplatsen. |
SearchAddressResultType
Något av:
- POI
- Gata
- Geografi
- Punktadress
- Adressintervall
- Tvärs över gatan
Name | Typ | Description |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
Index för vilka utökade postnummer ska ingå i resultaten.
Tillgängliga index är:
Addr = Adressintervall
Geo = Geografiska områden
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 utan 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.
Name | Typ | Description |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
SearchInsideGeometryRequest
Den här typen representerar begärandetexten för tjänsten Search Inside Geometry.
Name | Typ | Description |
---|---|---|
geometry | GeoJsonObject: |
Ett giltigt |
SearchSummary
Sammanfattningsobjekt för ett Search API-svar.
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 resultatrankningen. I vissa metoder kan detta påverkas genom att ange lat- och lon-parametrarna där de är tillgängliga. 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 inom 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 |
Typen av fråga som returneras: NEARBY eller NON_NEAR. |
|
totalResults |
integer |
Det totala antalet resultat som hittades. |