Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ubicazione SDK e librerie Amazon

Amazon Location SDK è un insieme di librerie open source che forniscono funzionalità utili per lo sviluppo di applicazioni Amazon Location. Sono incluse le seguenti funzionalità:

Come iniziare a utilizzare Amazon Location SDK

Amazon Location SDK è un insieme di funzioni che possono semplificare l'utilizzo di Amazon Location Service in un'applicazione. Puoi installare e importare queste funzioni nella tua JavaScript applicazione. Le seguenti sezioni descrivono il client Amazon Location e le librerie di autenticazione e Geo JSON helper.

Client di localizzazione Amazon

Con AWS SDKv3, SDK è separato per servizio. Puoi installare solo le parti di cui hai bisogno. Ad esempio, per installare il client Amazon Location e il provider di credenziali per Amazon Cognito, utilizza i seguenti comandi.

npm install @aws-sdk/client-location
npm install @aws-sdk/credential-providers

Per facilitare l'utilizzo di Amazon Location Service nelle applicazioni JavaScript web frontend, AWS fornisce un pacchetto ospitato della libreria Amazon Location e del fornitore di credenziali. Per utilizzare il client in bundle, aggiungilo al tuo tag HTML in uno script, come segue:

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

JavaScript Aiutante di autenticazione

L'helper di JavaScript autenticazione Amazon Location semplifica l'autenticazione quando effettui API chiamate Amazon Location dalla tua applicazione. JavaScript Questo assistente di autenticazione ti aiuta specificamente a utilizzare Amazon Cognito APIo le chiavi come metodo di autenticazione. Questa è una libreria open source disponibile su GitHub, qui: https://github.com/aws-geospatial/ amazon-location-utilities-auth -helper-js.

Installazione

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

Importa

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

import { withIdentityPoolId } from '@aws/amazon-location-utilities-auth-helper';

Funzioni di autenticazione

Gli helper di autenticazione di Amazon Location includono le seguenti funzioni che restituiscono un AuthHelper oggetto:

L'AuthHelperoggetto fornisce le seguenti funzioni:

Esempio: inizializzazione di un oggetto MapLibre mappa con Amazon Cognito, utilizzando un AuthHelper

import { withIdentityPoolId } from '@aws/amazon-location-utilities-auth-helper';

const authHelper = await withIdentityPoolId("identity-pool-id"); // use Cognito pool id for credentials

const map = new maplibregl.Map({
    container: "map", // HTML element ID of map element
    center: [-123.1187, 49.2819], // initial map center point
    zoom: 16, // initial map zoom
    style: https://maps.geo.region.amazonaws.com/maps/v0/maps/mapName/style-descriptor', // Defines the appearance of the map
    ...authHelper.getMapAuthenticationOptions(), // Provides credential options required for requests to Amazon Location
});

Esempio: inizializzazione dell'oggetto della MapLibre mappa con una API chiave (in questo caso non AuthHelper è necessaria)

const map = new maplibregl.Map({
    container: "map", // HTML element ID of map element
    center: [-123.1187, 49.2819], // initial map center point
    zoom: 16, // initial map zoom
    style: https://maps.geo.region.amazonaws.com/maps/v0/maps/${mapName}/style-descriptor?key=api-key-id',
});

Esempio: inizializza il client Location dal AWS SDKper JS, utilizzando Amazon Cognito e AuthHelper

Questo esempio utilizza AWS SDKper JavaScript v3.

import { withIdentityPoolId } from '@aws/amazon-location-utilities-auth-helper';

const authHelper = await withIdentityPoolId("identity-pool-id"); // use Cognito pool id for credentials

//initialize the Location client:
const client = new LocationClient({
    region: "region",
    ...authHelper.getLocationClientConfig() // sets up the Location client to use the Cognito pool defined above
});

//call a search function with the location client:
const result = await client.send(new SearchPlaceIndexForPositionCommand({
    IndexName: "place-index", // Place index resource to use
    Position: [-123.1187, 49.2819], // position to search near
    MaxResults: 10 // number of results to return
});

Esempio: inizializza il client Location dal AWS SDKper JS, utilizzando una API chiave e AuthHelper

Questo esempio utilizza AWS SDKper JavaScript v3.

import { withAPIKey } from '@aws/amazon-location-utilities-auth-helper';

const authHelper = await withAPIKey("api-key-id"); // use API Key id for credentials

//initialize the Location client:
const client = new LocationClient({
    region: "region",
    ...authHelper.getLocationClientConfig() // sets up the Location client to use the API Key defined above
});

//call a search function with the location client:
const result = await client.send(new SearchPlaceIndexForPositionCommand({
    IndexName: "place-index", // Place index resource to use
    Position: [-123.1187, 49.2819], // position to search near
    MaxResults: 10 // number of results to return
});

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.

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:

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

Questo esempio utilizza AWS SDKper 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",
    },
});

Autenticazione mobile Android SDK

Queste utilità ti aiutano ad autenticarti quando effettui API chiamate Amazon Location Service dalle tue applicazioni Android. Ciò è particolarmente utile quando si utilizza Amazon Cognito o APIle chiavi come metodo di autenticazione.

L'autenticazione mobile Android SDK è disponibile su github: Amazon Location Service Mobile Authentication SDK per Android. Inoltre, sia l'autenticazione SDK mobile che il AWS SDKsono disponibili su AWS repository Maven.

Installazione

Per utilizzare l'autenticazione mobileSDK, aggiungi le seguenti istruzioni di importazione al tuo build.gradle file in Android Studio.

implementation("software.amazon.location:auth:0.0.1")
implementation("com.amazonaws:aws-android-sdk-location:2.72.0")

Funzioni di autenticazione

L'helper di autenticazione SDK ha le seguenti funzioni:

Utilizzo

Per utilizzarlo SDK nel codice, importa le seguenti classi:

import com.amazonaws.services.geo.AmazonLocationClient
import software.amazon.location.auth.AuthHelper
import software.amazon.location.auth.LocationCredentialsProvider

Hai due opzioni per creare l'helper di autenticazione e le istanze del provider di client di localizzazione. Puoi creare un'istanza utilizzando APIle chiavi di localizzazione Amazon o Amazon Cognito.

Puoi creare un'istanza client Amazon Location utilizzando il provider di credenziali di posizione ed effettuare chiamate al servizio Amazon Location. L'esempio seguente cerca luoghi vicini a una latitudine e una longitudine specificate.

var locationClient = authHelper.getLocationClient(locationCredentialsProvider.getCredentialsProvider())
var searchPlaceIndexForPositionRequest = SearchPlaceIndexForPositionRequest().withIndexName("My-Place-Index-Name").withPosition(arrayListOf(30.405423, -97.718833))
var nearbyPlaces = locationClient.searchPlaceIndexForPosition(searchPlaceIndexForPositionRequest)

Autenticazione mobile iOS SDK

Queste utilità ti aiutano ad autenticarti quando effettui API chiamate Amazon Location Service dalle tue applicazioni iOS. Ciò è particolarmente utile quando si utilizza Amazon Cognito o APIle chiavi come metodo di autenticazione.

L'autenticazione mobile iOS SDK è disponibile su github: Amazon Location Service Mobile Authentication per SDK iOS.

Installazione

Installala SDK in un progetto Xcode:

Funzioni di autenticazione

L'helper di autenticazione SDK ha le seguenti funzioni:

Utilizzo

Per utilizzare l'autenticazione mobileSDK, aggiungi le seguenti istruzioni alla tua attività:

import AmazonLocationiOSAuthSDK
import AWSLocationXCF

Hai due opzioni per creare l'helper di autenticazione e le istanze del provider di client di localizzazione. Puoi creare un'istanza utilizzando APIle chiavi di localizzazione Amazon o Amazon Cognito.

Puoi creare un'istanza client Amazon Location utilizzando il provider di credenziali di posizione ed effettuare chiamate al servizio Amazon Location. L'esempio seguente cerca luoghi vicini a una latitudine e una longitudine specificate.

let locationClient = AWSLocation.default()
let searchPlaceIndexForPositionRequest = AWSLocationSearchPlaceIndexForPositionRequest()!
searchPlaceIndexForPositionRequest.indexName = "My-Place-Index-Name"
searchPlaceIndexForPositionRequest.position = [30.405423, -97.718833]
let nearbyPlaces = locationClient.searchPlaceIndex(forPosition: searchPlaceIndexForPositionRequest)

Monitoraggio per dispositivi mobili Android SDK

Il tracciamento mobile di Amazon Location SDK fornisce utilità che aiutano a autenticare, acquisire facilmente le posizioni dei dispositivi e inviare aggiornamenti di posizione ad Amazon Location Tracker. SDKSupporta il filtraggio locale degli aggiornamenti di posizione con intervalli di aggiornamento configurabili. Ciò riduce i costi dei dati e ottimizza la connettività intermittente per le applicazioni Android.

Il tracciamento Android SDK è disponibile su GitHub: Amazon Location Mobile Tracking SDK per Android. Inoltre, sia l'autenticazione mobile SDK che il AWS SDKsono disponibili su AWS repository Maven. Il tracciamento Android SDK è progettato per funzionare con il sistema generale AWS SDK.

Questa sezione tratta i seguenti argomenti per il tracciamento mobile Android di Amazon LocationSDK:

Installazione

Per installareSDK, aggiungi le seguenti righe alla sezione delle dipendenze del tuo file build.gradle in Android Studio:

implementation("software.amazon.location:tracking:0.0.1")
implementation("software.amazon.location:auth:0.0.1")
implementation("com.amazonaws:aws-android-sdk-location:2.72.0")

Utilizzo

Questa procedura mostra come utilizzare il per autenticare e SDK creare l'oggetto: LocationTracker

Filtri

Amazon Location Mobile Tracking Android SDK ha tre filtri di posizione integrati.

Questo esempio aggiunge filtri in LocationTracker al momento della creazione:

val config = LocationTrackerConfig(
    trackerName = "MY-TRACKER-NAME",
    logLevel = TrackingSdkLogLevel.DEBUG,
    accuracy = Priority.PRIORITY_HIGH_ACCURACY,
    latency = 1000,
    frequency = 5000,
    waitForAccurateLocation = false,
    minUpdateIntervalMillis = 5000,
    locationFilters = mutableListOf(TimeLocationFilter(), DistanceLocationFilter(), AccuracyLocationFilter())
)
locationTracker = LocationTracker(
    applicationContext,
    locationCredentialsProvider,
    config,
)

Questo esempio abilita e disabilita il filtro in fase di esecuzione conLocationTracker:

// To enable the filter
locationTracker?.enableFilter(TimeLocationFilter())

// To disable the filter
locationTracker?.disableFilter(TimeLocationFilter())

Funzioni di SDK tracciamento per dispositivi mobili Android

Il tracciamento mobile Amazon Location SDK per Android include le seguenti funzioni:

Esempi

Il seguente esempio di codice mostra la SDK funzionalità di tracciamento mobile.

Questo esempio utilizza LocationTracker per avviare e interrompere il tracciamento in background:

// For starting the location tracking
locationTracker?.startBackground(
BackgroundTrackingMode.ACTIVE_TRACKING,
object : ServiceCallback {
    override fun serviceStopped() {
        if (selectedTrackingMode == BackgroundTrackingMode.ACTIVE_TRACKING) {
            isLocationTrackingBackgroundActive = false
        } else {
            isLocationTrackingBatteryOptimizeActive = false
        }
    }
},
)

// For stopping the location tracking
locationTracker?.stopBackgroundService()

Monitoraggio mobile iOS SDK

Il tracciamento mobile di Amazon Location SDK fornisce utilità che aiutano a autenticare, acquisire facilmente le posizioni dei dispositivi e inviare aggiornamenti di posizione ad Amazon Location Tracker. SDKSupporta il filtraggio locale degli aggiornamenti di posizione con intervalli di aggiornamento configurabili. Ciò riduce i costi dei dati e ottimizza la connettività intermittente per le applicazioni iOS.

Il tracciamento iOS SDK è disponibile su GitHub: Amazon Location Mobile Tracking SDK per iOS.

Questa sezione tratta i seguenti argomenti per il tracciamento mobile di Amazon Location iOSSDK:

Installazione

Utilizza la seguente procedura per installare il tracciamento mobile SDK per iOS:

Utilizzo

La procedura seguente mostra come creare un helper di autenticazione utilizzando le credenziali di Cognito.

Filtri

Il tracciamento mobile di Amazon Location iOS SDK ha tre filtri di posizione integrati.

Questo esempio aggiunge filtri in LocationTracker al momento della creazione:

val config = LocationTrackerConfig(
    trackerName = "MY-TRACKER-NAME",
    logLevel = TrackingSdkLogLevel.DEBUG,
    accuracy = Priority.PRIORITY_HIGH_ACCURACY,
    latency = 1000,
    frequency = 5000,
    waitForAccurateLocation = false,
    minUpdateIntervalMillis = 5000,
    locationFilters = mutableListOf(TimeLocationFilter(), DistanceLocationFilter(), AccuracyLocationFilter())
)

locationTracker = LocationTracker(
    applicationContext,
    locationCredentialsProvider,
    config,
)

Questo esempio abilita e disabilita il filtro in fase di esecuzione conLocationTracker:

// To enable the filter
locationTracker?.enableFilter(TimeLocationFilter())

// To disable the filter
locationTracker?.disableFilter(TimeLocationFilter())

Funzioni di SDK tracciamento mobile iOS

Il tracciamento mobile di Amazon Location SDK per iOS include le seguenti funzioni:

Esempi

Questa sezione descrive alcuni esempi di utilizzo di Amazon Location Mobile Tracking SDK per iOS.

L'esempio seguente illustra la funzionalità per il tracciamento della posizione del dispositivo e il recupero delle posizioni tracciate:

Privacy - Location When In Use Usage Description
Privacy - Location Always and When In Use Usage Description

Inizia a tracciare la posizione:

do {
    try locationTracker.startTracking()
    } 
catch TrackingLocationError.permissionDenied {
        // Handle permissionDenied by showing the alert message or opening the app settings
        }

Riprendi a tracciare la posizione:

do { 
    try locationTracker.resumeTracking()
    } 
catch TrackingLocationError.permissionDenied {
    // Handle permissionDenied by showing the alert message or opening the app settings
    }

Smetti di tracciare la posizione:

locationTracker.stopTracking()

Inizia il tracciamento in background:

do {
    locationTracker.startBackgroundTracking(mode: .Active) // .Active, .BatterySaving, .None
    } 
catch TrackingLocationError.permissionDenied {
   // Handle permissionDenied by showing the alert message or opening the app settings
   }

Riprendi il tracciamento in background:

do {
    locationTracker.resumeBackgroundTracking(mode: .Active)
    } 
catch TrackingLocationError.permissionDenied {
    // Handle permissionDenied by showing the alert message or opening the app settings
    }

Per interrompere il tracciamento in background:

locationTracker.stopBackgroundTracking()

Recupera le posizioni tracciate del dispositivo dal tracker:

func getTrackingPoints(nextToken: String? = nil) {
let startTime: Date = Date().addingTimeInterval(-86400) // Yesterday's day date and time
let endTime: Date = Date() 
locationTracker.getTrackerDeviceLocation(nextToken: nextToken, startTime: startTime, endTime: endTime, completion: { [weak self] result in
    switch result {
    case .success(let response):
        
        let positions = response.devicePositions
        // You can draw positions on map or use it further as per your requirement

        // If nextToken is available, recursively call to get more data
        if let nextToken = response.nextToken {
            self?.getTrackingPoints(nextToken: nextToken)
        }
    case .failure(let error):
        print(error)
    }
})
}