Sök efter en plats med Azure Maps Search-tjänster.

Den här artikeln visar hur du:

• Begär latitud- och longitudkoordinater för en adress (geokodadressplats) med hjälp av sökadress.
• Sök efter en adress eller orienteringspunkt (POI) med fuzzy-sökning.
• Använd Omvänd adresssökning för att översätta koordinatplatsen till gatuadressen.
• Använd Search Address Reverse Cross Street API för att konvertera en koordinatlokal till en mänskligt läsbar korsning. Detta är särskilt användbart för att spåra program som tar emot GPS-data från enheter eller tillgångar och behöver fastställa den närmaste platsen på gatunivå för dessa koordinater.

Förutsättningar

• Ett Azure Maps-konto
• En prenumerationsnyckel

Den här artikeln använder Bruno-programmet , men du kan välja en annan API-utvecklingsmiljö.

Begär latitud och longitud för en adress (geokodning)

I exemplet i det här avsnittet används Hämta sökadress för att konvertera en adress till latitud- och longitudkoordinater. Den här processen kallas även geokodning. Förutom att returnera koordinaterna returnerar svaret även detaljerade adressegenskaper som gata, postnummer, kommun och land-/regioninformation.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/search/address/json?&subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&language=en-US&query=400 Broad St, Seattle, WA 98109
   

4. Välj knappen Skapa.

5. Välj knappen Kör.

   Den här begäran söker efter en specifik adress: 400 Broad St, Seattle, WA 98109. Sök sedan efter en adress som har mer än en möjlig plats.

6. I avsnittet Params ändrar du query nyckeln till 400 Broad, Seattleoch väljer sedan knappen Kör.

   

7. Försök sedan att ange query nyckeln till 400 Broaoch välj sedan knappen Kör.

   Svaret innehåller resultat från flera länder/regioner. För att anpassa geobiasresultaten till det relevanta området för dina användare ska du alltid lägga till så många platsdetaljer som möjligt i begäran.

Suddig sökning

Fuzzy Search stöder standardsökningar med en rad och fritt formulär. Vi rekommenderar att du använder Fuzzy-API:et för Azure Maps Search när du inte känner till användarens indatatyp för en sökbegäran. Frågeindata kan vara en fullständig eller partiell adress. Det kan också vara en token för intressepunkter (POI), som ett namn på en POI, POI-kategori eller namn på varumärken. För att förbättra relevansen för sökresultaten begränsar du dessutom frågeresultaten med hjälp av en koordinatplats och radie eller genom att definiera en avgränsningsruta.

Sök efter en adress med Fuzzy Search

Exemplet i det här avsnittet används Fuzzy Search för att söka i hela världen efter pizza och söker sedan efter omfånget för ett visst land/en viss region. Slutligen visar den hur du använder en koordinatplats och radie för att begränsa en sökning över ett visst område och begränsa antalet returnerade resultat.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&language=en-US&query=pizza
   

   Kommentar

   Json-attributet i URL-sökvägen avgör svarsformatet. Den här artikeln använder JSON för enkel användning och läsbarhet. Om du vill hitta andra svarsformat som stöds kan du läsa parameterdefinitionen format i referensdokumentationen för URI-parametern.

4. Välj knappen Kör och granska sedan svarstexten.

   Den tvetydiga frågesträngen för "pizza" returnerade 10 intressepunkter (POI) inom kategorierna "pizza" och "restaurang". Varje resultat innehåller information som gatuadress, latitud och longitudvärden, visa port och startpunkter för platsen. Resultatet varierar nu för den här frågan och är inte knutna till någon referensplats.

   I nästa steg använder du parametern countrySet för att endast ange de länder/regioner som programmet behöver täckning för. En fullständig lista över länder/regioner som stöds finns i Geokodningstäckning för Azure Maps.

5. Standardbeteendet är att söka i hela världen och eventuellt returnera onödiga resultat. Sök sedan bara efter pizza i USA. Lägg till nyckeln i countrySetavsnittet Params och ange dess värde till US. countrySet Om du anger nyckeln till US begränsas resultatet till USA.

   

   Resultaten begränsas nu av landskoden och frågan returnerar pizzarestauranger i USA.

6. För att få en ännu mer riktad sökning kan du söka över omfånget för ett lat/lon-koordinatpar. I följande exempel används lat/lon-koordinaterna för Seattle Space Needle. Eftersom vi bara vill returnera resultat inom en radie på 400 meter lägger vi till parametern radius . Dessutom lägger vi till parametern limit för att begränsa resultatet till de fem närmaste pizzaplatserna.

   I avsnittet Params lägger du till följande nyckel/värde-par:

   Nyckel	Värde
   lat	47.620525
   Lon	-122.349274
   radie	400
   gräns	5

7. Välj Kör. Svaret innehåller resultat för pizzarestauranger nära Seattle Space Needle.

Sök efter en gatuadress med hjälp av omvänd adresssökning

Omvänd sökadress omvandlar koordinater till läsbara gatuadresser. Det här API:et används ofta för program som använder GPS-feeds och vill identifiera adresser vid specifika koordinatpunkter.

Det här exemplet visar hur du gör omvända sökningar med hjälp av några av de valfria parametrar som är tillgängliga. En fullständig lista över valfria parametrar finns i Omvända sökparametrar.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/search/address/reverse/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&language=en-US&query=47.591180,-122.332700
   

4. Välj knappen Kör och granska svarstexten. Du bör se ett frågeresultat. Svaret innehåller viktig adressinformation om T-Mobile Park.

5. Lägg sedan till följande nyckel/värde-par i avsnittet Params :

   Nyckel	Värde	Returer
   Nummer	1	Svaret kan innehålla sidan av gatan (vänster/höger) och även ett förskjutet läge för numret.
   återgåHastighetsbegränsning	true	Visar hastighetsgränsen för adressen.
   returnRoadUse	true	Returnerar väganvändningstyper på adressen. Alla möjliga typer av väganvändning finns i Typer av väganvändning.
   returnMatchType	true	Returnerar matchningstypen. Alla möjliga värden finns i Sökresultat för omvänd adress.

   

6. Välj knappen Kör och granska svarstexten.

7. Lägg sedan till entityType nyckeln och ange dess värde till Municipality. Nyckeln entityType åsidosätter returnMatchType nyckeln i föregående steg. returnSpeedLimit och returnRoadUse behöver också tas bort eftersom du begär information om kommunen. Alla möjliga entitetstyper finns i Entitetstyper.

   

8. Välj knappen Kör. Jämför resultatet med de resultat som returneras i steg 5. Eftersom den begärda entitetstypen nu municipalityär innehåller svaret inte gatuadressinformation. Dessutom kan den returnerade geometryId användas för att begära gränspolygon via Azure Maps Get Search Polygon API.

Sök efter korsgata med hjälp av sökvägssökning med omvänd adress

Det här exemplet visar hur du söker efter en korsgata baserat på koordinaterna för en adress.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/search/address/reverse/crossstreet/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&language=en-US&query=47.591180,-122.332700
   

4. Välj knappen Kör och granska svarstexten. Observera att svaret innehåller ett crossStreet värde av South Atlantic Street.

Den här artikeln visar hur du:

• Begär latitud- och longitudkoordinater för en adress (geokodadressplats) med hjälp av Hämta geokodning.
• Sök efter en partiell adress med get geocode autocomplete.
• Använd Hämta omvänd geokodning för att översätta koordinatplatsen till gatuadressen.
• Översätt koordinatens plats till ett lättförståeligt gatukors med hjälp av Hämta omvänd geokodning, som oftast behövs i spårningsapplikationer som tar emot ett GPS-flöde från en enhet eller tillgång, för att veta var koordinaten är belägen.

Förutsättningar

• Ett Azure Maps-konto
• En prenumerationsnyckel

Den här artikeln använder Bruno-programmet , men du kan välja en annan API-utvecklingsmiljö.

Begära koordinater för en adress med hjälp av Hämta geokodning

I exemplet i det här avsnittet används Get Geocoding för att konvertera en adress till latitud- och longitudkoordinater. Den här processen kallas även geokodning. Förutom att returnera koordinaterna returnerar svaret även detaljerade adressegenskaper som gata, postnummer, kommun och land-/regioninformation.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   GET https://atlas.microsoft.com/geocode?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}&query=400 Broad St, Seattle, WA 98109
   

4. Välj knappen Skapa.

5. Välj knappen Kör.

   Den här begäran söker efter en specifik adress: 400 Broad St, Seattle, WA 98109. Sök sedan efter en adress som har mer än en möjlig plats.

6. I avsnittet Params ändrar du query nyckeln till 400 Broad, Seattleoch väljer sedan knappen Kör.

7. Försök sedan att ange query nyckeln till 400 Broaoch välj sedan knappen Kör.

   Svaret innehåller resultat från flera länder/regioner. För att anpassa geobiasresultaten till det relevanta området för dina användare ska du alltid lägga till så många platsdetaljer som möjligt i begäran.

Använd Get Geocode Autocomplete för partiell adresssökning

API: Get Geocode Autocomplete stödjer både enkellinje- och friformsadressinmatningar, vilket gör det idealiskt för situationer där en komplett adress saknas. Du kan skicka antingen en fullständig eller partiell adress som fråga. För att förbättra resultatets noggrannhet och relevans rekommenderar vi att du begränsar sökningen genom att ange koordinater eller en avgränsningsruta.

Sök efter en plats

Det här exemplet visar hur du använder API:et Get Geocode Autocomplete för att söka efter en plats på hela den nordamerikanska kontinenten efter partiella indata som "university of w". Den visar sedan hur du begränsar sökomfånget till ett visst land eller en viss region med hjälp av parametern countryRegion . Slutligen visar den hur du använder parametern coordinates för att fokusera sökningen till ett visst område.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=university of w&bbox=-168,-52,5,84&subscription-key={Your-Azure-Maps-Subscription-key}
   

4. Välj knappen Kör och granska sedan svarstexten.

   Kommentar

   Parametern bbox i URL:en definierar en avgränsningsruta som omfattar Kanada, USA, Mexiko, Grönland och delar av Karibien. Det returnerar flera universitet som ligger inom detta område, inklusive:

   • University of Washington i King County, Delstaten Washington, USA
   • University of Waterloo i Waterloo, Ontario, Kanada
   • University of Wyoming i Laramie, Wyoming, USA
   • University of Windsor i Windsor, Ontario, Kanada
   • University of West Florida i Escambia County, Florida, USA

Begränsa sedan det område som ingår i sökningen till USA med hjälp av parametern countryRegion .

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=university of w&bbox=-168,-52,5,84&countryRegion=us&subscription-key={Your-Azure-Maps-Subscription-key}
   

4. Välj knappen Kör och granska sedan svarstexten.

   Kommentar

   Parametern bbox i URL:en definierar samma avgränsningsruta som i föregående exempel, men parametern countryRegion=us begränsar resultaten till USA. Det returnerar flera universitet som ligger inom detta område, inklusive:

   • University of Washington i King County, Delstaten Washington, USA
   • University of Wyoming i Laramie, Wyoming, USA
   • University of West Florida i Escambia County, Florida, USA
   • University of Wisconsin-Superior i Douglas County, Wisconsin, USA
   • University of Wisconsin-Stout i Menomonie, Dunn County, Wisconsin, USA

Fokusera sedan sökningen för att inkludera fler resultat i ett specifikt område inom det definierade countryRegion, med hjälp av parametern coordinates . Detta resulterar i fler objekt som returneras nära det angivna området som annars inte skulle göra listan.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=university of w&bbox=-168,-52,5,84&countryRegion=us&coordinates=-122.136791,47.642232&subscription-key={Your-Azure-Maps-Subscription-key}
   

4. Välj knappen Kör och granska sedan svarstexten.

   Kommentar

   Parametrarna bbox och countryRegion i den här URL:en definierar samma gränser som i föregående exempel, men parametern coordinates=-122.136791,47.642232 fokuserar sökresultaten på det angivna området. Den returnerar ett lokalt universitet som annars inte skulle returneras.

   • University of Washington i King County, Delstaten Washington, USA
   • University of Washington, Tacoma i Tacoma, Pierce County, Washington State, USA
   • University of Wyoming i Laramie, Wyoming, USA
   • University of West Florida i Escambia County, Florida, USA
   • University of Wisconsin-Stout i Menomonie, Dunn County, Wisconsin, USA

Söka efter en adress

Exemplen i det här avsnittet visar skillnaden mellan att söka efter en plats och söka efter en adress med parametern resultTypeGroupsget geocode autocomplete API, med hjälp av exempel som söker efter Disneyland i södra Kalifornien med hjälp av partiella indata som "dis" och parametern coordinates för att fokusera sökningen till ett visst område.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=dis&coordinates=-117.920219,33.809570&subscription-key={Your-Azure-Maps-Subscription-key}
   

4. Välj knappen Kör och granska sedan svarstexten.

   Observera att svaret innehåller platsvärden som innehåller:

   Egenskapsnamn	Egenskapsvärde
   typeGroup	Plats
   type	AmusementPark
   name	Disney California Adventure Park

   Dricks

   Egenskapen type är mest relevant när du använder resultTypeGroups=place. Om du vill visa tillgängliga typer läser du Autocomplete ResultType Enum. Om du vill definiera vilka typer som ska sökas använder du resultTypes. För implementeringsdetaljer, se API-anropet för Autocomplete för att söka efter 'Muir Woods', filtrerat efter resultattyperna för park och bebyggd plats, samt exempel på platsresultattypsgrupper.

5. När inga värden anges för parametern resultTypeGroups kan frågor returnera både plats- och adressvärden. Om du bara är intresserad av att söka efter adresser kan du inkludera resultTypeGroups=address i din begäran:

   https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=dis&coordinates=-117.920219,33.809570&resultTypeGroups=address&subscription-key={Your-Azure-Maps-Subscription-key}
   

   Observera att svaret innehåller adressvärden som innehåller:

   Egenskapsnamn	Egenskapsvärde
   typeGroup	Address
   streetName	Disneyland
   formateradAdress	Disneyland, Anaheim, CA 92802, USA

Sök efter en gatuadress med hjälp av Hämta omvänd geokodning

Hämta omvänd geokodning översätter koordinater till läsbara gatuadresser. Det här API:et används ofta för program som använder GPS-feeds och vill identifiera adresser vid specifika koordinatpunkter.

Det här exemplet visar hur du gör omvända sökningar med hjälp av några av de valfria parametrar som är tillgängliga. En fullständig lista över valfria parametrar finns i Hämta parametrar för omvänd geokodning.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}&coordinates=-122.332700,47.591180
   

4. Välj knappen Kör och granska svarstexten. Du bör se ett frågeresultat. Svaret innehåller viktig adressinformation om T-Mobile Park.

5. Lägg sedan till följande parameter i begäran: resultTypes=Postcode1

   https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}&coordinates=-122.332700,47.591180&resultTypes=Postcode1
   

6. Välj knappen Kör och jämför resultatet med resultaten som returnerades tidigare. Eftersom den begärda resultattypen nu Postcode1är innehåller svaret inte gatuadressinformation, bara postnumret.

Sök efter korsgata med hjälp av Hämta omvänd geokodning

Det här exemplet visar hur du söker efter en korsgata baserat på koordinaterna för en adress.

1. Öppna Bruno-programmet .

2. Välj NY BEGÄRAN för att skapa begäran. I fönstret NY BEGÄRAN anger du Typ till HTTP. Ange ett namn för begäran.

3. Välj metoden GET HTTP i listrutan URL och ange sedan följande URL:

   https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates=-122.12429011774091,47.61697905124655&subscription-key={Your-Azure-Maps-Subscription-key}
   

4. Välj knappen Kör och granska svarstexten.

   Svaret innehåller ett intersection avsnitt som identifierar gatudelen av den returnerade adressen: NE 8th St. Den anger också den korsande gatan: 164th Ave NE, och ger hela korsgatan som: NE 8th St och 164th Ave NE.

    "intersection": {
    "baseStreet": "NE 8th St",
    "displayName": "NE 8th St and 164th Ave NE",
    "intersectionType": "Near",
    "secondaryStreet1": "164th Ave NE"
    }