Osvědčené postupy pro službu Azure Mapy Search
Služba Azure Mapy Search obsahuje rozhraní API, která nabízejí různé možnosti, které vývojářům pomáhají vyhledávat adresy, místa, obchodní seznamy podle názvu nebo kategorie a další geografické informace. Například rozhraníAPI pro vyhledávání přibližných shod umožňuje uživatelům hledat adresu nebo bod zájmu (POI).
Tento článek vysvětluje, jak používat zvukové postupy při volání dat ze služby Azure Mapy Search. Dozvíte se, jak provést tyto akce:
- Vytváření dotazů pro vrácení relevantních shod
- Omezení výsledků hledání
- Informace o rozdílech mezi typy výsledků
- Čtení struktury adresy search-response
Požadavky
- Nastavení účtu azure Mapy
- Získejte primární klíč předplatného, označované také jako primární klíč nebo klíč předplatného.
V tomto článku se k vytváření volání REST používá aplikace Postman, ale můžete si vybrat libovolné vývojové prostředí API.
Osvědčené postupy pro adresy geografických kódů
Když pomocí služby Azure Mapy Search vyhledáte úplnou nebo částečnou adresu, rozhraní API načte klíčová slova z vyhledávacího dotazu. Pak vrátí souřadnice zeměpisné délky a šířky adresy. Tento proces se nazývá geocoding.
Schopnost geograficky kódovat v zemi nebo oblasti závisí na dostupnosti silničních dat a přesnosti služby geokódování. Další informace o možnostech geografické Mapy Azure v jednotlivých zemích nebo oblastech najdete v tématu Pokrytí geografických kódování.
Omezení výsledků hledání
Rozhraní API Mapy Search vám může pomoct vhodně omezit výsledky hledání. Omezíte výsledky tak, abyste uživatelům mohli zobrazovat relevantní data.
Poznámka
Vyhledávací rozhraní API podporují více parametrů než jen ty, které popisuje tento článek.
Geo zaujaté výsledky hledání
Pokud chcete geo zaujaté výsledky do příslušné oblasti pro uživatele, vždy přidejte co nejvíce podrobností o poloze. Můžete chtít omezit výsledky hledání zadáním některých typů vstupu:
Nastavte
countrySetparametr . Můžete ho nastavit napříkladUS,FRna . Ve výchozím nastavení rozhraní API prohledá celý svět, aby vrátilo zbytečné výsledky. Pokud váš dotaz nemácountrySetžádný parametr, může hledání vrátit nepřesné výsledky. Například hledání města s názvem Bellevue vrátí výsledky z USA a Francie, protože obě země/oblasti obsahují město s názvem Bellevue.K nastavení ohraničovacího rámečku můžete použít
btmRighttopleftparametry a . Tyto parametry omezují hledání na konkrétní oblast na mapě.Pokud chcete ovlivnit oblast relevance výsledků, definujte parametry
latlonsouřadnic a . Pomocíradiusparametru nastavte poloměr oblasti hledání.
Parametry vyhledávání přibližných shod
Pokud nevíte, jaké uživatelské vstupy pro vyhledávací dotaz zastupují vaše uživatelské vstupy, doporučujeme použít rozhraní API pro vyhledávání přibližných shod ve službě Azure Mapy Search. Například zadání od uživatele může být adresa nebo typ bodu zájmu (POI), jako je nákupní nákupní nákupní středisko. Rozhraní API kombinuje vyhledávání poi a geocoding do kanonického jedno řádkového vyhledávání:
Parametry a pomáhají vracet relevantní shody, i když parametry dotazu přesně neodpovídají
minFuzzyLevelmaxFuzzyLevelinformacím, které uživatel chce. Pokud chcete maximalizovat výkon a snížit neobvyklé výsledky, nastavte vyhledávací dotazy na výchozí hodnoty aminFuzzyLevel=1maxFuzzyLevel=2.Pokud je například parametr nastavený na hodnotu 2, hledaný
maxFuzzyLevelvýraz restrant se spáruje s restaurací. V případě potřeby můžete výchozí přibližné úrovně přepsat.Pomocí
idxSetparametru můžete určit prioritu přesné sady typů výsledků. Pokud chcete určit prioritu přesné sady výsledků, můžete odeslat seznam indexů oddělených čárkami. Na pořadí položek v seznamu nezáleží. Azure Mapy podporuje následující indexy:Addr- Rozsahy adres: Adresní body, které jsou interpolované od začátku a konce ulice. Tyto body jsou reprezentovány jako rozsahy adres.Geo- Zeměpisné oblasti: Administrativní divize půdy. Zeměpisná oblast může být například země/oblast, stát nebo město.PAD- Adresy bodů: Adresy, které obsahují název a číslo ulice. Adresy bodů najdete v indexu. Příkladem je So 2501 Dr. Adresa bodu poskytuje nejvyšší úroveň přesnosti dostupnou pro adresy.POI- Body zájmu: Body na mapě, které se považují za zajímavé nebo zajímavé. Rozhraní API pro hledané adresy nevrací poi.Str- Ulice: Ulice na mapě.XStr- Křížové ulice nebo průsečíky: Násečíky nebo místa, kde se dvě ulice protínají.
Příklady použití
idxSet=POI– Prohledávat pouze poi.idxSet=PAD,Addr– Prohledávat pouze adresy.PADoznačuje adresu bodu aAddrrozsah adres.
Reverzní geografický kód a filtr pro typ entity geografie
Když v rozhraní APIpro reverzní vyhledávání adres vyhledáte reverzní geografický kód, může služba vrátit mnohoúhelníky pro oblasti správy. Můžete například chtít načíst mnohoúhelník oblasti pro město. Pokud chcete hledání zúžit na konkrétní typy entit geografie, entityType zahrpište do svých požadavků parametr .
Výsledná odpověď obsahuje ID zeměpisné oblasti a odpovídající typ entity. Pokud poskytnete více než jednu entitu, koncový bod vrátí nejmenší dostupnou entitu. Vrácené ID geometrie můžete použít k získání geometrie geografie prostřednictvím služby Search Polygon.
Ukázkový požadavek
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
Odpověď
{
"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"
}
]
}
Nastavení jazyka výsledků
Pomocí language parametru nastavte jazyk pro vrácené výsledky hledání. Pokud požadavek jazyk nenastaví, služba Search Service ve výchozím nastavení používá nejběžnější jazyk v zemi nebo oblasti. Pokud v zadaném jazyce nejsou k dispozici žádná data, použije se výchozí jazyk.
Další informace najdete v tématu Azure Mapy podporovaných jazycích.
Použití prediktivního režimu (automatické návrhy)
Pokud chcete najít další shody pro částečné dotazy, nastavte typeahead parametr na true . Tento dotaz se interpretuje jako částečný vstup a hledání přestupuje do prediktivního režimu. Pokud parametr nezadáte na , pak služba předpokládá, že byly předány typeahead true všechny relevantní informace.
V následujícím ukázkovém dotazu se služba Search Address dotazuje na Microso. Tady je typeahead parametr nastavený na true . Odpověď ukazuje, že vyhledávací služba interpretuje dotaz jako částečný dotaz. Odpověď obsahuje výsledky pro automaticky navrhovaný dotaz.
Ukázkový dotaz
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
Odpověď
{
"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
}
}
}
]
}
Kódování identifikátoru URI pro zpracování speciálních znaků
Pokud chcete najít adresy napříč ulicemi, musíte kódovat identifikátor URI pro zpracování speciálních znaků v adrese. Vezměme si tento příklad adresy: 1st Avenue & Union Street, Seattle. Tady před odesláním požadavku zakódujte znak ampersandu ( & ).
Doporučujeme kódovat data znaků v identifikátoru URI. V identifikátoru URI kódujete všechny znaky pomocí znaku procenta ( ) a dvou znaků šestnáctkové hodnoty, která odpovídá kódu % UTF-8 znaků.
Příklady použití
Začněte touto adresou:
query=1st Avenue & E 111th St, New York
Zakódujte adresu:
query=1st%20Avenue%20%26%20E%20111th%20St%2C%20New%20York
Můžete použít následující metody.
JavaScript nebo TypeScript:
encodeURIComponent(query)
C# nebo 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())
Jít:
import ("net/url")
url.QueryEscape(query)
Osvědčené postupy pro vyhledávání POI
Ve vyhledávání POI si můžete vyžádat výsledky POI podle názvu. Můžete například vyhledat firmu podle názvu.
Důrazně doporučujeme použít parametr k určení zemí nebo oblastí, ve kterých countrySet vaše aplikace potřebuje pokrytí. Výchozím chováním je prohledávání celého světa. Toto rozsáhlé hledání může vracet zbytečné výsledky a hledání může trvat dlouhou dobu.
Vyhledávání značek
Aby se zlepšila relevanci výsledků a informací v odpovědi, odpověď na vyhledávání POI obsahuje informace o značce. Tyto informace můžete použít k další analýze odpovědi.
V požadavku můžete odeslat čárkami oddělený seznam názvů značek. Pomocí seznamu můžete omezit výsledky na konkrétní značky nastavením brandSet parametru . Na pořadí položek v seznamu nezáleží. Když zadáte více seznamů značek, vrácené výsledky musí patřit alespoň do jednoho z vašich seznamů.
Pokud chcete prozkoumat vyhledávání značek, vytvořte požadavek na vyhledávání kategorií POI. V následujícím příkladu se podíváme na čerpací stanice v blízkosti areálu Microsoftu v Redmondu ve Washingtonu. V odpovědi se zobrazí informace o značce pro každý vrácený poi.
Ukázkový dotaz
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
Odpověď
{
"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
}
}
]
}
]
}
Hledání na letišce
Pomocí rozhraní SEARCH POI API můžete hledat letiště pomocí jejich oficiálního kódu. Můžete například použít SEA k vyhledání mezinárodního Seattle-Tacoma:
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&query=SEA
Hledání v okolí
Pokud chcete načíst výsledky POI z konkrétního umístění, můžete zkusit použít rozhraní API pro vyhledávání v okolí. Koncový bod vrátí pouze výsledky poi. Nepřidá parametr vyhledávacího dotazu.
Pokud chcete omezit výsledky, doporučujeme nastavit poloměr.
Vysvětlení odpovědí
Pojďme najít adresu v Seattlu vytvořením požadavku na vyhledávání adres do služby Azure Mapy Search. V následující adrese URL požadavku nastavme parametr na , aby countrySet US hledal adresu v USA.
Ukázkový dotaz
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
Podporované typy výsledků
Point Address(Adresa bodu): Body na mapě, které mají konkrétní adresu s názvem a číslem ulice. Point Address (Adresa bodu) poskytuje nejvyšší úroveň přesnosti adres.
Rozsah adres: Rozsah adresního bodu, který je interpolovaný od začátku a konce ulice.
Zeměpisná oblast: Oblasti na mapě, které představují administrativní divize země, například země/oblast, stát nebo město.
POI: Body na mapě, které stojí za pozornost a které můžou být zajímavé.
Ulice: Ulice na mapě. Adresy jsou přeloženy na souřadnice zeměpisné šířky a délky ulice, která obsahuje adresu. Číslo domu nemusí být zpracováno.
Cross Street: Intersections(Křížové ulice): Intersections (Průniky). Křížové ulice představují smyšly, kde se protínají dvě ulice.
Odpověď
Pojďme se podívat na strukturu odpovědí. V následující odpovědi se liší typy výsledných objektů. Pokud se podíváte pečlivě, uvidíte tři typy objektů výsledků:
- Adresa bodu
- Ulice
- Cross Street
Všimněte si, že vyhledávání adres nevrací poi.
Parametr pro každý objekt odpovědi určuje, jak se odpovídající skóre vztahuje ke skóre jiných objektů Score ve stejné odpovědi. Další informace o parametrech objektu odpovědi najdete v tématu Získání adresy pro vyhledávání.
{
"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
}
}
}
]
}
Geometrie
Typ odpovědi Geometrie může zahrnovat ID geometrie vrácené v objektu v rámci a dataSources geometry id . Můžete například použít službu Mnohoúhelník vyhledávání a vyžádat si data geometrie ve formátu GeoJSON. Pomocí tohoto formátu můžete získat osnovu města nebo letiště pro sadu entit. Tato data hranic pak můžete použít k nastavení geografické geografické oblasti nebo prohledání poi uvnitř geometrie.
Odpovědi na rozhraní API pro vyhledávání adres nebo rozhraní API pro vyhledávání přibližných shod mohou zahrnovat ID geometrie vrácené v objektu pod a dataSources geometry id :
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-000059690938" // The geometry ID is returned in the dataSources object under "geometry" and "id".
}
}
Další kroky
Další informace najdete v tématu: