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à.
Aggiungi geofence con Amazon Location
I geofence contengono punti e vertici che formano un confine chiuso, che definisce un'area di interesse. Le collezioni Geofence archiviano e gestiscono uno o più geofence.
Le raccolte di geofence di Amazon Location archiviano le geofence definite utilizzando un formato di dati geospaziali standard chiamato Geo (7946). JSON RFC Puoi utilizzare strumenti come geojson.io gratuitamente per disegnare graficamente i geofence e salvare il file Geo di output. JSON
Amazon Location non supporta poligoni con fori, multipoligoni, poligoni in senso orario e geofence che attraversano l'antimeridiano.
Crea una raccolta di geofence
Crea una raccolta di geofence per archiviare e gestire i geofence utilizzando la console Amazon Location, AWS CLI o Amazon Location. APIs
- Console
-
Per creare una raccolta di geofence utilizzando la console Amazon Location
-
Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.
-
Nel riquadro di navigazione a sinistra, scegli Collezioni Geofence.
-
Scegli Crea collezione geofence.
-
Compila le seguenti caselle:
-
Nome: inserisci un nome univoco. Ad esempio, ExampleGeofenceCollection. Massimo 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini, punti e caratteri di sottolineatura.
-
Descrizione: inserisci una descrizione opzionale per differenziare le tue risorse.
-
In base a EventBridge rule with CloudWatch as a target, puoi creare una EventBridge regola opzionale per iniziare a reagire agli eventi di geofence. Ciò consente ad Amazon Location di pubblicare eventi su Amazon CloudWatch Logs.
-
(Facoltativo) In Tag, immettere Key (Chiave) e Value (Valore) di un tag. Questo aggiunge un tag alla tua nuova collezione di geofence. Per ulteriori informazioni, consulta Etichetta le tue risorse di Amazon Location Service.
-
(Facoltativo) In Crittografia a chiave gestita dal cliente, puoi scegliere di aggiungere una chiave gestita dal cliente. Questo aggiunge una chiave simmetrica gestita dal cliente che puoi creare, possedere e gestire tramite la crittografia predefinita AWS di proprietà. Per ulteriori informazioni, consulta Crittografia dei dati inattivi.
-
Scegli Crea raccolta di geofence.
- API
-
Per creare una raccolta di geofence utilizzando Amazon Location APIs
Usa l'CreateGeofenceCollectionoperazione di Amazon Location GeofencesAPIs.
L'esempio seguente utilizza una API richiesta per creare una raccolta di geofence chiamata ExampleGeofenceCollection. La raccolta di geofence è associata a una AWS KMS chiave gestita dal cliente per crittografare i dati dei clienti.
POST /geofencing/v0/collections
Content-type: application/json
{
"CollectionName": "ExampleGeofenceCollection",
"Description": "Geofence collection 1 for shopping center",
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"Tags": {
"Tag1" : "Value1"
}
}
- AWS CLI
-
Per creare una raccolta di geofence utilizzando i comandi AWS CLI
Utilizza il comando create-geofence-collection.
L'esempio seguente utilizza un AWS CLI per creare una raccolta di geofence chiamata ExampleGeofenceCollection. La raccolta di geofence è associata a una AWS KMS chiave gestita dal cliente per crittografare i dati dei clienti.
aws location \
create-geofence-collection \
--collection-name "ExampleGeofenceCollection1234abcd-12ab-34cd-56ef-1234567890ab" \
--tags Tag1=Value1
La fatturazione dipende dall'utilizzo. Potresti incorrere in commissioni per l'uso di altri servizi. AWS
Per ulteriori informazioni, consulta i prezzi di Amazon Location Service.
Disegna geofence
Ora che hai creato la tua collezione di geofence, puoi definire i tuoi geofence. I geofence sono definiti come poligono o come cerchio. Per disegnare un geofence poligonale puoi usare uno strumento di modifica geografica, come geojson.io. JSON
Per creare un geofence come cerchio, è necessario definire il punto centrale del cerchio e il raggio. Ad esempio, se si desidera creare un geofence per ricevere una notifica ogni volta che un dispositivo si trova a 50 metri da una posizione specifica, è necessario utilizzare la latitudine e la longitudine di tale posizione e specificare il raggio di 50 metri.
Utilizzando Amazon Location ServiceAPIs, puoi anche aggiungere metadati al tuo geofence, sotto forma di coppie chiave-valore. Questi possono essere utili per archiviare informazioni sul geofence, ad esempio il tipo, o altre informazioni specifiche dell'applicazione. Puoi utilizzare questi metadati quando. Reagire agli eventi di Amazon Location Service con Amazon EventBridge
Aggiungere geofence poligonali
Questa sezione descrive la creazione di geofence poligonali
Disegna geofence usando uno strumento Geo JSON
Ora che hai creato la tua collezione di geofence, puoi definire i tuoi geofence utilizzando uno strumento di modifica Geo, come geojson.io. JSON
Per JSON creare un file Geo
-
Apri uno strumento di JSON modifica geografica. Ad esempio, geojson.io.
-
Scegli l'icona Disegna un poligono e disegna la tua area di interesse.
-
Scegli Salva, quindi scegli Geo JSON dal menu a discesa.
Inserisci geofence Geo in una raccolta JSON di geofence
Puoi utilizzare il JSON file Geo risultante per caricare i tuoi geofence utilizzando la console Amazon Location Service, o Amazon Location: AWS CLI APIs
- Console
-
Per aggiungere un geofence a una raccolta di geofence utilizzando la console Amazon Location Service
-
Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.
-
Nel riquadro di navigazione a sinistra, scegli Collezioni Geofence.
-
Dall'elenco delle raccolte Geofence, seleziona il link del nome per la raccolta di geofence di destinazione.
-
In Geofences, scegli Crea geofences.
-
Nella finestra Aggiungi geofence, trascina e rilascia il tuo Geo nella finestra. JSON
-
Scegli Aggiungi geofence.
- API
-
Per aggiungere geofence utilizzando Amazon Location APIs
Usa l'PutGeofenceoperazione di Amazon Location GeofencesAPIs.
L'esempio seguente utilizza una API richiesta per aggiungere un geofence dato l'ID GEOFENCE-EXAMPLE1 a una collezione di geofence chiamata ExampleGeofenceCollection. Inoltre, specifica una singola proprietà dei metadati del geofence con la chiave e il valore. Type loadingArea
PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE1
Content-type: application/json
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
In alternativa, è possibile aggiungere più di un geofence utilizzando l'operazione. BatchPutGeofence
POST /geofencing/v0/collections/ExampleGeofenceCollection/put-geofences
Content-type: application/json
{
"Entries": [
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"GeofenceId": "GEOFENCE-EXAMPLE1",
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
]
}
- AWS CLI
-
Per aggiungere un geofence a una raccolta di geofence utilizzando i comandi AWS CLI
Utilizza il comando put-geofence.
L'esempio seguente utilizza an AWS CLI per aggiungere un geofence a una raccolta di geofence chiamata ExampleGeofenceCollection.
$ aws location \
put-geofence \
--collection-name ExampleGeofenceCollection \
--geofence-id ExampleGeofenceTriangle \
--geofence-properties '{"Type": "loadingArea"}' \
--geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'
{
"CreateTime": "2020-11-11T00:16:14.487000+00:00",
"GeofenceId": "ExampleGeofenceTriangle",
"UpdateTime": "2020-11-11T00:19:59.894000+00:00"
}
Aggiungere geofence circolari
Questa sezione descrive la creazione di geofence circolari. È necessario conoscere la latitudine e la longitudine del punto in cui si desidera che sia il centro del cerchio e il raggio in metri del cerchio. Puoi creare geofence circolari con Amazon Location APIs o il. AWS CLI
- API
-
Per aggiungere geofence circolari utilizzando Amazon Location APIs
Usa l'PutGeofenceoperazione di Amazon Location GeofencesAPIs.
L'esempio seguente utilizza una API richiesta per aggiungere un geofence dato l'ID GEOFENCE-EXAMPLE2 a una collezione di geofence chiamata ExampleGeofenceCollection:
PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE2
Content-type: application/json
{
"Geometry": {
"Circle": {
"Center": [-5.716667, -15.933333],
"Radius": 50
}
}
}
- AWS CLI
-
Per aggiungere un geofence circolare a una raccolta di geofence utilizzando i comandi AWS CLI
Utilizza il comando put-geofence.
L'esempio seguente utilizza an AWS CLI per aggiungere un geofence a una raccolta di geofence chiamata ExampleGeofenceCollection.
$ aws location \
put-geofence \
--collection-name ExampleGeofenceCollection \
--geofence-id ExampleGeofenceCircle \
--geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
È inoltre possibile inserire JSON una geometria complessa in un file separato, come nell'esempio seguente.
$ aws location \
put-geofence \
--collection-name ExampleGeofenceCollection \
--geofence-id ExampleGeofenceCircle \
--geometry file:circle.json
Nell'esempio, il file circle.json include JSON la geometria del cerchio.
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
