Metodtips för Azure Kartor tjänsten Search
Azure Kartor tjänsten Search innehåller API som erbjuder olika funktioner som hjälper utvecklare att söka efter adresser, platser, företagsuppgifter efter namn eller kategori och annan geografisk information. Till exempel tillåter Search Fuzzy användare att söka efter en adress eller punkt av intresse (POI).
Den här artikeln beskriver hur du tillämpar ljudmetoder när du anropar data från Azure Kartor tjänsten Search. Du lär dig att:
- Skapa frågor för att returnera relevanta matchningar
- Begränsa sökresultat
- Lär dig skillnaderna mellan resultattyper
- Läs strukturen för adresssökningssvar
Förutsättningar
Den här artikeln använder Postman-programmet för att skapa REST-anrop, men du kan välja vilken API-utvecklingsmiljö som helst.
Metodtips för geokodningsadresser
När du söker efter en fullständig eller partiell adress med hjälp av Azure Kartor tjänsten Search läser API:et nyckelord från din sökfråga. Sedan returneras longitud- och latitudkoordinaterna för adressen. Den här processen kallas geokodning.
Möjligheten att geokoda i ett land/en region beror på tillgängligheten för vägdata och geokodningstjänstens precision. Mer information om geokodningsfunktioner i Azure Kartor efter land eller region finns i Geokodningstäckning.
Begränsa sökresultat
Azure Kartor Search API 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.
Kommentar
Sök-API:erna stöder fler parametrar än bara de som beskrivs i den här artikeln.
Geobiaserade sökresultat
Om du vill ge geobias resultat till det relevanta området för din användare lägger du alltid till så många platsinformation som möjligt. Du kanske vill begränsa sökresultaten genom att ange några indatatyper:
Ange parametern
countrySet. Du kan till exempel ställa in den påUS,FR, till exempel. API:et söker som standard i hela världen, så att det kan returnera onödiga resultat. Om frågan inte har någoncountrySetparameter kan sökningen returnera felaktiga resultat. En sökning efter en stad med namnet Bellevue returnerar till exempel resultat från USA och Frankrike eftersom båda länderna/regionerna innehåller en stad med namnet Bellevue.Du kan använda parametrarna
btmRightochtopleftför att ange avgränsningsrutan. Dessa parametrar begränsar sökningen till ett visst område på kartan.Om du vill påverka relevansområdet för resultaten definierar du parametrarna
latochlonkoordinaten. Använd parameternradiusför att ange sökområdets radie.
Fuzzy-sökparametrar
Vi rekommenderar att du använder Sök fuzzy när du inte känner till dina användarindata för en sökfråga. Till exempel kan indata från användaren vara en adress eller typen av orienteringspunkt (POI), till exempel shoppingcenter. API:et kombinerar POI-sökning och geokodning till en kanonisk enkelradssökning:
Parametrarna
minFuzzyLevelochmaxFuzzyLevelhjälper till att returnera relevanta matchningar även om frågeparametrarna inte exakt matchar den information som användaren vill ha. För att maximera prestanda och minska ovanliga resultat anger du sökfrågor till standardvärden förminFuzzyLevel=1ochmaxFuzzyLevel=2.När parametern
maxFuzzyLeveltill exempel är inställd på 2 matchas söktermens restrant till restaurangen. Du kan åsidosätta standardfuzzy-nivåerna när du behöver.Använd parametern
idxSetfö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. I listan spelar objektordningen ingen roll. Azure Kartor stöder följande index:Addr- Adressintervall: Adresspunkter som interpoleras från början och slutet av gatan. Dessa punkter representeras som adressintervall.Geo- Geografiska områden: Administrativa indelningar av mark. Ett geografiskt område kan till exempel vara ett land/en region, en stat 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- Intressanta punkter: Punkter på en karta som anses vara värda uppmärksamhet eller som kan vara intressanta. Sökadressen returnerar inte API:er.Str- Gator: Gator på kartan.XStr- Korsgator eller korsningar: Korsningar eller platser där två gator korsar varandra.
Exempel på användning
idxSet=POI- Endast sök-URI:er.idxSet=PAD,Addr- Endast sökadresser.PADanger punktadressen ochAddranger adressintervallet.
Omvänd geokod och filter för en geografisk entitetstyp
När du gör en omvänd geokodsökning med omvänd sökadress kan tjänsten returnera polygoner för administrativa områden. Du kanske till exempel vill hämta områdespolygonen för en stad. Om du vill begränsa sökningen till specifika geografiska entitetstyper inkluderar du parametern entityType i dina begäranden.
Det resulterande svaret innehåller geografi-ID:t och den entitetstyp 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 tjänsten Search Polygon.
Exempelbegäran
https://atlas.microsoft.com/search/address/reverse/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&query=47.6394532,-122.1304551&language=en-US&entityType=Municipality
Response
{
"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åket
Använd parametern language för att ange språket för de returnerade sökresultaten. Om begäran inte anger språket använder tjänsten Search 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 parametern typeahead till true. Den här frågan tolkas som en partiell indata och sökningen går in i prediktivt läge. Om du inte anger parametern typeahead till trueförutsätter tjänsten att all relevant information har skickats in.
I följande exempelfråga efterfrågas sökadresstjänsten för Microso. Här är parametern inställd på typeaheadtrue. Svaret visar att söktjänsten tolkade frågan som en 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-Subscription-key}&api-version=1.0&typeahead=true&countrySet=US&lat=47.6370891183&lon=-122.123736172&query=Microsoft
Response
{
"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
För att hitta gatuadresser måste du koda URI:n för att hantera specialtecken i adressen. Tänk på det här adressexemplet: 1st Avenue & 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.
Exempel på användning
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 POI-sökning
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 parametern countrySet för att ange länder/regioner där programmet 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 av resultaten och informationen i svaret innehåller ett POI-söksvar varumärkesinformation. Du kan använda den här informationen för att ytterligare parsa svaret.
I en begäran kan du skicka en kommaavgränsad lista med varumärken. Använd listan för att begränsa resultatet till specifika varumärken genom att ange parametern brandSet . 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 POI-kategorin. I följande exempel letar vi efter bensinstationer nära Microsofts campus i Redmond, 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-Subscription-key}&api-version=1.0&query=gas%20station&limit=3&lat=47.6413362&lon=-122.1327968
Response
{
"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
}
}
]
}
]
}
Sökning på flygplats
Genom att använda API:et sökpunkt 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-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 Sök i närheten. Slutpunkten returnerar endast POI-resultat. Det finns ingen sökfrågeparameter.
För att begränsa resultatet 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 tjänsten Search. I följande begärande-URL anger vi parametern countrySet till US för att söka efter adressen i USA.
Exempelfråga
https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1&query=400%20Broad%20Street%2C%20Seattle%2C%20WA&countrySet=US
Typer av resultat som stöds
Punktadress: Punkter på en karta som har en specifik adress med gatunamn och nummer. Punktadress ger den högsta noggrannhetsnivån för adresser.
Adressintervall: Intervallet med adresspunkter som interpoleras från början och slutet av gatan.
Geografi: Områden på en karta som representerar administrativa divisioner av en mark, till exempel land/region, delstat eller stad.
POI: Punkter på en karta som är värda uppmärksamhet och som kan vara intressant.
Gata: Gator på kartan. Adresser matchas till latitud- och longitudkoordinaterna för den gata som innehåller adressen. Husnumret kanske inte bearbetas.
Korsgata: Korsningar. Korsgator representerar korsningar där två gator korsar varandra.
Response
Nu ska vi titta på svarsstrukturen. I svaret nedan skiljer sig typerna av resultatobjekt. Om du tittar noga ser du tre typer av resultatobjekt:
- Punktadress
- Gata
- Tvärs över gatan
Observera att adresssökningen inte returnerar URI:er.
Parametern Score för varje svarsobjekt anger hur matchande poäng 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
En svarstyp av geometri kan innehålla geometri-ID:t som returneras i dataSources objektet under geometry och id. Du kan till exempel använda tjänsten Search Polygon för att begära geometridata i geoJSON-format. Med det här formatet kan du få en stads- eller flygplatsdisposition för en uppsättning entiteter. Du kan sedan använda dessa gränsdata för att konfigurera geofence eller sök-URI:er i geometrin.
Svar för sökadress eller Sök fuzzy kan innehålla geometri-ID:t som returneras i dataSources objektet under geometry och 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: