Az Azure Maps Search szolgáltatás ajánlott eljárásai
Az Azure Maps Search szolgáltatás olyan API-t tartalmaz, amely különböző képességeket kínál a fejlesztőknek a címek, helyek, üzleti listák név vagy kategória szerinti keresésében, valamint egyéb földrajzi információk keresésében. A Search Fuzzy például lehetővé teszi, hogy a felhasználók címeket vagy érdeklődési pontot (POI) keressenek.
Ez a cikk bemutatja, hogyan alkalmazhat hangalapú eljárásokat az Azure Maps Search szolgáltatás adatainak hívása során. A következőket fogja megtanulni:
- Lekérdezések létrehozása a releváns egyezések visszaadásához
- Keresési eredmények korlátozása
- Az eredménytípusok közötti különbségek megismerése
- A címkeresési válasz struktúrájának olvasása
Előfeltételek
Bármely API-fejlesztési környezet, például a Postman vagy a Bruno használatával futtathatja a cikkben bemutatott HTTP-kérésmintákat, vagy REST-hívásokat hozhat létre.
Ajánlott eljárások a címek geokódolásához
Ha teljes vagy részleges címet keres az Azure Maps Search szolgáltatás használatával, az API beolvassa a kulcsszavakat a keresési lekérdezésből. Ezután visszaadja a cím hosszúsági és szélességi koordinátáit. Ezt a folyamatot geokódolásnak nevezzük.
Az ország/régió geokódolásának képessége az útadatok rendelkezésre állásától és a geokódolási szolgáltatás pontosságától függ. Az Azure Maps geokódolási képességeiről országonként vagy régiónként további információt a Geokódolási lefedettség című témakörben talál.
Keresési eredmények korlátozása
Az Azure Maps Search API segíthet a keresési eredmények megfelelő korlátozásában. Korlátozhatja az eredményeket, hogy releváns adatokat jelenítsen meg a felhasználók számára.
Feljegyzés
A keresési API-k több paramétert támogatnak, mint azokat, amelyeket ez a cikk tárgyal.
Földrajzilag formázott keresési eredmények
Ha a felhasználó számára a megfelelő területre szeretne geobiás eredményeket adni, mindig adja hozzá a lehető legtöbb helyadatokat. Bizonyos bemeneti típusok megadásával korlátozhatja a keresési eredményeket:
Állítsa be a paramétert
countrySet.US,FRBeállíthatja például. Alapértelmezés szerint az API az egész világon keres, így szükségtelen eredményeket adhat vissza. Ha a lekérdezésnek nincscountrySetparamétere, akkor a keresés pontatlan eredményeket adhat vissza. Egy Bellevue nevű város keresése például az USA-ból és Franciaországból származó eredményeket ad vissza, mivel mindkét ország/régió tartalmaz egy Bellevue nevű várost.A határolókeret és a
btmRighttopleftparaméterek használatával beállíthatja a határolókeretet. Ezek a paraméterek a térkép egy adott területére korlátozzák a keresést.Az eredmények relevanciájának befolyásolásához határozza meg és
lonkoordinálja alatparamétereket. A paraméter használatávalradiusállítsa be a keresési terület sugarát.
Homályos keresési paraméterek
Javasoljuk, hogy akkor használja a Search Fuzzyt , ha nem ismeri a keresési lekérdezés felhasználói bemeneteit. A felhasználótól érkező bemenet lehet például egy cím vagy az érdeklődési pont típusa (POI), például a bevásárlóközpont. Az API a POI-keresést és a geokódolást egy canonikus egysoros keresésben egyesíti:
A
minFuzzyLevelparaméterek ésmaxFuzzyLevela paraméterek akkor is segítenek a releváns egyezések visszaadásában, ha a lekérdezési paraméterek nem felelnek meg pontosan a felhasználó által kívánt információknak. A teljesítmény maximalizálása és a szokatlan eredmények csökkentése érdekében állítsa be a keresési lekérdezéseket az alapértelmezett értékreminFuzzyLevel=1ésmaxFuzzyLevel=2a .Ha például a
maxFuzzyLevelparaméter 2 értékre van állítva, a keresési kifejezés restrant értéke megegyezik az étteremkel. Szükség esetén felülbírálhatja az alapértelmezett homályos szinteket.A paraméter használatával
idxSetrangsorolhatja az eredménytípusok pontos készletét. A pontos eredmények rangsorolásához elküldheti az indexek vesszővel tagolt listáját. A listában az elem sorrendje nem számít. Az Azure Maps a következő indexeket támogatja:Addr- Címtartományok: Az utca elejétől és végétől interpolált címpontok. Ezek a pontok címtartományként jelennek meg.Geo- Földrajzi területek: A föld közigazgatási felosztása. A földrajzi hely lehet például ország/régió, állam vagy város.PAD- Pontcímek: Utcanevet és számot tartalmazó címek. A pontcímek egy indexben találhatók. Ilyen például a Soquel Dr 2501. A pontcímek a címekhez elérhető legmagasabb szintű pontosságot biztosítják.POI- Érdekes pontok: Olyan pontok a térképen, amelyeket érdemesnek tartanak, vagy amelyek érdekesek lehetnek. A keresési cím nem ad vissza POI-kat.Str- Utcák: Utcák a térképen.XStr- Keresztutcák vagy kereszteződések: Kereszteződések vagy helyek, ahol két utca metszi egymást.
Felhasználási példák
idxSet=POI- Csak poi-k keresése.idxSet=PAD,Addr- Csak a keresési címek.PADjelzi a pont címét, ésAddra címtartományt.
Földrajzi entitástípus fordított geokódja és szűrése
Ha fordított geokódkeresést végez a keresési cím megfordítása használatával, a szolgáltatás sokszögeket adhat vissza a felügyeleti területekhez. Előfordulhat például, hogy be szeretné kérni egy város terület sokszögét. A keresés adott földrajzi entitástípusokra való szűkítéséhez adja meg a paramétert a entityType kérésekben.
Az eredményként kapott válasz tartalmazza a földrajzi azonosítót és a megfelelt entitástípust. Ha egynél több entitást ad meg, akkor a végpont a legkisebb elérhető entitást adja vissza. A visszaadott geometriai azonosítóval lekérheti a földrajz geometriája a Keresés sokszög szolgáltatáson keresztül.
Mintakérelem
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
Válasz
{
"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"
}
]
}
Az eredmények nyelvének beállítása
A paraméter használatával language állítsa be a visszaadott keresési eredmények nyelvét. Ha a kérés nem állítja be a nyelvet, akkor alapértelmezés szerint Search szolgáltatás az ország vagy régió leggyakoribb nyelvét használja. Ha a megadott nyelven nem áll rendelkezésre adat, a rendszer az alapértelmezett nyelvet használja.
További információkért tekintse meg az Azure Maps által támogatott nyelveket.
Prediktív mód használata (automatikus javaslatok)
Ha további egyezéseket szeretne keresni a részleges lekérdezésekhez, állítsa a paramétert a typeahead következőre true: . Ez a lekérdezés részleges bemenetként van értelmezve, és a keresés prediktív módot ad meg. Ha nem állítja be a typeahead paramétert true, akkor a szolgáltatás feltételezi, hogy az összes releváns információ be lett adva.
A következő minta lekérdezésben a Keresési cím szolgáltatás lekérdezi a Microso-t. Itt a paraméter a typeahead következőre truevan állítva: . A válasz azt mutatja, hogy a keresési szolgáltatás részleges lekérdezésként értelmezte a lekérdezést. A válasz egy automatikusan javasolt lekérdezés eredményeit tartalmazza.
Mintalekérdezés
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
Válasz
{
"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
}
}
}
]
}
URI kódolása speciális karakterek kezeléséhez
A kereszt utcacímek megkereséséhez kódolnia kell az URI-t a cím speciális karaktereinek kezeléséhez. Vegyük például ezt a címet: 1st Avenue &Union Street, Seattle. Itt kódolja az erősítőt és a karaktert (&) a kérés elküldése előtt.
Javasoljuk, hogy kódolja a karakteradatokat egy URI-ban. Az URI-ban az összes karaktert százalékjel (%) és a karakterek UTF-8 kódjának megfelelő két karakteres hexadecimális érték használatával kódolhatja.
Felhasználási példák
Kezdje a következő címmel:
query=1st Avenue & E 111th St, New York
Kódolja a címet:
query=1st%20Avenue%20%26%20E%20111th%20St%2C%20New%20York
A következő módszereket használhatja.
JavaScript vagy TypeScript:
encodeURIComponent(query)
C# vagy 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)
Gyors:
query.stringByAddingPercentEncodingWithAllowedCharacters(.URLHostAllowedCharacterSet())
Megy:
import ("net/url")
url.QueryEscape(query)
Ajánlott eljárások a POI-kereséshez
A POI-keresésekben név szerint kérheti le a POI-találatokat. Például név alapján kereshet egy vállalkozást.
Határozottan javasoljuk, hogy a paraméter használatával adja meg azokat az countrySet országokat/régiókat, ahol az alkalmazásnak lefedettségre van szüksége. Az alapértelmezett viselkedés az egész világon való keresés. Ez a széles körű keresés szükségtelen eredményeket adhat vissza, és a keresés hosszú időt vehet igénybe.
Márkakeresés
Az eredmények és a válaszban szereplő információk relevanciájának javítása érdekében a POI keresési válasza márkainformációkat tartalmaz. Ezekkel az információkkal tovább elemezheti a választ.
Egy kérelemben elküldheti a márkanevek vesszővel tagolt listáját. A listával a paraméter beállításával korlátozhatja az eredményeket adott brandSet márkákra. A listában az elemek sorrendje nem számít. Ha több márkalistát ad meg, a visszaadott eredményeknek legalább az egyik listához kell tartoznia.
A márkakeresés megismeréséhez hozzunk létre egy POI-kategóriás keresési kérést. Az alábbi példában a washingtoni Redmondban található Microsoft-campus közelében található benzinkutakat keressük. A válasz az egyes visszaadott POI-k márkainformációit jeleníti meg.
Mintalekérdezés
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
Válasz
{
"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
}
}
]
}
]
}
Repülőtéri keresés
A Search POI API használatával a hivatalos kódjukkal kereshet repülőtereket. A SEA segítségével például megtalálhatja a Seattle-Tacoma nemzetközi repülőteret:
https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=SEA
Közeli keresés
Ha egy adott helyen szeretné lekérni a POI-eredményeket, próbálkozzon a Közeli keresés funkcióval. A végpont csak POI-eredményeket ad vissza. Nem veszi fel a keresési lekérdezési paramétert.
Az eredmények korlátozásához javasoljuk, hogy állítsa be a sugárt.
A válaszok ismertetése
Keressen egy címet Seattle-ben egy címkeresési kéréssel az Azure Maps Search szolgáltatás. A következő kérelem URL-címében a paramétert úgy countrySet állítjuk be, hogy US az USA-ban keressen a címre.
Mintalekérdezés
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
Támogatott találattípusok
Pontcím: Egy térkép azon pontjai, amelyek egy adott címmel rendelkeznek, utcanévvel és számmal. A pontcím a legmagasabb szintű pontosságot biztosítja a címekhez.
Címtartomány: Az utca elejétől és végétől interpolált címpontok tartománya.
Földrajzi hely: A térképen lévő területek, amelyek egy adott terület közigazgatási felosztását jelölik, például ország/régió, állam vagy város.
POI: Pontok a térképen, hogy érdemes figyelmet, és ez lehet érdekes.
Utca: Utcák a térképen. A címek a címet tartalmazó utca szélességi és hosszúsági koordinátáira vannak feloldva. Előfordulhat, hogy a házszám nem lesz feldolgozva.
Kereszt utca: Kereszteződések. A keresztutcák olyan kereszteződéseket jelölnek, ahol két utca keresztezi egymást.
Válasz
Nézzük meg a válasz struktúráját. Az alábbi válaszban az eredményobjektumok típusai eltérőek. Ha gondosan néz ki, háromféle eredményobjektum jelenik meg:
- Pont címe
- Utca
- Kereszt utca
Figyelje meg, hogy a címkeresés nem ad vissza POI-kat.
Az Score egyes válaszobjektumok paramétere azt jelzi, hogy az egyező pontszám hogyan viszonyul az ugyanabban a válaszban lévő többi objektum pontszámához. A válaszobjektum paramétereiről további információt a Keresési cím lekérése című témakörben talál.
{
"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
}
}
}
]
}
Geometria
A geometria választípusa tartalmazhatja az objektum geometry alatt dataSources és idalatta visszaadott geometriaazonosítót. A Keresés sokszög szolgáltatással például GeoJSON formátumban kérheti le a geometriai adatokat. Ezzel a formátummal egy entitáskészlet város- vagy repülőtérszerkezetét is lekérheti. Ezt követően a határadatok használatával geofence-t vagy keresési POI-kat állíthat be a geometrián belül.
A keresési címre vagy a keresési fuzzyra adott válaszok tartalmazhatják a következő objektumban dataSources geometry idvisszaadott geometriai azonosítót:
"dataSources": {
"geometry": {
"id": "00005557-4100-3c00-0000-000059690938" // The geometry ID is returned in the dataSources object under "geometry" and "id".
}
}
Következő lépések
További információ: