Aiutanti per la conversione geografica JSON

Gli helper di JSON conversione di Amazon Location Geo forniscono strumenti per convertire i tipi di dati di Amazon Location Service da e verso il formato Geo standard del settore. JSON Geo JSON viene utilizzato, ad esempio, per visualizzare dati geografici sulla mappa MapLibre . Questa è una libreria open source disponibile su GitHub, qui: https://github.com/aws-geospatial/amazon-location-utilities-datatypes-js.

Installazione

Puoi usare le librerie con un'installazione locale, come webpack, o includendo JavaScript pacchetti predefiniti con <script> tag nel tuo html.

• Usa il seguente comando per installare la libreria, usando. NPM

  npm install @aws/amazon-location-utilities-datatypes

• Utilizzate il seguente comando nel HTML file per caricare lo script:

  <script src="https://unpkg.com/@aws/amazon-location-utilities-datatypes@1.x/dist/amazonLocationDataConverter.js"></script>

Importa

Per utilizzare una funzione specifica nell' JavaScript applicazione, è necessario importare tale funzione. Il codice seguente viene utilizzato per importare la funzione placeToFeatureCollection nell'applicazione.

import { placeToFeatureCollection } from '@aws/amazon-location-utilities-datatypes';

Funzioni di JSON conversione geografica

Gli helper di JSON conversione Amazon Location Geo includono le seguenti funzioni:

• placeToFeatureCollection(place: GetPlaceResponse | searchPlaceIndexForPositionResponse | searchPlaceIndexForTextResponse, keepNull: boolean): Feature— Questa funzione converte le risposte dalle funzioni di ricerca dei luoghi in un Geo JSON FeatureCollection con 1 o più funzioni Point.

• devicePositionToFeatureCollection(devicePositions: GetDevicePositionResponse | BatchGetDevicePositionResponse | GetDevicePositionHistoryResponse | ListDevicePositionsResponse, keepNull: boolean)— Questa funzione converte le risposte dalle funzioni di posizione del dispositivo tracker in un Geo JSON FeatureCollection con 1 o più funzioni Point.

• routeToFeatureCollection(legs: CalculateRouteResponse): FeatureCollection— Questa funzione converte le risposte dalla funzione di calcolo del percorso in una Geo con una singola JSON FeatureCollection funzione. MultiStringLine Ogni tappa del percorso è rappresentata da una LineString voce in. MultiStringLine

• geofenceToFeatureCollection(geofences: GetGeofenceResponse | PutGeofenceRequest | BatchPutGeofenceRequest | ListGeofencesResponse): FeatureCollection— Questa funzione converte la richiesta o la risposta delle funzioni di geofence in una funzione Geo JSON FeatureCollection con funzionalità Polygon. Può convertire i geofence sia nella risposta che nella richiesta, consentendoti di mostrare i geofence su una mappa prima di caricarli con or. PutGeofence BatchPutGeofence

  Questa funzione convertirà un geofence circolare in un elemento con un poligono approssimato, ma avrà anche le proprietà «centro» e «raggio» per ricreare il geofence circolare, se necessario (vedere la funzione successiva).

• featureCollectionToGeofences(featureCollection: FeatureCollection): BatchPutGeofenceRequestEntry[]— Questa funzione converte un oggetto Geo JSON FeatureCollection con caratteristiche Polygon in una serie di BatchPutGeofenceRequestEntry oggetti, in modo che il risultato possa essere utilizzato per creare una richiesta per. BatchPutGeofence

  Se una Feature in FeatureCollection ha le proprietà «centro» e «raggio», verrà convertita in una voce di richiesta di geofence circolare, ignorando la geometria del poligono.

Esempio: converti i risultati della ricerca in un livello di punti in MapLibre

Questo esempio utilizza AWS SDK for JavaScript v3.

import { placeToFeatureCollection } from '@aws/amazon-location-utility-datatypes';

...

let map; // map here is an initialized MapLibre instance

const client = new LocationClient(config);
const input = { your_input };
const command = new searchPlaceIndexForTextCommand(input);
const response = await client.send(command);

// calling utility function to convert the response to GeoJSON
const featureCollection = placeToFeatureCollection(response);
map.addSource("search-result", featureCollection);
map.addLayer({
    id: "search-result",
    type: "circle",
    source: "search-result",
    paint: {
        "circle-radius": 6,
        "circle-color": "#B42222",
    },
});