Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Cómo agregar geovallas con Amazon Location Las geocercas contienen puntos y vértices que forman un límite cerrado que define un área de interés. Las colecciones de geocercas almacenan y administran una o varias geocercas. [Las colecciones de geocercas de Amazon Location almacenan geocercas definidas mediante un formato de datos geoespaciales estándar denominado GeoJSON (RFC 7946).](https://geojson.org/) Puede utilizar herramientas, como [geojson.io](http://geojson.io/), sin coste alguno para dibujar sus geocercas gráficamente y guardar el archivo GeoJSON de salida. **nota** Amazon Location no admite polígonos en el sentido de las agujas del reloj (utilice el orden de enrollamiento en sentido contrario a las agujas del reloj, tal como exige el [RFC 7946 § 3.1.6](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6)) ni geocercas que crucen el antimeridiano (la línea de longitud de 180°). **Topics** + [Creación de una colección de geovallas](#create-geofence-collection) + [Dibujar geocercas](#draw-geofences) + [Añada geocercas poligonales](#draw-polygon-geofences) + [Agregue geocercas circulares](#draw-circle-geofences) ## Creación de una colección de geovallas Cree una colección de geovallas para almacenar y gestionar geocercas mediante la consola de ubicación de Amazon, las AWS CLI o las API de ubicación de Amazon. ------ #### [ Console ] 1. Abre la consola de Amazon Location Service en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En el panel de navegación izquierdo, elija **Colecciones de geocercas**. 1. Seleccione **Crear colección de geocercas**. 1. Complete las casillas siguientes: + ****Nombre****: escriba un nombre único. Por ejemplo, {{ExampleGeofenceCollection}}. 100 caracteres como máximo. Entre las entradas válidas se incluyen caracteres alfanuméricos, guiones, puntos y guiones bajos. + ****Descripción****: introduzca una descripción opcional para diferenciar sus recursos. 1. En el **EventBridge caso de una regla con CloudWatch como objetivo**, puede crear una EventBridge regla opcional para empezar [a reaccionar ante los eventos de la geocerca.](location-events.md) Esto permite a Amazon Location publicar eventos en Amazon CloudWatch Logs. 1. (Opcional) En **Etiquetas**, escriba una **clave** y un **valor** de etiqueta. Esto añade una etiqueta a su nueva colección de geofence. Para obtener más información, consulte [Administrar recursos con etiquetas](manage-resources.md). 1. (Opcional) En **Cifrado de claves gestionadas por el cliente**, puede optar por **agregar una clave gestionada por el cliente**. Esto añade una clave simétrica gestionada por el cliente que usted crea, posee y administra a través del cifrado predeterminado propiedad de AWS . Para obtener más información, consulte [Cifrado de datos en reposo](encryption-at-rest.md). 1. Seleccione **Crear colección de geocercas**. ------ #### [ API ] Utilice la operación `[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)` desde las API de Amazon Location Geofences. En el siguiente ejemplo, se utiliza una solicitud de API para crear una colección de geovallas llamada {{ExampleGeofenceCollection}}. La colección de geofence está asociada a una [AWS KMS clave administrada por el cliente para cifrar los datos](encryption-at-rest.md) del cliente. ``` 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 ] Utilice el comando `[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)`. En el siguiente ejemplo, se utiliza AWS CLI para crear una colección de geocercas llamada. {{ExampleGeofenceCollection}} La colección de geocercas está asociada a una [AWS KMS clave administrada por el cliente para](encryption-at-rest.md) cifrar los datos del cliente. ``` 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 facturación depende del uso. Es posible que se le paguen tarifas por el uso de otros servicios. AWS Para obtener más información, consulte los [precios de Amazon Location Service](https://aws.amazon.com/location/pricing/). ## Dibujar geocercas Ahora que ha creado su colección de geocercas, puede definir sus geocercas. Las geocercas se definen como un polígono o un círculo. Para dibujar una geocerca poligonal, puede utilizar una herramienta de edición de GeoJSON, como [geojson.io](http://geojson.io/). Para crear una geocerca circular, defina el punto central utilizando la latitud y la longitud de la ubicación y establezca el radio en metros. Para obtener más información, consulte [Agregue geocercas circulares](#draw-circle-geofences). Con las API de Amazon Location Service, también puede añadir metadatos a su geocerca en forma de pares clave-valor. Pueden resultar útiles para almacenar información sobre la geocerca, como su tipo, u otra información específica de su aplicación. Puede utilizar estos metadatos al [Reaccione a los eventos de Amazon Location Service con Amazon EventBridge](location-events.md). ## Añada geocercas poligonales Las geocercas poligonales utilizan matrices de coordenadas GeoJSON para definir un área. Utilice este formato cuando necesite rastrear las entradas o salidas de un límite geográfico de forma irregular. ### Dibujar geocercas con una herramienta de GeoJSON 1. [Abra una herramienta de edición de GeoJSON, como geojson.io.](http://geojson.io/) 1. Elija el icono **Dibujar un polígono** y dibuje su área de interés. 1. Seleccione **Guardar** y, a continuación, seleccione **GeoJSON** en el menú desplegable. ### Coloque geocercas de GeoJSON en una colección de geocercas Puede utilizar el archivo GeoJSON resultante para cargar sus geocercas mediante la consola de Amazon Location Service, las API de ubicación de Amazon AWS CLI o las API de ubicación de Amazon. ------ #### [ Console ] 1. Abre la consola de Amazon Location Service en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En el panel de navegación izquierdo, elija **Colecciones de geocercas**. 1. En la lista de **Colecciones de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino. 1. En **Geocercas**, elija **Crear geocercas**. 1. En la ventana **Añadir geocercas,** arrastre y suelte su GeoJSON en la ventana. 1. Seleccione **Agregar geocercas**. ------ #### [ API ] Utilice la operación `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` desde las API de Amazon Location Geofences. En el siguiente ejemplo, se utiliza una solicitud de API para añadir una geocerca con el ID {{GEOFENCE-EXAMPLE1}} a una colección de geovallas llamada. {{ExampleGeofenceCollection}} También especifica una propiedad de metadatos de una geocerca con la clave y el valor. `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] ] ] } } ``` Como alternativa, puede agregar más de una geocerca mediante la operación `[BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html)`. ``` 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 ] Utilice el comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`. En el siguiente ejemplo, se utiliza AWS CLI para agregar una geocerca a una colección de geocercas llamada. {{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]]]' ``` ------ ## Agregue geocercas circulares Para crear una geocerca circular, debe conocer la latitud y la longitud del punto central y el radio en metros. Utilice geocercas circulares cuando necesite activar eventos en función de la proximidad a un punto específico, como una tienda, un almacén o un punto de referencia. Puede crear geocercas circulares con la consola de ubicación de Amazon, las API de ubicación de Amazon o la. AWS CLI ------ #### [ Console ] 1. Abre la consola de Amazon Location Service en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En el panel de navegación izquierdo, elija **Colecciones de geocercas**. 1. En la lista de **Colecciones de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino. 1. En **Geocercas**, elija **Crear geocercas**. 1. En la ventana **Añadir geocercas**, seleccione **Círculo** e introduzca la ****latitud****, la longitud y el **radio del centro en metros**. 1. Seleccione **Agregar geocercas**. ------ #### [ API ] Utilice la operación `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` desde las API de Amazon Location Geofences. En el siguiente ejemplo, se utiliza una solicitud de API para añadir una geocerca con el ID {{GEOFENCE-EXAMPLE2}} a una colección de geovallas llamada. {{ExampleGeofenceCollection}} ``` PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE2}} Content-type: application/json { "Geometry": { "Circle": { "Center": [-5.716667, -15.933333], "Radius": 50 } } } ``` ------ #### [ AWS CLI ] Utilice el comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`. En el siguiente ejemplo, se utiliza AWS CLI para agregar una geocerca circular a una colección de geocercas denominada. {{ExampleGeofenceCollection}} ``` aws location \ put-geofence \ --collection-name {{ExampleGeofenceCollection}} \ --geofence-id {{ExampleGeofenceCircle}} \ --geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}' ``` **nota** También puede incluir JSON para geometrías complejas en su propio archivo, como en el siguiente ejemplo. ``` aws location \ put-geofence \ --collection-name {{ExampleGeofenceCollection}} \ --geofence-id {{ExampleGeofenceCircle}} \ --geometry file://circle.json ``` Dónde `circle.json` contiene la geometría circular. ``` { "Circle": { "Center": [-74.006975, 40.717127], "Radius": 287.7897969218057 } } ``` ------