Metodtips för Azure Kartor Search Service
Azure Kartor Search Service innehåller API:er som erbjuder olika funktioner som hjälper utvecklare att söka efter adresser, platser, företagslistor efter namn eller kategori och annan geografisk information. MedAPI:et för fuzzy-sökning kan användare till exempel söka efter en adress eller en point of Interest (POI).
Den här artikeln förklarar hur du använder bra metoder när du anropar data från Azure Kartor Search Service. Du lär dig följande:
- Skapa frågor för att returnera relevanta matchningar
- Begränsa sökresultat
- Lär dig skillnaderna mellan resultattyper
- Läs adressens söksvarsstruktur
Förutsättningar
- Skapa ett Azure Kartor konto
- Skaffa en primär prenumerationsnyckel, som även kallas primärnyckel eller prenumerationsnyckel.
Den här artikeln använder Postman-appen för att skapa REST-anrop, men du kan välja valfri API-utvecklingsmiljö.
Metodtips för geokodning av adresser
När du söker efter en fullständig eller partiell adress med hjälp av Azure Kartor Search Service läser API:et nyckelord från din sökfråga. Sedan returneras adressens longitud- och latitudkoordinater. Den här processen kallas geokodning.
Möjligheten att geokoda i ett land/en region beror på tillgängligheten för vägdata och precisionen för tjänsten för geokodning. Mer information om Azure Kartor geokodningsfunktioner efter land eller region finns i Täckning för geokodning.
Begränsa sökresultat
Azure Kartor Search-API:et kan hjälpa dig att begränsa sökresultaten på rätt sätt. Du begränsar resultaten så att du kan visa relevanta data för dina användare.
Anteckning
Sök-API:erna stöder fler parametrar än bara de som beskrivs i den här artikeln.
Geobiaserade sökresultat
Lägg alltid till så många platsinformation som möjligt för att ge geobias resultat till relevant område för din användare. Du kanske vill begränsa sökresultaten genom att ange vissa indatatyper:
Ange
countrySetparametern . Du kan till exempel ställa inUS,FRden på . Som standard söker API:et igenom hela världen så att det kan returnera onödiga resultat. Om frågan inte har någoncountrySetparameter kan sökningen returnera felaktiga resultat. Till exempel returnerar en sökning efter en stad med namnet Bellevue resultat från USA och Frankrike eftersom båda länderna/regionerna innehåller en stad med namnet Bellevue.Du kan använda
btmRightparametrarnatopleftoch för att ange en begränsningsruta. De här parametrarna begränsar sökningen till ett visst område på kartan.Om du vill påverka relevansområdet för resultaten definierar du koordinaterna
latlonoch . Användradiusparametern för att ange radien för sökområdet.
Fuzzy-sökparametrar
Vi rekommenderar att du använder Azure Kartor Search Fuzzy API när du inte känner till dina användarindata för en sökfråga. Indata från användaren kan till exempel vara en adress eller typ av intressepunkt (POI), till exempel shoppinggalleriet. API:et kombinerar POI-sökning och geokodning till en kanonisk enradssökning:
Parametrarna
minFuzzyLeveloch hjälper till att returnera relevantamaxFuzzyLevelmatchningar även om frågeparametrarna inte exakt matchar den information som användaren vill ha. Om du vill maximera prestanda och minska ovanliga resultat ställer du in sökfrågorna på standardvärdenaminFuzzyLevel=1ochmaxFuzzyLevel=2.När parametern till
maxFuzzyLevelexempel är inställd på 2 matchas söktermen restrant till restaurang. Du kan åsidosätta standardnivåerna för fuzzy när du behöver det.Använd
idxSetparametern för att prioritera den exakta uppsättningen resultattyper. Om du vill prioritera en exakt uppsättning resultat kan du skicka en kommaavgränsad lista med index. Objektordningen spelar ingen roll i listan. Azure Kartor stöder följande index:Addr- Adressintervall: Adresspunkter som interpoleras från början och slutet av gatuadressen. Dessa punkter representeras som adressintervall.Geo- Geografiska områden: Administrativa delningar av land. Ett geografiskt område kan till exempel vara ett land/en region, en delstat eller en stad.PAD- Punktadresser: Adresser som innehåller ett gatunamn och ett nummer. Punktadresser finns i ett index. Ett exempel är Soquel Dr 2501. En punktadress ger den högsta noggrannhetsnivån som är tillgänglig för adresser.POI- Platser av intresse: Punkter på en karta som anses vara värda uppmärksamhet eller som kan vara intressanta. API:et search address returnerar inte POI:er.Str- Gator: Gator på kartan.XStr- Kors gator eller vägkorsningar: Skärningspunkter eller platser där två gator korsas.
Användningsexempel
idxSet=POI– Sök endast efter IO:er.idxSet=PAD,Addr– Sök endast adresser.PADanger punktadressen ochAddranger adressintervallet.
Omvänd geokodning och filter för en geografisk entitetstyp
När du gör en sökning med omvänd geokod i API:et Search Address Reversekan tjänsten returnera polygoner för administrativa områden. Du kanske till exempel vill hämta områdets polygon för en stad. Om du vill begränsa sökningen till specifika typer av geografiska entiteter inkluderar du entityType parametern i dina begäranden.
Det resulterande svaret innehåller geografi-ID:t och entitetstypen som matchades. Om du anger mer än en entitet returnerar slutpunkten den minsta tillgängliga entiteten. Du kan använda det returnerade geometri-ID:t för att hämta geografins geometri via Search Polygon-tjänsten.
Exempelbegäran
https://atlas.microsoft.com/search/address/reverse/json?api-version=1.0&subscription-key={Your-Azure-Maps-Primary-Subscription-key}&query=47.6394532,-122.1304551&language=en-US&entityType=Municipality
Svarsåtgärder
{
"summary": {
"queryTime": 14,
"numResults": 1
},
"addresses": [
{
"address": {
"routeNumbers": [],
"countryCode": "US",
"countrySubdivision": "WA",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"municipality": "Redmond",
"country": "United States",
"countryCodeISO3": "USA",
"countrySubdivisionName": "Washington"
},
"position": "47.639454,-122.130455",
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-0000596ae571"
}
},
"entityType": "Municipality"
}
]
}
Ange resultatspråk
Använd language parametern för att ange språk för de returnerade sökresultaten. Om begäran inte anger språket använder Search Service som standard det vanligaste språket i landet eller regionen. När inga data är tillgängliga på det angivna språket används standardspråket.
Mer information finns i Azure Kartor språk som stöds.
Använda förutsägelseläge (automatiska förslag)
Om du vill hitta fler matchningar för partiella frågor anger du typeahead parametern till true . Den här frågan tolkas som partiella indata och sökningen går in i prediktivt läge. Om du inte anger typeahead parametern till true förutsätter tjänsten att all relevant information har angetts.
I följande exempelfråga efterfrågas tjänsten Search Address för Microso. Här har typeahead parametern angetts till true . Svaret visar att söktjänsten tolkade frågan som partiell fråga. Svaret innehåller resultat för en automatiskt föreslagen fråga.
Exempelfråga
https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&typeahead=true&countrySet=US&lat=47.6370891183&lon=-122.123736172&query=Microsoft
Svarsåtgärder
{
"summary": {
"query": "microsoft",
"queryType": "NON_NEAR",
"queryTime": 18,
"numResults": 7,
"offset": 0,
"totalResults": 7,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.6370891183,
"lon": -122.123736172
}
},
"results": [
{
"type": "Street",
"id": "US/STR/p0/9438784",
"score": 2.594099998474121,
"dist": 314.0590106663596,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
},
"position": {
"lat": 47.63988,
"lon": -122.12438
},
"viewport": {
"topLeftPoint": {
"lat": 47.64223,
"lon": -122.1256,
"valid": true
},
"btmRightPoint": {
"lat": 47.63748,
"lon": -122.12309,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/1756074",
"score": 2.592679977416992,
"dist": 876.0272035824189,
"address": {
"streetName": "Microsoft Road",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft Road, Redmond, WA 98052"
},
"position": {
"lat": 47.64032,
"lon": -122.1344
},
"viewport": {
"topLeftPoint": {
"lat": 47.64253,
"lon": -122.13535,
"valid": true
},
"btmRightPoint": {
"lat": 47.63816,
"lon": -122.13305,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/1470668",
"score": 2.5290400981903076,
"dist": 2735.4883918101486,
"address": {
"streetName": "Microsoft West Campus Road",
"municipalitySubdivision": "Redmond",
"municipality": "Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft West Campus Road, Bellevue, WA 98007"
},
"position": {
"lat": 47.65784,
"lon": -122.14335
},
"viewport": {
"topLeftPoint": {
"lat": 47.65785,
"lon": -122.14335,
"valid": true
},
"btmRightPoint": {
"lat": 47.65784,
"lon": -122.14325,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/12812615",
"score": 2.527509927749634,
"dist": 2870.9579016916873,
"address": {
"streetName": "Microsoft West Campus Road",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft West Campus Road, Redmond, WA 98052"
},
"position": {
"lat": 47.66034,
"lon": -122.1404
},
"viewport": {
"topLeftPoint": {
"lat": 47.66039,
"lon": -122.14325,
"valid": true
},
"btmRightPoint": {
"lat": 47.65778,
"lon": -122.13749,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/197588",
"score": 2.4630401134490967,
"dist": 878.1404663812472,
"address": {
"streetName": "157th Avenue Northeast",
"municipalitySubdivision": "Redmond",
"municipality": "Redmond",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98052",
"extendedPostalCode": "980525344, 980525398, 980525399",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "157th Avenue Northeast, Redmond, WA 98052"
},
"position": {
"lat": 47.64351,
"lon": -122.13056
},
"viewport": {
"topLeftPoint": {
"lat": 47.64473,
"lon": -122.13058,
"valid": true
},
"btmRightPoint": {
"lat": 47.6425,
"lon": -122.13016,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/3033991",
"score": 2.0754499435424805,
"dist": 3655467.8844475765,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Yorkmount, Charlotte",
},
"position": {
"lat": 35.14267,
"lon": -80.91824
},
"viewport": {
"topLeftPoint": {
"lat": 35.14287,
"lon": -80.91839,
"valid": true
},
"btmRightPoint": {
"lat": 35.14267,
"lon": -80.91814,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/8395877",
"score": 2.0754499435424805,
"dist": 3655437.0037482483,
"address": {
"streetName": "Microsoft Way",
"municipalitySubdivision": "Charlotte",
"municipality": "Charlotte",
"countrySecondarySubdivision": "Mecklenburg",
"countryTertiarySubdivision": "Township 1 Charlotte",
"countrySubdivision": "NC",
"countrySubdivisionName": "North Carolina",
"postalCode": "28273",
"extendedPostalCode": "282738105, 282738106, 282738108, 2827382, 282738200",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Microsoft Way, Charlotte, NC 28273"
},
"position": {
"lat": 35.14134,
"lon": -80.9198
},
"viewport": {
"topLeftPoint": {
"lat": 35.14274,
"lon": -80.92159,
"valid": true
},
"btmRightPoint": {
"lat": 35.14002,
"lon": -80.91824,
"valid": true
}
}
}
]
}
Koda en URI för att hantera specialtecken
Du måste koda URI:en för att hantera specialtecken i adressen för att hitta gatuadresser. Ta det här adressexempel: 1st Street & Union Street, Seattle. Här kodar du et-tecknet ( & ) innan du skickar begäran.
Vi rekommenderar att du kodar teckendata i en URI. I en URI kodar du alla tecken med hjälp av ett procenttecken ( ) och ett hexadecimalt värde med två tecken som motsvarar % tecknens UTF-8-kod.
Användningsexempel
Börja med den här adressen:
query=1st Avenue & E 111th St, New York
Koda adressen:
query=1st%20Avenue%20%26%20E%20111th%20St%2C%20New%20York
Du kan använda följande metoder.
JavaScript eller TypeScript:
encodeURIComponent(query)
C# eller Visual Basic:
Uri.EscapeDataString(query)
Java:
URLEncoder.encode(query, "UTF-8")
Python:
import urllib.parse
urllib.parse.quote(query)
C++:
#include <curl/curl.h>
curl_easy_escape(query)
PHP:
urlencode(query)
Ruby:
CGI::escape(query)
Swift:
query.stringByAddingPercentEncodingWithAllowedCharacters(.URLHostAllowedCharacterSet())
Gå:
import ("net/url")
url.QueryEscape(query)
Metodtips för SÖKNING efter platser
I en POI-sökning kan du begära POI-resultat efter namn. Du kan till exempel söka efter ett företag efter namn.
Vi rekommenderar starkt att du använder countrySet parametern för att ange länder/regioner där ditt program behöver täckning. Standardbeteendet är att söka i hela världen. Den här breda sökningen kan returnera onödiga resultat och sökningen kan ta lång tid.
Varumärkessökning
För att förbättra relevansen för resultaten och informationen i svaret innehåller ett POI-söksvar varumärkesinformation. Du kan använda den här informationen för att parsa svaret ytterligare.
I en begäran kan du skicka en kommaavgränsad lista med varumärkesnamn. Använd listan för att begränsa resultaten till specifika varumärken genom att ange brandSet parametern . Objektordningen spelar ingen roll i listan. När du anger flera varumärkeslistor måste de resultat som returneras tillhöra minst en av dina listor.
Om du vill utforska varumärkessökning ska vi göra en sökbegäran för EN POI-kategori. I följande exempel letar vi efter bensinstationer nära Microsoft Campus i Redmond i Washington. Svaret visar varumärkesinformation för varje POI som returnerades.
Exempelfråga
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&query=gas%20station&limit=3&lat=47.6413362&lon=-122.1327968
Svarsåtgärder
{
"summary": {
"query": "gas station",
"queryType": "NON_NEAR",
"queryTime": 276,
"numResults": 3,
"offset": 0,
"totalResults": 762680,
"fuzzyLevel": 1,
"geoBias": {
"lat": 47.6413362,
"lon": -122.1327968
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p0/8831765",
"score": 5.6631999015808105,
"dist": 1037.0280221303253,
"info": "search:ta:840531000004190-US",
"poi": {
"name": "Chevron",
"phone": "+(1)-(425)-6532200",
"brands": [
{
"name": "Chevron"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.chevron.com",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "2444",
"streetName": "Bel Red Rd",
"municipalitySubdivision": "Northeast Bellevue, Bellevue",
},
"position": {
"lat": 47.63201,
"lon": -122.13281
},
"viewport": {
"topLeftPoint": {
"lat": 47.63291,
"lon": -122.13414,
"valid": true
},
"btmRightPoint": {
"lat": 47.63111,
"lon": -122.13148,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.63222,
"lon": -122.13312,
"valid": true
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/8831752",
"score": 5.662710189819336,
"dist": 1330.1278248163273,
"info": "search:ta:840539001100326-US",
"poi": {
"name": "76",
"phone": "+(1)-(425)-7472126",
"brands": [
{
"name": "76"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.76.com",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "2421",
"streetName": "148Th Ave Ne",
"municipalitySubdivision": "Redmond, Bridle Trails, Bellevue",
"municipality": "Redmond, Bellevue",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle East",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98007",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "2421 148Th Ave Ne, Bellevue, WA 98007",
"localName": "Bellevue"
},
"position": {
"lat": 47.63187,
"lon": -122.14365
},
"viewport": {
"topLeftPoint": {
"lat": 47.63277,
"lon": -122.14498,
"valid": true
},
"btmRightPoint": {
"lat": 47.63097,
"lon": -122.14232,
"valid": true
}
},
"entryPoints": [
{
"type": "minor",
"position": {
"lat": 47.63187,
"lon": -122.14374,
"valid": true
}
},
{
"type": "main",
"position": {
"lat": 47.63186,
"lon": -122.14313,
"valid": true
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/8831764",
"score": 5.662449836730957,
"dist": 1458.645407416307,
"info": "search:ta:840539000488527-US",
"poi": {
"name": "BROWN BEAR CAR WASH",
"phone": "+(1)-(425)-6442868",
"brands": [
{
"name": "Texaco"
}
],
"categorySet": [
{
"id": 7311
}
],
"url": "www.texaco.com/",
"categories": [
"petrol station"
],
"classifications": [
{
"code": "PETROL_STATION",
"names": [
{
"nameLocale": "en-US",
"name": "petrol station"
}
]
}
]
},
"address": {
"streetNumber": "15248",
"streetName": "Bel Red Rd",
"municipalitySubdivision": "Redmond",
},
"position": {
"lat": 47.62843,
"lon": -122.13628
},
"viewport": {
"topLeftPoint": {
"lat": 47.62933,
"lon": -122.13761,
"valid": true
},
"btmRightPoint": {
"lat": 47.62753,
"lon": -122.13495,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.62827,
"lon": -122.13628,
"valid": true
}
}
]
}
]
}
Airport-sökning
Med hjälp av API:et Search POI kan du söka efter flygplatser med hjälp av deras officiella kod. Du kan till exempel använda SEA för att hitta Seattle-Tacoma International Airport:
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&query=SEA
Sökning i närheten
Om du vill hämta POI-resultat runt en viss plats kan du prova att använda API:et Sök i närheten. Slutpunkten returnerar endast POI-resultat. Den tar inte med en sökfrågaparameter.
Om du vill begränsa resultaten rekommenderar vi att du anger radien.
Förstå svaren
Nu ska vi hitta en adress i Seattle genom att göra en begäran om adresssökning till Azure Kartor Search Service. I följande begärande-URL anger vi countrySet parametern US till för att söka efter adressen i USA.
Exempelfråga
https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1&query=400%20Broad%20Street%2C%20Seattle%2C%20WA&countrySet=US
Resultattyper som stöds
Punktadress: Punkter på en karta som har en specifik adress med gatunamn och nummer. Punktadress ger den högsta noggrannheten för adresser.
Adressintervall: Det intervall med adresspunkter som interpoleras från början och slutet av gatan.
Geografi: Områden på en karta som representerar administrativa indelningar av ett land, till exempel land/region, delstat eller stad.
POI: Punkter på en karta som är värda att titta på och som kan vara intressanta.
Gatuadress: Gator på kartan. Adresser matchas med latitud- och longitudkoordinaterna för den gata som innehåller adressen. Husnumret kanske inte bearbetas.
Cross Street: Skärningspunkter. Korskända gator representerar knutpunkter där två gator korsas.
Svarsåtgärder
Nu ska vi titta på svarsstrukturen. I svaret som följer är typerna av resultatobjekt olika. Om du tittar noggrant ser du tre typer av resultatobjekt:
- Punktadress
- Gata
- Cross Street
Observera att adresssökningen inte returnerar POI:er.
Parametern Score för varje svarsobjekt anger hur matchningspoängen relaterar till poängen för andra objekt i samma svar. Mer information om parametrar för svarsobjekt finns i Hämta sökadress.
{
"summary": {
"query": "400 broad street seattle wa",
"queryType": "NON_NEAR",
"queryTime": 146,
"numResults": 6,
"offset": 0,
"totalResults": 7,
"fuzzyLevel": 1
},
"results": [
{
"type": "Point Address",
"id": "US/PAD/p0/28725082",
"score": 9.893799781799316,
"address": {
"streetNumber": "400",
"streetName": "Broad Street",
},
"position": {
"lat": 47.62039,
"lon": -122.34928
},
"viewport": {
"topLeftPoint": {
"lat": 47.62129,
"lon": -122.35061,
"valid": true
},
"btmRightPoint": {
"lat": 47.61949,
"lon": -122.34795,
"valid": true
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 47.61982,
"lon": -122.34886,
"valid": true
}
}
]
},
{
"type": "Street",
"id": "US/STR/p0/6700384",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
},
"position": {
"lat": 47.61724,
"lon": -122.35207
},
"viewport": {
"topLeftPoint": {
"lat": 47.61825,
"lon": -122.35336,
"valid": true
},
"btmRightPoint": {
"lat": 47.61626,
"lon": -122.35078,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/9701953",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
},
"position": {
"lat": 47.61965,
"lon": -122.349
},
"viewport": {
"topLeftPoint": {
"lat": 47.62066,
"lon": -122.35041,
"valid": true
},
"btmRightPoint": {
"lat": 47.61857,
"lon": -122.34761,
"valid": true
}
}
},
{
"type": "Street",
"id": "US/STR/p0/11721297",
"score": 8.129190444946289,
"address": {
"streetName": "Broad Street",
"municipalitySubdivision": "Seattle, Downtown Seattle, Denny Regrade, Belltown",
"municipality": "Seattle",
"countrySecondarySubdivision": "King",
"countryTertiarySubdivision": "Seattle",
"countrySubdivision": "WA",
"countrySubdivisionName": "Washington",
"postalCode": "98121",
"extendedPostalCode": "981211237",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "Broad Street, Seattle, WA 98121"
},
"position": {
"lat": 47.61825,
"lon": -122.35078
},
"viewport": {
"topLeftPoint": {
"lat": 47.61857,
"lon": -122.35078,
"valid": true
},
"btmRightPoint": {
"lat": 47.61825,
"lon": -122.35041,
"valid": true
}
}
},
{
"type": "Cross Street",
"id": "US/XSTR/p1/232144",
"score": 6.754479885101318,
"address": {
"streetName": "Broad Street & Valley Street",
"municipalitySubdivision": "South Lake Union, Seattle",
},
"position": {
"lat": 47.62545,
"lon": -122.33974
},
"viewport": {
"topLeftPoint": {
"lat": 47.62635,
"lon": -122.34107,
"valid": true
},
"btmRightPoint": {
"lat": 47.62455,
"lon": -122.33841,
"valid": true
}
}
}
]
}
Geometri
Svarstypen Geometry kan innehålla det geometri-ID som returneras i dataSources objektet under och geometry id . Du kan till exempel använda tjänsten Search Polygon för att begära geometridata i ett GeoJSON-format. Med det här formatet kan du hämta en stads- eller flygplatskontur för en uppsättning entiteter. Du kan sedan använda dessa gränsdata för att konfigurera geofence- eller sök-POI:er i geometrin.
Svar för API:et Search Address eller Search Fuzzy API kan innehålla det geometri-ID som returneras i dataSources objektet under och geometry id :
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-000059690938" // The geometry ID is returned in the dataSources object under "geometry" and "id".
}
}
Nästa steg
Mer information finns i: