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
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 GeoJSON (RFC 7946). Puoi utilizzare strumenti, come geojson.io, gratuitamente per disegnare graficamente i tuoi geofence e salvare il file GeoJSON di output.
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 le API di Amazon Location.
- 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 Taggare le 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 le API di Amazon Location
Usa l'CreateGeofenceCollectionoperazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API 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 GeoJSON, come geojson.io.
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 le API di Amazon Location Service, 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 GeoJSON
Ora che hai creato la tua collezione di geofence, puoi definire i tuoi geofence utilizzando uno strumento di modifica GeoJSON, come geojson.io.
Per creare un file GeoJSON
-
Apri uno strumento di modifica GeoJSON. Ad esempio, geojson.io.
-
Scegli l'icona Disegna un poligono e disegna la tua area di interesse.
-
Scegli Salva, quindi scegli GeoJSON dal menu a discesa.
Inserisci geofence GeoJSON in una raccolta di geofence
Puoi utilizzare il file GeoJSON risultante per caricare i tuoi geofence utilizzando la console Amazon Location Service, o AWS CLI le API di localizzazione di Amazon:
- 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 geofences, trascina e rilascia il tuo GeoJSON nella finestra.
-
Scegli Aggiungi geofence.
- API
-
Per aggiungere geofence utilizzando le API di Amazon Location
Usa l'PutGeofenceoperazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API per aggiungere un geofence con l'ID GEOFENCE-EXAMPLE1 a una raccolta 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 le API di Amazon Location o il. AWS CLI
- API
-
Per aggiungere geofence circolari utilizzando le API di Amazon Location
Usa l'PutGeofenceoperazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API per aggiungere un geofence con l'ID GEOFENCE-EXAMPLE2 a una raccolta 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 per la 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 per la geometria del cerchio.
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
