Azure Maps JavaScript ügyfélkódtár keresése – 1.0.0-beta.2-es verzió

/TypeScript

A Azure Maps Search Service restful API-k készlete, amelyek segítségével a fejlesztők név, kategória és egyéb földrajzi adatok alapján kereshetnek címeket, helyeket és üzleti hirdetéseket. A hagyományos geokódolás támogatása mellett a szolgáltatások a földrajzi címeket és a földrajzi szélességek és hosszúságok alapján megfordíthatják a földrajzi címeket és az utcákat. A keresés által visszaadott szélességi és hosszúsági értékek más Azure Maps szolgáltatásokban, például az Útvonal- és időjárás-szolgáltatásokban is használhatók paraméterekként.

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben egyaránt fut) Azure Maps Search-ügyfélhez.

Forráskód | Csomag (NPM) | Minták | Termékinformációk

Első lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

Előfeltételek

• Egy Azure-előfizetés.
• Egy Azure Maps fiók. Az erőforrást az Azure Portalon, a Azure PowerShell vagy az Azure CLI-vel hozhatja létre.

Ha az Azure CLI-t használja, cserélje le <resource-group-name> és <map-account-name> válassza ki a megfelelő tarifacsomagot az igényeinek megfelelően a <sku-name> paraméteren keresztül. További részletekért tekintse meg ezt a lapot .

az maps account create --resource-group <resource-group-name> --name <map-account-name> --sku <sku-name>

Telepítse a(z) @azure/maps-search csomagot

Telepítse a Azure Maps Search ügyfélkódtárat a következővelnpm:

npm install @azure/maps-search

Hozzon létre és hitelesítsen egy MapsSearchClient

Ha létre szeretne hozni egy ügyfélobjektumot a Azure Maps Keresési API-k eléréséhez, szüksége lesz egy credential objektumra. A Azure Maps Search-ügyfél azure Active Directory-hitelesítő adatokat vagy Azure Key-hitelesítő adatokat használhat a hitelesítéshez.

Azure Active Directory hitelesítő adatok használata

Az Azure Active Directoryval az Azure Identity-kódtár használatával végezhet hitelesítést. Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK-hoz biztosított egyéb hitelesítőadat-szolgáltatók használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett regisztrálnia kell egy új AAD-alkalmazást, és hozzáférést kell biztosítania a Azure Maps, ha hozzárendeli a megfelelő szerepkört a szolgáltatásnévhez. Tekintse meg a Hitelesítés kezelése oldalt.

Állítsa be az AAD-alkalmazás ügyfélazonosítójának, bérlőazonosítójának és titkos ügyfélkulcsának értékeit környezeti változókként: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

A használni kívánt Azure Maps erőforrást is meg kell adnia az clientId ügyfélbeállítások között. Az Azure Maps erőforrás ügyfél-azonosítója a Azure Maps erőforrás Hitelesítési szakaszaiban található. Tekintse meg a dokumentációt , amelyből megtudhatja, hogyan keresheti meg.

const { MapsSearchClient } = require("@azure/maps-search");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();
const client = new MapsSearchClient(credential, "<maps-account-client-id>");

Előfizetési kulcs hitelesítő adatainak használata

A hitelesítést a Azure Maps előfizetési kulcsával végezheti el.

const { MapsSearchClient, AzureKeyCredential } = require("@azure/maps-search");

const credential = new AzureKeyCredential("<subscription-key>");
const client = new MapsSearchClient(credential);

Fő fogalmak

MapsSearchClient

MapsSearchClienta Azure Maps Search ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az elérhető Azure Maps Search szolgáltatás különböző funkcióinak megismeréséhez.

Példák

A következő szakaszok számos kódrészletet biztosítanak, amelyek a leggyakoribb Azure Maps keresési feladatokat tartalmazzák, beleértve a következőket:

• Cím szélességi és hosszúsági koordinátáinak kérése
• Cím vagy érdeklődési pont keresése
• Fordított cím keresése a koordináta helyének utcacímre való fordításához
• A koordináta helyének lefordítása emberi, érthető keresztutcává

Cím szélességi és hosszúsági koordinátáinak kérése

Hitelesített ügyfél használatával szélességi és hosszúsági koordinátákká alakíthatja a címeket. Ezt a folyamatot geokódolásnak is nevezik. A koordináták visszaadása mellett a válasz olyan részletes címtulajdonságokat is visszaad, mint az utca, az irányítószám, az önkormányzat és az ország/régió adatai.

const searchResult = await client.searchAddress("400 Broad, Seattle");
for (const {
  position: { lat, lon },
} of searchResult.results) {
  console.log(`Latitude: ${lat}, Longitude: ${lon}`);
}

Cím vagy érdeklődési pont keresése

A Fuzzy Search használatával kereshet egy címet vagy egy érdekes pontot (POI). Az alábbi példa bemutatja, hogyan kereshet pizza egy adott ország hatókörében (Franceebben a példában).

const fuzzySearchResult = await client.fuzzySearch({ query: "pizza", countryCodeFilter: ["fr"] });
for (const result of fuzzySearchResult.results) {
  console.log(result);
}

Fordított cím keresése a koordináta helyének utcacímre való fordításához

A koordinátákat lefordíthatja emberi olvasható utcacímekké. Ezt a folyamatot fordított geokódolásnak is nevezik. Ezt gyakran használják GPS-hírcsatornákat használó alkalmazásokhoz, és adott koordinátapontokon szeretnének címeket felderíteni.

const coordinates: LatLon = [47.59118, -122.3327]; // [latitude, longitude]

const { addresses } = await client.reverseSearchAddress(coordinates);
for (const { address } of addresses) {
  console.log(address);
}

A koordináta helyének lefordítása emberi, érthető keresztutcává

Lefordíthatja a koordináta helyét egy emberi, érthető keresztutcába a Search Address Reverse Cross Street API használatával. Ez leggyakrabban olyan alkalmazások nyomon követéséhez szükséges, amelyek GPS-csatornát kapnak egy eszközről vagy eszközről, és tudni szeretnék, hol található a koordináta.

const coordinates: LatLon = [47.59118, -122.3327];

const { addresses } = await client.reverseSearchCrossStreetAddress(coordinates);
for (const { address } of addresses) {
  console.log(address);
}

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintakönyvtárat.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Kapcsolódó projektek

• JavaScripthez készült Microsoft Azure SDK