Search - Get Geocoding

Referens

Tjänst:: Maps

API-version:: 2023-06-01

Använd för att hämta longitud- och latitudkoordinater för en gatuadress eller ett namn på en plats.

API:et Get Geocoding är en HTTP-begäran GET som returnerar longitud- och latitudkoordinaterna för platsen som genomsöks.

I många fall kan den fullständiga söktjänsten vara för mycket, till exempel om du bara är intresserad av traditionell geokodning. Du kan också söka efter adresssökning exklusivt. Geokodningen utförs genom att träffa geokodningsslutpunkten med bara adressen eller den partiella adressen i fråga. Sökindexet för geokodning efterfrågas för allt över gatunivådata. Ingen intressepunkt returneras. Observera att geokodaren är mycket tolerant mot skrivfel och ofullständiga adresser. Det kommer också att hantera allt från exakta gatuadresser eller gatu- eller korsningar samt geografiska områden på högre nivå som stadskärnor, län och stater. Svaret returnerar även detaljerade adressegenskaper som gata, postnummer, kommun och land/regioninformation.

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

Med valfria parametrar:

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01&top={top}&query={query}&addressLine={addressLine}&countryRegion={countryRegion}&bbox={bbox}&view={view}&coordinates={coordinates}&adminDistrict={adminDistrict}&adminDistrict2={adminDistrict2}&adminDistrict3={adminDistrict3}&locality={locality}&postalCode={postalCode}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
api-version	query	True	string	Versionsnummer för Azure Maps API.
addressLine	query		string	Den officiella gaturaden för en adress i förhållande till området, enligt vad som anges av egenskaperna locality eller postalCode. Typisk användning av det här elementet är att ange en gatuadress eller en officiell adress. Om frågan anges bör du inte använda den här parametern.
adminDistrict	query		string	Landets del av indelningen av en adress, till exempel WA. Om frågan anges bör du inte använda den här parametern.
adminDistrict2	query		string	Länet för den strukturerade adressen, till exempel King. Om frågan anges bör du inte använda den här parametern.
adminDistrict3	query		string	Det namngivna området för den strukturerade adressen. Om frågan anges bör du inte använda den här parametern.
bbox	query		number[]	Ett rektangulärt område på jorden definierat som ett avgränsningsfältsobjekt. Rektanglarnas sidor definieras av longitud- och latitudvärden. När du anger den här parametern beaktas det geografiska området när du beräknar resultatet av en platsfråga. Exempel: lon1,lat1,lon2,lat2
coordinates	query		number[]	En punkt på jorden som anges som longitud och latitud. När du anger den här parametern beaktas användarens plats och de resultat som returneras kan vara mer relevanta för användaren. Exempel: &koordinater=lon,lat
countryRegion	query		string	Signal för geokodningsresultatet till en ISO 3166-1 Alpha-2-region/landskod som anges, t.ex. FR./ Om frågan anges bör du inte använda den här parametern.
locality	query		string	Lokalitetsdelen av en adress, till exempel Seattle. Om frågan anges bör du inte använda den här parametern.
postalCode	query		string	Postnummerdelen av en adress. Om frågan anges bör inte använda den här parametern.
query	query		string	En sträng som innehåller information om en plats, till exempel en adress eller ett landmärkesnamn.
top	query		integer int32	Maximalt antal svar som ska returneras. Standard: 5, minimum: 1 och maximum: 20.
view	query		string	En sträng som representerar en ISO 3166-1 Alpha-2-region/landskod. Detta ändrar geopolitiska omtvistade kantlinjer och etiketter så att de överensstämmer med den angivna användarregionen. Som standard är view-parametern inställd på "Auto" även om du inte har definierat den i begäran. Mer information finns i Vyer som stöds och för att se tillgängliga vyer.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Accept-Language		string	Språk där sökresultat ska returneras. Mer information finns i Språk som stöds .
x-ms-client-id		string	Anger vilket konto som är avsett för användning tillsammans med Azure AD-säkerhetsmodellen. Det representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Konto-API:et för Azure Maps-hanteringsplan. Information om hur du använder Azure AD-säkerhet i Azure Maps finns i följande artiklar .

Name

Obligatorisk

Typ

Description

Accept-Language

string

Språk där sökresultat ska returneras.

Mer information finns i Språk som stöds .

x-ms-client-id

string

Anger vilket konto som är avsett för användning tillsammans med Azure AD-säkerhetsmodellen. Det representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Konto-API:et för Azure Maps-hanteringsplan. Information om hur du använder Azure AD-säkerhet i Azure Maps finns i följande artiklar .

Svar

Name	Typ	Description
200 OK	GeocodingResponse	OK Media Types: "application/geo+json" Sidhuvuden x-ms-request-id: string
Other Status Codes	ErrorResponse	Det uppstod ett oväntat fel. Media Types: "application/geo+json"

Name

Typ

Description

200 OK

GeocodingResponse

Media Types: "application/geo+json"

Sidhuvuden

x-ms-request-id: string

Other Status Codes

ErrorResponse

Det uppstod ett oväntat fel.

Media Types: "application/geo+json"

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 REST-API:er för Azure Maps. Rollbaserade åtkomstkontroller i Azure används för att ange åtkomst till ett eller flera Azure Maps-resurskonton eller underresurser. Alla användare, grupper eller tjänstens huvudnamn kan beviljas åtkomst via en inbyggd roll eller en anpassad roll som består av en eller flera behörigheter till Rest-API:er för Azure Maps.

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 ha åtkomstkontroll för specifika API:er och omfång.

Anteckning

Den här säkerhetsdefinitionen x-ms-client-idkräver att huvudet används för att ange vilken Azure Maps-resurs programmet begär åtkomst till. Detta kan hämtas från MAPS-hanterings-API:et.
Authorization URL är specifikt för den offentliga Azure-molninstansen. Nationella moln har unika auktoriserings-URL:er och Microsoft Entra-ID-konfigurationer.
Rollbaserad åtkomstkontroll i Azure konfigureras från Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
Användning av Azure Maps Web SDK möjliggör konfigurationsbaserad konfiguration av ett program för flera användningsfall.
Mer information om Microsofts identitetsplattform finns i Översikt över Microsofts identitetsplattform.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Det här är en delad nyckel som etableras när du skapar en Azure Maps-resurs via Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.

Med den här nyckeln har alla program behörighet att komma åt alla REST-API:er. Med andra ord kan dessa för närvarande behandlas som huvudnycklar till det konto som de har utfärdats för.

För offentligt exponerade program rekommenderar vi att du använder server-till-server-åtkomst för Rest-API:er för Azure Maps där den här nyckeln kan lagras på ett säkert sätt.

Typ: apiKey
I: header

SAS Token

Det här är en signaturtoken för delad åtkomst som skapas från åtgärden List SAS på Azure Maps-resursen via Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.

Med den här token har alla program behörighet att komma åt med rollbaserade Åtkomstkontroller i Azure och detaljerad kontroll 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 säkrare sätt än den delade nyckeln.

För offentligt exponerade program rekommenderar vi att du konfigurerar en specifik lista över tillåtna ursprung på map-kontoresursen för att begränsa återgivningsmissbruket och regelbundet förnya SAS-token.

Typ: apiKey
I: header

Exempel

Search detail address 15127 NE 24th Street, Redmond, WA

Search detail address 15127 NE 24th Street, Redmond, WA by addressLine

Search detail address 15127 NE 24th Street, Redmond, WA by query

Search landmark Empire State Building by query

Search detail address 15127 NE 24th Street, Redmond, WA

Exempelbegäran

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01&addressLine=15127 NE 24th Street&adminDistrict=WA&locality=Redmond

Exempelsvar

Statuskod:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "High",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search detail address 15127 NE 24th Street, Redmond, WA by addressLine

Exempelbegäran

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01&addressLine=15127 NE 24th Street Redmond WA&countryRegion=US

Exempelsvar

Statuskod:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search detail address 15127 NE 24th Street, Redmond, WA by query

Exempelbegäran

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01&query=15127 NE 24th Street Redmond WA

Exempelsvar

Statuskod:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "High",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Search landmark Empire State Building by query

Exempelbegäran

HTTP

GET https://atlas.microsoft.com/geocode?api-version=2023-06-01&query=empire state building

Exempelsvar

Statuskod:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "NY"
            }
          ],
          "formattedAddress": "Empire State Building, NY",
          "locality": "New York"
        },
        "type": "PointOfInterest",
        "confidence": "High",
        "matchCodes": [
          "Ambiguous"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -73.98580932617188,
                40.748435974121094
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -73.98580932617188,
          40.748435974121094
        ]
      },
      "bbox": [
        -73.98590850830078,
        40.74833679199219,
        -73.98571014404297,
        40.74853515625
      ]
    },
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "NY"
            },
            {
              "shortName": "New York County"
            }
          ],
          "formattedAddress": "Empire State Building, NY",
          "locality": "Manhattan"
        },
        "type": "LandmarkBuilding",
        "confidence": "High",
        "matchCodes": [
          "Ambiguous"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -73.98500061035156,
                40.74815368652344
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -73.98500061035156,
          40.74815368652344
        ]
      },
      "bbox": [
        -73.98710632324219,
        40.747314453125,
        -73.98412322998047,
        40.74958038330078
      ]
    }
  ]
}

Definitioner

Name	Description
Address	Resultatets adress
AdminDistricts	Underindelningsnamnet i landet eller regionen för en adress. Det här elementet behandlas vanligtvis som den administrativa underindelningen i första ordningen, men i vissa fall innehåller det också den andra, tredje eller fjärde ordningens underindelning i ett land, beroende eller en region.
CalculationMethodEnum	Den metod som användes för att beräkna geokodpunkten.
ConfidenceEnum	Konfidensnivån för resultatet av den geokodade platsen är en matchning. Använd det här värdet med matchningskoden för att fastställa mer fullständig information om matchningen. Konfidensen för en geokodad plats baseras på många faktorer, inklusive den relativa betydelsen av den geokodade platsen och användarens plats, om det anges.
CountryRegion
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
FeatureCollectionEnum	Typen av ett FeatureCollection-objekt måste vara FeatureCollection.
FeaturesItem
FeatureTypeEnum	Typen av funktion måste vara Funktion.
GeocodePoints	En samling geokodpunkter som skiljer sig åt i hur de beräknades och deras föreslagna användning.
GeocodingResponse	Det här objektet returneras från ett lyckat geokodningsanrop
GeoJsonPoint	En giltig `GeoJSON Point` geometrityp. Mer information finns i RFC 7946 .
Intersection	Resultatets adress.
MatchCodesEnum	Ett eller flera matchningskodvärden som representerar geokodningsnivån för varje plats i svaret. Till exempel innebär en geokodad plats med matchningskoder `Good` och `Ambiguous` att mer än en geokodsplats hittades för platsinformationen och att geokodtjänsten inte hade någon sökning uppåt-hierarki för att hitta en matchning. På samma sätt innebär en geokodad plats med matchningskoder `Ambiguous` och `UpHierarchy` att det inte gick att hitta en geokodplats som matchade all angiven platsinformation, så geokodtjänsten var tvungen att söka i upphierarkin och hitta flera matchningar på den nivån. Ett exempel på ett `Ambiguous` och-resultat `UpHierarchy` är när du anger fullständig adressinformation, men geokodstjänsten inte kan hitta en matchning för gatuadressen och i stället returnerar information för mer än ett RoadBlock-värde. Möjliga värden är: `Good`: Platsen har bara en matchning, eller så betraktas alla returnerade matcher som starka matchningar. En fråga för New York returnerar till exempel flera bra matchningar. `Ambiguous`: Platsen är en av en uppsättning möjliga matchningar. När du till exempel frågar efter gatuadressen 128 Main St., kan svaret returnera två platser för 128 North Main St. och 128 South Main St. eftersom det inte finns tillräckligt med information för att avgöra vilket alternativ som ska väljas. `UpHierarchy`: Platsen representerar en flyttning uppåt i den geografiska hierarkin. Detta inträffar när en matchning för platsbegäran inte hittades, så ett mindre exakt resultat returneras. Om det till exempel inte går att hitta en matchning för den begärda adressen kan en matchningskod `UpHierarchy` för med en RoadBlock-entitetstyp returneras.
Properties
UsageTypeEnum	Den bästa användningen för geokodpunkten. Varje geokodpunkt definieras som en `Route` punkt, en `Display` punkt eller båda. Använd `Route` punkter om du skapar en väg till platsen. Använd `Display` punkter om du visar platsen på en karta. Om platsen till exempel är en park kan en `Route` punkt ange en ingång till parken där du kan komma in med en bil, och en `Display` punkt kan vara en punkt som anger mitten av parken.

Address

Resultatets adress

Name	Typ	Description
addressLine	string	AddressLine som innehåller gatunamn och nummer
adminDistricts	AdminDistricts[]	Indelningsnamnet i landet eller regionen för en adress. Det här elementet behandlas vanligtvis som den administrativa underindelningen i första ordningen, men i vissa fall innehåller det även den andra, tredje eller fjärde ordningens indelning i ett land, beroende eller en region.
countryRegion	CountryRegion
formattedAddress	string	Egenskapen Formaterad adress
intersection	Intersection	Resultatets adress.
locality	string	locality-egenskap
neighborhood	string	grannskapsegenskap
postalCode	string	Postnummeregenskap

AdminDistricts

Underindelningsnamnet i landet eller regionen för en adress. Det här elementet behandlas vanligtvis som den administrativa underindelningen i första ordningen, men i vissa fall innehåller det också den andra, tredje eller fjärde ordningens underindelning i ett land, beroende eller en region.

Name	Typ	Description
name	string	Namnet på motsvarande adminDistrict-fält, För adminDistrict[0], kan detta vara fullständigt namn på delstaten, till exempel Washington, For adminDistrict[1], detta kan vara det fullständiga namnet på länet
shortName	string	Det korta namnet för motsvarande adminDistrict-fält, För adminDistrict[0], kan detta vara ett kort namn på tillståndet, till exempel WA, For adminDistrict[1], detta kan vara det korta namnet på länet

CalculationMethodEnum

Den metod som användes för att beräkna geokodpunkten.

Name	Typ	Description
Interpolation	string	Geokodpunkten matchades till en punkt på en väg med hjälp av interpolation.
InterpolationOffset	string	Geokodpunkten matchades till en punkt på en väg med hjälp av interpolation med ytterligare en förskjutning för att flytta punkten till sidan av gatan.
Parcel	string	Geokodpunkten matchades i mitten av ett paket.
Rooftop	string	Geokodpunkten matchades mot taket i en byggnad.

ConfidenceEnum

Konfidensnivån för resultatet av den geokodade platsen är en matchning. Använd det här värdet med matchningskoden för att fastställa mer fullständig information om matchningen.

Konfidensen för en geokodad plats baseras på många faktorer, inklusive den relativa betydelsen av den geokodade platsen och användarens plats, om det anges.

Name Typ Description

High

Name	Typ	Description
High	string	Om konfidensen är inställd på `High`hittades en eller flera starka matchningar. Flera konfidensmatchningar `High` sorteras i rangordnad ordning efter prioritet när det är tillämpligt. Landmärken har till exempel betydelse men adresser har inte det. Om en begäran innehåller en plats eller en vy kan rangordningen ändras på lämpligt sätt. En platsfråga för "Paris" returnerar till exempel "Paris, Frankrike" och "Paris, TX" båda med `High` konfidens. "Paris, Frankrike" rankas alltid först på grund av betydelse om inte en användarplats anger att användaren befinner sig i eller mycket nära Paris, TX eller kartvyn anger att användaren söker i det området.
Low	string
Medium	string	I vissa situationer kanske den returnerade matchningen inte är på samma nivå som informationen i begäran. En begäran kan till exempel ange adressinformation och geokodstjänsten kanske bara kan matcha ett postnummer. I det här fallet, om geokodtjänsten har förtroende för att postnumret matchar data, är konfidensen inställd på `Medium` och matchningskoden är inställd `UpHierarchy` på att ange att den inte kunde matcha all information och var tvungen att söka upp-hierarkin. Om platsinformationen i frågan är tvetydig och det inte finns någon ytterligare information för att rangordna platserna (till exempel användarplats eller platsens relativa betydelse) anges konfidensen till `Medium`. En platsfråga för "148th Ave, Bellevue" kan till exempel returnera "148th Ave SE" och "148th Ave NE" båda med `Medium` konfidens. Om platsinformationen i frågan inte ger tillräckligt med information för att geokoda en specifik plats kan ett mindre exakt platsvärde returneras och konfidensen anges till `Medium`. Om en adress till exempel anges, men ingen matchning hittas för husnumret, kan geokodresultatet med en vägblocksentitetstyp returneras.

string

Om konfidensen är inställd på Highhittades en eller flera starka matchningar. Flera konfidensmatchningar High sorteras i rangordnad ordning efter prioritet när det är tillämpligt. Landmärken har till exempel betydelse men adresser har inte det.

Om en begäran innehåller en plats eller en vy kan rangordningen ändras på lämpligt sätt. En platsfråga för "Paris" returnerar till exempel "Paris, Frankrike" och "Paris, TX" båda med High konfidens. "Paris, Frankrike" rankas alltid först på grund av betydelse om inte en användarplats anger att användaren befinner sig i eller mycket nära Paris, TX eller kartvyn anger att användaren söker i det området.

Low

string

Medium

string

I vissa situationer kanske den returnerade matchningen inte är på samma nivå som informationen i begäran. En begäran kan till exempel ange adressinformation och geokodstjänsten kanske bara kan matcha ett postnummer. I det här fallet, om geokodtjänsten har förtroende för att postnumret matchar data, är konfidensen inställd på Medium och matchningskoden är inställd UpHierarchy på att ange att den inte kunde matcha all information och var tvungen att söka upp-hierarkin.

Om platsinformationen i frågan är tvetydig och det inte finns någon ytterligare information för att rangordna platserna (till exempel användarplats eller platsens relativa betydelse) anges konfidensen till Medium. En platsfråga för "148th Ave, Bellevue" kan till exempel returnera "148th Ave SE" och "148th Ave NE" båda med Medium konfidens.

Om platsinformationen i frågan inte ger tillräckligt med information för att geokoda en specifik plats kan ett mindre exakt platsvärde returneras och konfidensen anges till Medium. Om en adress till exempel anges, men ingen matchning hittas för husnumret, kan geokodresultatet med en vägblocksentitetstyp returneras.

CountryRegion

Name	Typ	Description
ISO	string	ISO för land/region
name	string	namn på land/region

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

FeatureCollectionEnum

Typen av ett FeatureCollection-objekt måste vara FeatureCollection.

Name	Typ	Description
FeatureCollection	string

FeaturesItem

Name	Typ	Description
bbox	number[]	Markeringsramen. Projektion används – EPSG:3857. Mer information finns i RFC 7946 .
geometry	GeoJsonPoint	En giltig `GeoJSON Point` geometrityp. Mer information finns i RFC 7946 .
id	string	ID för funktionen som returneras
properties	Properties
type	FeatureTypeEnum	Typen av funktion måste vara Funktion.

FeatureTypeEnum

Typen av funktion måste vara Funktion.

Name	Typ	Description
Feature	string

GeocodePoints

En samling geokodpunkter som skiljer sig åt i hur de beräknades och deras föreslagna användning.

Name	Typ	Description
calculationMethod	CalculationMethodEnum	Den metod som användes för att beräkna geokodpunkten.
geometry	GeoJsonPoint	En giltig `GeoJSON Point` geometrityp. Mer information finns i RFC 7946 .
usageTypes	UsageTypeEnum[]	Den bästa användningen för geokodpunkten. Varje geokodpunkt definieras som en `Route` punkt, en `Display` punkt eller båda. Använd `Route` punkter om du skapar en väg till platsen. Använd `Display` punkter om du visar platsen på en karta. Om platsen till exempel är en park kan en `Route` punkt ange en ingång till parken där du kan komma in med en bil, och en `Display` punkt kan vara en punkt som anger mitten av parken.

GeocodingResponse

Det här objektet returneras från ett lyckat geokodningsanrop

Name	Typ	Description
features	FeaturesItem[]
nextLink	string	är länken till nästa sida i de funktioner som returneras. Om det är den sista sidan, nej det här fältet.
type	FeatureCollectionEnum	Typen av ett FeatureCollection-objekt måste vara FeatureCollection.

GeoJsonPoint

En giltig GeoJSON Point geometrityp. Mer information finns i RFC 7946 .

Name	Typ	Description
bbox	number[]	Markeringsramen. Projektion används – EPSG:3857. Mer information finns i RFC 7946 .
coordinates	number[]	A `Position` är en matris med tal med två eller flera element. De två första elementen är longitud och latitud, exakt i den ordningen. Höjd/höjd är ett valfritt tredje element. Mer information finns i RFC 7946 .
type	string: Point	Anger `GeoJSON` typen . Måste vara en av de nio giltiga GeoJSON-objekttyperna – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature och FeatureCollection.

Intersection

Resultatets adress.

Name	Typ	Description
baseStreet	string	Primär gata för platsen.
displayName	string	Fullständigt namn på skärningspunkten.
intersectionType	string	Typ av skärningspunkt.
secondaryStreet1	string	Den första korsande gatan.
secondaryStreet2	string	Om någon, den andra korsar gatan.

MatchCodesEnum

Ett eller flera matchningskodvärden som representerar geokodningsnivån för varje plats i svaret.

Till exempel innebär en geokodad plats med matchningskoder Good och Ambiguous att mer än en geokodsplats hittades för platsinformationen och att geokodtjänsten inte hade någon sökning uppåt-hierarki för att hitta en matchning.

På samma sätt innebär en geokodad plats med matchningskoder Ambiguous och UpHierarchy att det inte gick att hitta en geokodplats som matchade all angiven platsinformation, så geokodtjänsten var tvungen att söka i upphierarkin och hitta flera matchningar på den nivån. Ett exempel på ett Ambiguous och-resultat UpHierarchy är när du anger fullständig adressinformation, men geokodstjänsten inte kan hitta en matchning för gatuadressen och i stället returnerar information för mer än ett RoadBlock-värde.

Möjliga värden är:

Good: Platsen har bara en matchning, eller så betraktas alla returnerade matcher som starka matchningar. En fråga för New York returnerar till exempel flera bra matchningar.

Ambiguous: Platsen är en av en uppsättning möjliga matchningar. När du till exempel frågar efter gatuadressen 128 Main St., kan svaret returnera två platser för 128 North Main St. och 128 South Main St. eftersom det inte finns tillräckligt med information för att avgöra vilket alternativ som ska väljas.

UpHierarchy: Platsen representerar en flyttning uppåt i den geografiska hierarkin. Detta inträffar när en matchning för platsbegäran inte hittades, så ett mindre exakt resultat returneras. Om det till exempel inte går att hitta en matchning för den begärda adressen kan en matchningskod UpHierarchy för med en RoadBlock-entitetstyp returneras.

Name	Typ	Description
Ambiguous	string
Good	string
UpHierarchy	string

Properties

Name	Typ	Description
address	Address	Resultatets adress
confidence	ConfidenceEnum	Konfidensnivån för resultatet av den geokodade platsen är en matchning. Använd det här värdet med matchningskoden för att fastställa mer fullständig information om matchningen. Konfidensen för en geokodad plats baseras på många faktorer, inklusive den relativa betydelsen av den geokodade platsen och användarens plats, om det anges.
geocodePoints	GeocodePoints[]	En samling geokodningspunkter som skiljer sig åt i hur de beräknades och deras föreslagna användning.
matchCodes	MatchCodesEnum[]	Ett eller flera matchningskodvärden som representerar geokodningsnivån för varje plats i svaret. Till exempel innebär en geokodad plats med matchningskoder `Good` och `Ambiguous` att mer än en geokodsplats hittades för platsinformationen och att geokodtjänsten inte hade någon sökning uppåt-hierarki för att hitta en matchning. På samma sätt innebär en geokodad plats med matchningskoder `Ambiguous` och `UpHierarchy` att det inte gick att hitta en geokodplats som matchade all angiven platsinformation, så geokodtjänsten var tvungen att söka i upphierarkin och hitta flera matchningar på den nivån. Ett exempel på ett `Ambiguous` och-resultat `UpHierarchy` är när du anger fullständig adressinformation, men geokodstjänsten inte kan hitta en matchning för gatuadressen och i stället returnerar information för mer än ett RoadBlock-värde. Möjliga värden är: `Good`: Platsen har bara en matchning, eller så betraktas alla returnerade matcher som starka matchningar. En fråga för New York returnerar till exempel flera bra matchningar. `Ambiguous`: Platsen är en av en uppsättning möjliga matchningar. När du till exempel frågar efter gatuadressen 128 Main St., kan svaret returnera två platser för 128 North Main St. och 128 South Main St. eftersom det inte finns tillräckligt med information för att avgöra vilket alternativ som ska väljas. `UpHierarchy`: Platsen representerar en flyttning uppåt i den geografiska hierarkin. Detta inträffar när en matchning för platsbegäran inte hittades, så ett mindre exakt resultat returneras. Om det till exempel inte går att hitta en matchning för den begärda adressen kan en matchningskod `UpHierarchy` för med en RoadBlock-entitetstyp returneras.
type	string	Något av: Adress Vägspärr RoadIntersection Grannskap PopulatedPlace Postkod1 AdminDivision1 AdminDivision2 CountryRegion

UsageTypeEnum

Den bästa användningen för geokodpunkten. Varje geokodpunkt definieras som en Route punkt, en Display punkt eller båda. Använd Route punkter om du skapar en väg till platsen. Använd Display punkter om du visar platsen på en karta. Om platsen till exempel är en park kan en Route punkt ange en ingång till parken där du kan komma in med en bil, och en Display punkt kan vara en punkt som anger mitten av parken.

Name	Typ	Description
Display	string
Route	string

Dela via

Search - Get Geocoding

URI-parametrar

Begärandehuvud

Svar

Säkerhet

AADToken

Omfattningar

subscription-key

SAS Token

Exempel

Search detail address 15127 NE 24th Street, Redmond, WA

Exempelbegäran

Exempelsvar

Search detail address 15127 NE 24th Street, Redmond, WA by addressLine

Exempelbegäran

Exempelsvar

Search detail address 15127 NE 24th Street, Redmond, WA by query

Exempelbegäran

Exempelsvar

Search landmark Empire State Building by query

Exempelbegäran

Exempelsvar

Definitioner

Address

AdminDistricts

CalculationMethodEnum

ConfidenceEnum

CountryRegion

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureCollectionEnum

FeaturesItem

FeatureTypeEnum

GeocodePoints

GeocodingResponse

GeoJsonPoint

Intersection

MatchCodesEnum

Properties

UsageTypeEnum

Ytterligare resurser