View a markdown version of this page

Aggiungi geofence con Amazon Location - Servizio di posizione Amazon
Creazione di una collezione di recinzioni geografiche virtuali.Disegna geofenceAggiungi geofence poligonaliAggiungi geofence circolari

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 GeoJSON (RFC 7946). Puoi utilizzare strumenti, come geojson.io, gratuitamente per disegnare graficamente i tuoi geofence e salvare il file GeoJSON di output.

Nota

Amazon Location non supporta i poligoni in senso orario (usa l'ordine di avvolgimento in senso antiorario come richiesto dalla RFC 7946 §3.1.6) e le geofence che attraversano l'antimeridiano (la linea di longitudine di 180°).

Creazione di una collezione di recinzioni geografiche virtuali.

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

  1. Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.

  2. Nel riquadro di navigazione a sinistra, scegli Collezioni Geofence.

  3. Scegli Crea collezione geofence.

  4. 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.

  5. 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.

  6. (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 Gestire le risorse con i tag.

  7. (Facoltativo) In Crittografia a chiave gestita dal cliente, puoi scegliere di aggiungere una chiave gestita dal cliente. In questo modo viene aggiunta 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.

  8. 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 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 "ExampleGeofenceCollection" \
  --description "Shopping center geofence collection" \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
  --tags Tag1=Value1
Nota

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 circolare, definisci il punto centrale utilizzando la latitudine e la longitudine della posizione e imposta il raggio in metri. Per ulteriori informazioni, consulta Aggiungi geofence circolari.

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. Reagisci agli eventi di Amazon Location Service con Amazon EventBridge

Aggiungi geofence poligonali

I geofence poligonali utilizzano gli array di coordinate GeoJSON per definire un'area. Utilizzate questo formato quando è necessario tenere traccia delle entrate o delle uscite da un confine geografico di forma irregolare.

Disegna geofence usando uno strumento GeoJSON

Per creare un file GeoJSON

  1. Apri uno strumento di modifica GeoJSON, come geojson.io.

  2. Scegli l'icona Disegna un poligono e disegna la tua area di interesse.

  3. 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 Amazon Location.

Console
Per aggiungere un geofence a una raccolta di geofence utilizzando la console Amazon Location Service

  1. Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.

  2. Nel riquadro di navigazione a sinistra, scegli Collezioni Geofence.

  3. Dall'elenco delle raccolte Geofence, seleziona il link del nome per la raccolta di geofence di destinazione.

  4. In Geofences, scegli Crea geofences.

  5. Nella finestra Aggiungi geofences, trascina e rilascia il tuo GeoJSON nella finestra.

  6. 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 proprietà dei metadati del geofence con la chiave e il valore. Type loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/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 il 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]]]'

Aggiungi geofence circolari

Per creare un geofence circolare, è necessario conoscere la latitudine e la longitudine del punto centrale e il raggio in metri. Utilizza i geofence circolari quando devi attivare eventi in base alla vicinanza a un punto specifico, come un negozio, un magazzino o un punto di riferimento. Puoi creare geofence circolari con la console Amazon Location, le API di Amazon Location o il. AWS CLI

Console
Per aggiungere un geofence circolare a una raccolta di geofence utilizzando la console Amazon Location Service

  1. Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.

  2. Nel riquadro di navigazione a sinistra, scegli Collezioni Geofence.

  3. Dall'elenco delle raccolte Geofence, seleziona il link del nome per la raccolta di geofence di destinazione.

  4. In Geofences, scegli Crea geofences.

  5. Nella finestra Aggiungi geofence, scegli Cerchio, quindi inserisci la latitudine centrale, la longitudine e il raggio in metri.

  6. Scegli Aggiungi geofence.

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/geofences/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 il AWS CLI per aggiungere un geofence circolare 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}'
Nota

È inoltre possibile inserire JSON per geometrie complesse in un file separato, come nell'esempio seguente.

aws location \
    put-geofence \
        --collection-name ExampleGeofenceCollection \
        --geofence-id ExampleGeofenceCircle \
        --geometry file://circle.json

Dove circle.json contiene la geometria del cerchio.

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}