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.
# Geocercas de Amazon Location Service
![\[Información general de geocercas de Amazon Location Service.\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/images/geofences-overview.png)
Los recursos de la recopilación de geocercas le permiten almacenar y administrar las geocercas, es decir, límites virtuales en un mapa. Puede evaluar las ubicaciones comparándolas con un recurso de recopilación de geocercas y recibir notificaciones cuando la actualización de la ubicación cruce el límite de cualquiera de las geocercas de la recopilación.
**Geocercas y recopilación de geocercas**
Una geocerca es una geometría de círculo, polígono o multipolígono que define un límite virtual en un mapa. Una recopilación de geocercas contiene cero o más geocercas. Es capaz de supervisar las geocercas emitiendo eventos de `ENTER` y `EXIT`, cuando se solicitan, para evaluar la posición de un dispositivo con respecto a sus geocercas.
**Eventos de geocercas**
Las ubicaciones de los puestos que está supervisando están referenciadas mediante un ID llamado `DeviceId`. Las posiciones se denominan posiciones del dispositivo. Puede enviar una lista de las posiciones de los dispositivos para evaluarlas directamente al recurso de recolección de geocercas o puede usar un rastreador. Para obtener más información acerca del uso de rastreadores, consulte [Rastreadores de Amazon Location Service](trackers.md).
Solo recibirá eventos (a través de Amazon EventBridge) cuando un dispositivo entre o salga de una geocerca, no por cada cambio de posición. Esto significa que normalmente recibirá eventos y tendrá que responder a ellos con mucha menos frecuencia que en todas las actualizaciones de posición del dispositivo.
**nota**
Para la primera evaluación de la ubicación de un `DeviceID` específico, se supone que el dispositivo no estaba anteriormente en ninguna geocerca. Por lo tanto, la primera actualización generará un evento `ENTER`, si está dentro de una geocerca de la colección, y ningún evento si no lo está.
Para calcular si un dispositivo ha entrado o salido de una geocerca, Amazon Location Service debe mantener el estado de posición anterior del dispositivo. Este estado de posición se almacena durante 30 días. Después de 30 días sin una actualización para un dispositivo, una nueva actualización de ubicación se considerará la primera actualización de posición.
## Casos de uso de geocercas de Amazon Location Service
A continuación, se muestran algunos usos habituales de las geocercas de Amazon Location Service.
**Mejora de las operaciones del servicio de campo**
Manténgase al tanto de su fuerza laboral móvil con el seguimiento en tiempo real. Establezca geocercas alrededor de los sitios de los clientes y las áreas de servicio para recibir alertas cuando el personal llegue y se vaya. Utilice los datos de ubicación para optimizar la programación, enviar al técnico disponible más cercano y reducir los tiempos de respuesta. Capacite a los equipos de campo (como su empresa de reparación de fontanería o HVAC) para que trabajen de manera más eficiente y, al mismo tiempo, mejore la experiencia del cliente.
**Supervisión y control de los activos críticos**
Utilice Amazon Location Service para rastrear la ubicación y el estado en tiempo real de sus valiosos equipos, inventario y otros activos móviles. Configure geocercas para recibir alertas sobre movimientos o retiradas no autorizados, lo que mejorará la seguridad y el cumplimiento. Utilice esta visibilidad de la ubicación para mejorar la utilización de los activos, optimizar los programas de mantenimiento y asegurarse de que los recursos críticos estén contabilizados en todo momento. Supervise siempre con precisión la maquinaria pesada, el hardware de TI o el inventario minorista, reduzca las pérdidas y tome decisiones operativas más fundamentadas.
**Mejora de la visibilidad de la cadena de suministro**
Aproveche Amazon Location Service para realizar un seguimiento de los envíos y las entregas en toda la cadena de suministro. Defina geocercas alrededor de los centros de distribución, las tiendas y otras instalaciones clave para supervisar el movimiento del inventario y los activos. Utilice datos de ubicación en tiempo real para mejorar la administración del inventario, optimizar la planificación logística y ofrecer una experiencia de cliente superior. Obtenga una visibilidad integral de las operaciones de la cadena de suministro, identifique los cuellos de botella y tome decisiones basadas en datos que impulsen la eficiencia y la capacidad de respuesta.
**Refuerzo de la seguridad y la protección**
El geocercado le permite establecer límites virtuales alrededor de áreas seguras, zonas restringidas y otros lugares críticos. Reciba alertas instantáneas cuando personal o activos no autorizados ingresen o salgan de estas geocercas predefinidas. Aproveche esta supervisión de la ubicación en tiempo real para mejorar la seguridad del lugar de trabajo, impedir el ingreso ilegal y garantizar el cumplimiento de las normas. Si administra una planta de fabricación, una obra en construcción o un campus corporativo, el geocercado le permite mantener un control más estricto del acceso, mejorar la respuesta a los incidentes y proteger a las personas, propiedades y activos.
**Marketing basado en la ubicación**
Libere el poder de los datos de ubicación para potenciar sus esfuerzos de geomarketing. Utilice Amazon Location Service para establecer límites virtuales en torno a las ubicaciones, los eventos y las áreas de alto tráfico de la competencia. Desencadene anuncios, ofertas y notificaciones personalizados cuando los clientes ingresen en estas zonas geocercadas. Analice los patrones de tráfico peatonal para optimizar las ubicaciones de los anuncios y descubrir los sitios principales para nuevas ubicaciones comerciales. Supervise los movimientos de los clientes dentro de sus propios espacios geocercados para obtener información más detallada sobre los comportamientos de navegación y la ruta de compra. Combine el seguimiento de la ubicación en tiempo real con una geolocalización precisa para ofrecer una interacción contextual y muy segmentada que impulse las ventas y la fidelización en el mundo físico.
# Conceptos de geocercas
En esta sección se describen algunos conceptos comunes de geocercas, incluida la terminología común y la forma de administrar las geocercas.
## Terminología de geocercas de Amazon Location Service
Geocercas
Límite virtual de un área geográfica en un mapa.
Recolección de geocerca
Un grupo de geocercas que es capaz de emitir eventos `Entry` y `Exit`, cuando se solicitan, para evaluar la posición de un dispositivo con respecto a las geocercas de sus componentes.
Geometría de geocercas
Una forma geométrica o conjunto de formas que definen las áreas que se van a incluir o excluir de una geocerca. La geometría de una geocerca se puede representar como `Circle`, `Polygon` o `MultiPolygon`.
Un `Circle` es un punto rodeado de una distancia. Usa un círculo cuando desee recibir una notificación si un dispositivo se encuentra a una distancia determinada de una ubicación.
Un `Polygon` es una lista de anillos lineales que representan la forma de una geocerca. Esta lista *debe* incluir un anillo exterior que represente el perímetro exterior de la geocerca y, opcionalmente, puede incluir varios anillos interiores que representen espacios poligonales dentro del perímetro, que están excluidos del área de la geocerca.
Un `MultiPolygon` es una lista de elementos de `Polygon` que representan la forma de una geocerca. Los componentes de `Polygon` de una geometría de `MultiPolygon` pueden definir áreas geográficas independientes que se consideran parte de la misma geocerca, perímetros de áreas exteriores más grandes con espacios interiores más pequeños que están excluidos de la geocerca o alguna combinación de estos casos de uso para formar límites de geocerca complejos.
Para obtener más información sobre la definición de geometrías de geocercas, incluidos los requisitos de sintaxis, las limitaciones y los ejemplos, consulte [GeofenceGeometry](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html) en la *referencia de la API de Amazon Location Service*.
# Introducción a geocercas de Amazon Location Service
Las geocercas son herramientas poderosas para definir los límites geográficos y activar acciones en función de las actualizaciones de ubicación. En esta guía, se explica el proceso de creación y uso de los recursos de recopilación de geocercas en Amazon Location. Al configurar las geocercas y evaluar las ubicaciones en función de ellas, puede supervisar el movimiento y generar eventos automatizados, como notificaciones cuando un dispositivo ingresa o sale de un área definida. Estas características son ideales para aplicaciones como el seguimiento de flotas, las notificaciones basadas en la ubicación, etc.
1. Cree un recurso de recopilación de geocercas en su cuenta de AWS.
1. Agregue geocercas a la recopilación. Puede usar la herramienta de carga de geocercas de la consola de Amazon Location o la API de Geocercas de Amazon Location. Para obtener más información sobre las opciones disponibles, consulte [Autenticación con Amazon Location Service](access.md). Una geocerca se puede definir como `Circle`, `Polygon` o `MultiPolygon`. Use un `Polygon` o un `MultiPolygon` para saber cuándo un dispositivo ingresa en un área específica. Use un `Circle` para determinar cuándo un dispositivo se encuentra a una distancia (radio) determinada de un punto. Para obtener más información, consulte la [Terminología de geocercas de Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/geofence-components.html#geofence-terminology).
1. Puede empezar a evaluar las ubicaciones comparándolas con todas tus geocercas. Cuando una actualización de ubicación cruza los límites de una o más geocercas, el recurso de recopilación de geocercas emite uno de los siguientes tipos de eventos de geocercas en Amazon EventBridge:
+ **INGRESO**: se genera un evento para cada geocerca en el que la actualización de ubicación cruza su límite al ingresar a este.
+ **SALIDA**: se genera un evento para cada geocerca en el que la actualización de ubicación cruza su límite al salir de este.
Para obtener más información, consulte [Reaccione a los eventos de Amazon Location Service con Amazon EventBridge](location-events.md). También puede integrar la supervisión mediante servicios como Amazon CloudWatch y AWS CloudTrail. Para obtener más información, consulte [Monitoriza con Amazon CloudWatch](cloudwatch.md) y [Supervise e inicie sesión con AWS CloudTrail](cloudtrail.md).
Por ejemplo, si está rastreando una flota de camiones y desea recibir una notificación cuando un camión ingrese en un área determinada de cualquiera de los almacenes. Cree una geocerca para el área alrededor de cada almacén. Cuando los camiones le envíen ubicaciones actualizadas, use Amazon Location Service para evaluar esas posiciones y comprobar si un camión ha ingresado (o salido) de una de las áreas de la geocerca.
**nota**
Se le facturará en función del número de recopilaciones de geocercas con las que realice la evaluación. La cantidad de geocercas de cada colección no afecta a su factura. Dado que cada colección de geocercas puede contener hasta 50 000 geocercas, tal vez desee combinar sus geocercas en un menor número de colecciones, siempre que sea posible, para reducir el costo de las evaluaciones de las geocercas. Los eventos generados incluirán el identificador de la geocerca individual de la colección, así como el identificador de la colección.
# Cómo funcionan las geocercas de Amazon Location Service
En esta sección se proporcionan instrucciones paso a paso para trabajar con tareas relacionadas con geocercas en Amazon Location. Obtenga información sobre cómo evaluar las posiciones de los dispositivos con respecto a las geocercas, a responder a los eventos de geocercas con Amazon EventBridge y a administrar de forma eficaz los recursos de geocercas. Estos tutoriales están diseñados para ayudarlo a implementar funciones clave para rastrear y administrar eventos basados en la ubicación con facilidad.
**Topics**
+ [Evalúe las posiciones de los dispositivos comparándolas con las geocercas](evaluate-geofences.md)
+ [Reaccione a los eventos de Amazon Location Service con Amazon EventBridge](location-events.md)
+ [Administración de los recursos de recopilación de geocercas](managing-geofence-collections.md)
# Evalúe las posiciones de los dispositivos comparándolas con las geocercas
Hay dos formas de evaluar las posiciones frente a las geocercas para generar eventos de geocercas:
+ Puede vincular los Rastreadores y las Colecciones de geocercas. Para obtener más información, consulte la sección: [Vincular un rastreador a una colección de geocercas](associate-consumer.md).
+ Puede hacer una solicitud directa al recurso de colección de geocercas para evaluar una o más posiciones.
Si también quiere rastrear el historial de ubicaciones de su dispositivo o mostrar las ubicaciones en un mapa, vincule el rastreador a una colección de geocercas. Como alternativa, es posible que no desee evaluar todas las actualizaciones de ubicación o que no tenga intención de almacenar los datos de ubicación en un recurso de rastreo. En cualquiera de estos casos, puede hacer una solicitud directa a la colección de geocercas y evaluar las posiciones de uno o más dispositivos comparándolas con sus geocercas.
La evaluación de las posiciones de los dispositivos con respecto a las geocercas genera eventos. Puede reaccionar ante estos eventos y enviarlos a otros AWS servicios. Para obtener más información sobre las acciones que puede realizar al recibir eventos de geocerca, consulte [Reaccionar ante los eventos de Amazon Location Service con Amazon](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html). EventBridge
Un evento de Amazon Location incluye los atributos de la actualización de posición del dispositivo que lo genera, como la hora, la posición, la precisión y los metadatos clave-valor, además de algunos atributos de la geocerca por la que se entra o se sale. Para obtener más información sobre los datos incluidos en un evento de geocercas, consulte [Ejemplos de EventBridge eventos de Amazon para Amazon Location Service](location-events.md#example-event).
En los siguientes ejemplos se utiliza AWS CLI la ubicación de Amazon o Amazon APIs.
------
#### [ API ]
**Para evaluar las posiciones de los dispositivos con respecto a la posición de las geocercas utilizando la ubicación de Amazon APIs**
Usa la `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` operación desde Amazon Location Geofences APIs.
En el siguiente ejemplo, se utiliza una solicitud de API para evaluar la posición del dispositivo en relación con una colección *ExampleDevice* de geocercas asociada. *ExampleGeofenceCollection* Sustituya estos valores por su propia geocerca y dispositivo. IDs
```
POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json
{
"DevicePositionUpdates": [
{
"DeviceId": "ExampleDevice",
"Position": [-123.123, 47.123],
"SampleTime": "2021-11-30T21:47:25.149Z",
"Accuracy": {
"Horizontal": 10.30
},
"PositionProperties": {
"field1": "value1",
"field2": "value2"
}
}
]
}
```
------
#### [ AWS CLI ]
**Para evaluar las posiciones de los dispositivos con respecto a la posición de las geocercas mediante comandos AWS CLI **
Utilice el comando `[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`.
En el siguiente ejemplo, se utiliza una AWS CLI para evaluar la posición de un conjunto de geocercas asociado con *ExampleDevice* respecto a él. *ExampleGeofenceCollection* Sustituya estos valores por su propia geocerca y dispositivo. IDs
```
aws location \
batch-evaluate-geofences \
--collection-name ExampleGeofenceCollection \
--device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```
------
# Reaccione a los eventos de Amazon Location Service con Amazon EventBridge
Amazon EventBridge es un bus de eventos sin servidor que conecta las aplicaciones de manera eficiente mediante datos de AWS servicios como Amazon Location. EventBridge recibe eventos de Amazon Location y dirige esos datos a objetivos como AWS Lambda. Puede configurar reglas de direccionamiento para determinar adónde enviar sus datos a fin de crear arquitecturas de aplicaciones que reaccionen en tiempo real.
De forma predeterminada, solo se envían los `EXIT` eventos geocercados (`ENTER`y los eventos cuando los dispositivos entran o salen de las áreas geocercadas). EventBridge También puede activar todos los eventos de actualización de posición filtrados para un recurso de seguimiento. Para obtener más información, consulte [Habilitar los eventos de actualización para un rastreador](#enable-update-events).
Para obtener más información, consulta [los eventos y patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en *la Guía del EventBridge usuario de Amazon*.
**Topics**
+ [Habilitar los eventos de actualización para un rastreador](#enable-update-events)
+ [Crea reglas de eventos para Amazon Location](#create-event-rule)
+ [Ejemplos de EventBridge eventos de Amazon para Amazon Location Service](#example-event)
## Habilitar los eventos de actualización para un rastreador
De forma predeterminada, Amazon Location solo `ENTER` envía eventos `EXIT` geoperimetrales a. EventBridge Puedes activar todos los `UPDATE` eventos de posición filtrados a los que se pueda enviar un rastreador. EventBridge Puede hacerlo al [crear](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) o [actualizar](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) un rastreador.
Por ejemplo, para actualizar un rastreador existente mediante el AWS CLI, puede utilizar el siguiente comando (utilice el nombre del recurso del rastreador en lugar de*MyTracker*).
```
aws location update-tracker --tracker-name MyTracker --event-bridge-enabled
```
Para desactivar los eventos de posición de un rastreador, debe usar la API o la consola de Amazon Location Service.
## Crea reglas de eventos para Amazon Location
Puedes crear [hasta 300 reglas por bus de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-quota.html) EventBridge para configurar las acciones que se tomen en respuesta a un evento de Amazon Location.
Por ejemplo, puede crear una regla para los eventos de geocerca en la que se envíe una notificación automática cuando se detecte un teléfono dentro del límite de una geocerca.
**Para crear una regla para los eventos de Amazon Location**
Con los siguientes valores, [crea una EventBridge regla](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-visual.html) basada en los eventos de Amazon Location:
+ En **Tipo de regla**, elija **Regla con un patrón de evento**.
+ Agregue el siguiente patrón en el cuadro **Patrón de evento**:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"]
}
```
Para crear una regla para las actualizaciones de posición del rastreador, puede utilizar este modelo:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Device Position Event"]
}
```
Si lo desea, puede especificar solo los eventos `ENTER` o `EXIT` añadiendo la etiqueta `detail` (si su regla es para las actualizaciones de posición del rastreador, solo hay un `EventType`, así que no es necesario filtrarlo):
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"]
}
}
```
Si lo desea, también puede filtrar por propiedades de la posición o la geocerca:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"],
"GeofenceProperties": {
"Type": "LoadingDock"
},
"PositionProperties": {
"VehicleType": "Truck"
}
}
}
```
+ En **Seleccionar objetivos**, elija la acción objetivo que se realizará cuando se reciba un evento de Amazon Location Service.
Por ejemplo, utilice un tema de Amazon Simple Notification Service (SNS) para enviar un correo electrónico o un mensaje de texto cuando se produce un evento. Primero debe crear un tema de Amazon SNS mediante la consola de Amazon SNS. Para obtener más información, consulte [Uso de Amazon SNS para notificaciones de usuario](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html).
**aviso**
Se recomienda confirmar que la regla de los eventos se ha aplicado correctamente o es posible que la acción automatizada no comience tal y como se esperaba. Para verificar la regla de eventos, inicie las condiciones para la regla de eventos. Por ejemplo, simule un dispositivo que entra en un área geocercada.
También puede capturar todos los eventos desde Amazon Location excluyendo la sección `detail-type`. Por ejemplo:
```
{
"source": [
"aws.geo"
]
}
```
**nota**
El mismo evento puede entregarse más de una vez. Puede usar el identificador del evento para eliminar las duplicaciones de los eventos que reciba.
## Ejemplos de EventBridge eventos de Amazon para Amazon Location Service
A continuación, se muestra un ejemplo de un evento de entrada de una geocerca iniciado por una llamada `BatchUpdateDevicePosition`.
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "636103698109",
"time": "2020-11-10T23:43:37Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "ENTER",
"GeofenceId": "polygon_14",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:43:37.531Z",
"Position": [
-123.12390073297821,
49.23433613216247
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
A continuación, se muestra un ejemplo de un evento de salida de una geocerca que se inicia con una llamada `BatchUpdateDevicePosition`.
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "EXIT",
"GeofenceId": "polygon_10",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
A continuación, se muestra un ejemplo de un evento de actualización de posición que se inicia con una llamada `BatchUpdateDevicePosition`.
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Device Position Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "UPDATE",
"TrackerName": "tracker_2",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"ReceivedTime": "2020-11-10T23:41:39.235Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
# Administración de los recursos de recopilación de geocercas
Gestione sus colecciones de geovallas mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon. APIs
## Enumerar sus recursos de colección de geocercas
Puedes ver tu lista de colecciones de geovallas mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon: APIs
------
#### [ Console ]
**Para ver una lista de colecciones de geocercas mediante la consola de Amazon Location**
1. Abre la consola de Amazon Location 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. Consulte una lista de sus colecciones de geocercas en **Mis colecciones de geocercas**.
------
#### [ API ]
Usa la `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` operación desde Amazon Location Geofences APIs.
El siguiente ejemplo es una solicitud de API para obtener una lista de las colecciones de geovallas de la cuenta. AWS
```
POST /geofencing/v0/list-collections
```
A continuación, se muestra un ejemplo de respuesta para `ListGeofenceCollections`:
```
{
"Entries": [
{
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"UpdateTime": 2020-09-30T23:59:34.142Z
},
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Utilice el comando `[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)`.
El siguiente ejemplo sirve AWS CLI para obtener una lista de las colecciones de geovallas de la cuenta. AWS
```
aws location list-geofence-collections
```
------
## Obtenga los detalles de la colección de geocercas
Puede obtener detalles sobre cualquier recurso de recopilación de geovallas de su AWS cuenta mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon: APIs
------
#### [ Console ]
**Para ver los detalles de una colección de geocercas mediante la consola de Amazon Location**
1. Abre la consola de Amazon Location 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 **Mis colecciones de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino.
------
#### [ API ]
Usa la `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` operación desde Amazon Location Geofences APIs.
El siguiente ejemplo es una solicitud a la API para obtener los detalles de la recopilación de geovallas. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection
```
A continuación, se muestra un ejemplo de respuesta para `DescribeGeofenceCollection`:
```
{
"CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"Tags": {
"Tag1" : "Value1"
},
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
Utilice el comando `[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)`.
El siguiente ejemplo es AWS CLI para obtener los detalles de la colección de geovallas. *ExampleCollection*
```
aws location describe-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Eliminar una colección de geocercas
Puedes eliminar una colección de geovallas de tu AWS cuenta mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon. APIs
------
#### [ Console ]
**Para eliminar una colección de geocercas mediante la consola de Amazon Location**
**aviso**
Esta operación elimina el recurso de forma permanente.
1. Abre la consola de Amazon Location 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 **Mi colección de geocercas**, seleccione la colección de geocercas de destino.
1. Seleccione **Eliminar colección de geocercas**.
------
#### [ API ]
Usa la `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` operación desde la sucursal de Amazon APIs.
El siguiente ejemplo es una solicitud de API para eliminar la colección de geovallas. *ExampleCollection*
```
DELETE /geofencing/v0/collections/ExampleCollection
```
A continuación, se muestra un ejemplo de respuesta para `DeleteGeofenceCollection`:
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilice el comando `[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)`.
El siguiente ejemplo es un AWS CLI comando para eliminar la colección de geovallas. *ExampleCollection*
```
aws location delete-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Enumerar las geocercas almacenadas
Puede enumerar las geocercas almacenadas en una colección de geocercas específica mediante la consola de ubicaciones de Amazon, la AWS CLI o la ubicación de Amazon. APIs
------
#### [ Console ]
**Para ver una lista de geocercas mediante la consola de Amazon Location**
1. Abre la consola de Amazon Location 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 **Mi colección de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino.
1. Consulte las geocercas de la colección de geocercas en **Geocercas**
------
#### [ API ]
Usa la `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` operación desde Amazon Location Geofences APIs.
El siguiente ejemplo es una solicitud de API para obtener una lista de geocercas almacenadas en la colección de geocercas. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/list-geofences
```
A continuación, se muestra un ejemplo de respuesta para `ListGeofences`:
```
{
"Entries": [
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "geofence-1",
"Geometry": {
"Polygon": [
[-5.716667, -15.933333,
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Utilice el comando `[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)`.
El siguiente ejemplo sirve AWS CLI para obtener una lista de geocercas almacenadas en la colección de geocercas. *ExampleCollection*
```
aws location list-geofences \
--collection-name "ExampleCollection"
```
------
## Obtener detalles de geocercas
Puede obtener los detalles de una geocerca específica, como la hora de creación, la hora de actualización, la geometría y el estado, de una colección de geocercas mediante la consola de ubicaciones de Amazon AWS CLI o la ubicación de Amazon. APIs
------
#### [ Console ]
**Para ver el estado de una geocerca mediante la consola de Amazon Location**
1. Abre la consola de Amazon Location 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 **Mi colección de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino.
1. En **Geocercas**, podrá ver el estado de sus geocercas.
------
#### [ API ]
Usa la `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` operación desde Amazon Location Geofences APIs.
El siguiente ejemplo es una solicitud de API para obtener los detalles de una geocerca de una colección de geovallas. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1
```
A continuación, se muestra un ejemplo de respuesta para `GetGeofence`:
```
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "ExampleGeofence1",
"Geometry": {
"Polygon": [
[-1,-1],
[1,-1],
[0,1],
[-1,-1]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
Utilice el comando `[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)`.
El siguiente ejemplo es AWS CLI para obtener los detalles de la colección de geocercas. *ExampleCollection*
```
aws location get-geofence \
--collection-name "ExampleCollection" \
--geofence-id "ExampleGeofence1"
```
------
## Eliminar geocercas
Puede eliminar geocercas de una colección de geovallas mediante la consola de ubicaciones de Amazon, la AWS CLI o la ubicación de Amazon. APIs
------
#### [ Console ]
**Para eliminar una geocerca mediante la consola de Amazon Location**
**aviso**
Esta operación elimina el recurso de forma permanente.
1. Abre la consola de Amazon Location 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 **Mi colección de geocercas**, seleccione el enlace con el nombre de la colección de geocercas de destino.
1. En **Geocercas**, seleccione la geocerca de destino.
1. Seleccione **Eliminar geocerca**.
------
#### [ API ]
Usa la `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` operación desde Amazon Location Geofences APIs.
El siguiente ejemplo es una solicitud de API para eliminar geocercas de la colección de geocercas. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json
{
"GeofenceIds": [ "ExampleGeofence11" ]
}
```
A continuación se muestra un ejemplo de una respuesta correcta para `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`.
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilice el comando `[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)`.
El siguiente ejemplo es un AWS CLI comando para eliminar las geocercas de la colección de geocercas. *ExampleCollection*
```
aws location batch-delete-geofence \
--collection-name "ExampleCollection" \
--geofence-ids "ExampleGeofence11"
```
------
# Administración de costos y uso
A medida que siga obteniendo información sobre las geocercas de Amazon Location, es importante que sepa cómo administrar la capacidad del servicio, asegurarse de cumplir con los límites de uso y obtener los mejores resultados mediante las optimizaciones de cuotas y API. Al aplicar las prácticas recomendadas para garantizar el rendimiento y la precisión, puede personalizar la aplicación para gestionar las consultas relacionadas con el lugar de forma eficiente y maximizar las solicitudes de la API.
**Topics**
+ [Precios de geocercas](geofence-price.md)
+ [Cuotas y uso de geocercas](geofence-quotas.md)
# Precios de geocercas
Para obtener información sobre los precios de seguimiento y geocercado de las API, consulte la [página de precios de Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Evaluación del puesto**
Puede utilizar `BatchEvaluateGeofences` para evaluar las posiciones del dispositivo frente a las geometrías de geocercas de una recopilación de geocercas determinada. Una solicitud evaluará las posiciones de hasta diez dispositivos comparándolas con todas las geocercas de una sola recopilación de geocercas. El precio se basa en el número de posiciones del dispositivo en las solicitudes de la API. El precio unitario por posición del dispositivo evaluado se basa en el volumen total de uso mensual. Consulte la [página de precios de Amazon Location Service](https://aws.amazon.com/location/pricing/) para obtener más información sobre el precio unitario y los niveles de volumen.
Puede optimizar los costos de evaluación de posición configurando la frecuencia de actualización de la posición del dispositivo (también conocida como tasa de ping) desde los dispositivos de rastreo y aprovechando la característica de filtrado de los rastreadores para evaluar solo las actualizaciones de posición relevantes.
**Administración y almacenamiento de geocercas**
Puede usar `GetGeofence`, `PutGeofence`, `BatchPutGeofence` y `BatchDeleteGeofence` para administrar las geocercas en una recopilación de geocercas. El precio de estas API se basa en la cantidad de geocercas incluidas en las solicitudes de API.
El almacenamiento de las geocercas se cobrará mensualmente (solo en el caso de las geocercas que almacene durante más de un mes). También puede administrar la recopilación de geocercas mediante las siguientes API: `CreateGeofenceCollection`, `DeleteGeofenceCollection`, `DescribeGeofenceCollection`, `ListGeofenceCollections`, `UpdateGeofenceCollection` y `ListGeofences`. El precio de estas API se basa en la cantidad de solicitudes de API.
**Previsión de eventos de geocercas**
Puede utilizar `ForecastGeofenceEvents` para pronosticar eventos futuros de geocercas que probablemente se produzcan dentro de un horizonte temporal específico si un dispositivo continúa moviéndose a su velocidad actual. El precio se basa en la cantidad de solicitudes de API.
# Cuotas y uso de geocercas
En este tema se proporciona un resumen de los límites de tarifas y las cuotas de geocercas de Amazon Location Service.
**nota**
Si requiere una cuota más alta, Puede utilizar la consola de Service Quotas para [solicitar aumentos de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) para las cuotas ajustables. Cuando solicites un aumento de cuota, selecciona la región en la que deseas el aumento de cuota, ya que la mayoría de las cuotas son específicas de la AWS región. Puede solicitar hasta el doble del límite predeterminado para cada API.
En el caso de las solicitudes que superen el doble del límite predeterminado, la solicitud enviará un ticket de soporte. Puede también contactar con el equipo de soporte prémium. No se cobran cargos directos por las solicitudes de aumento de cuota, pero los niveles de uso más altos pueden conllevar un aumento de los costos del servicio en función de los recursos adicionales consumidos. Para obtener más información, consulte [Administración de cuotas con Service Quotas](manage-quotas.md).
Service Quotas es la cantidad máxima de recursos que puede tener por AWS cuenta y AWS región. Amazon Location Service deniega las solicitudes adicionales que superen la service quota.
## Recursos
| Nombre de API | Predeterminado | Límite ajustable máximo |
| --- | --- | --- |
| Recursos de recopilación por cuenta | 1500 | 3 000 Si necesita más que esto, [solicite aumentos de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacte con el equipo de soporte. |
| Geocercas por recopilación | 50000 | Contacte con el equipo de soporte. |
## API de CRUD
**nota**
Si necesitas un límite superior para alguna de estas opciones APIs, [solicita un aumento de la cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o ponte en contacto con el equipo de asistencia.
| Nombre de API | Predeterminado | Límite ajustable máximo |
| --- | --- | --- |
| [CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html) | 10 | 20 |
| [DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html) | 10 | 20 |
| [DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html) | 10 | 20 |
| [ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html) | 10 | 20 |
| [UpdateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_UpdateGeofenceCollection.html) | 10 | 20 |
## Data API (API de datos)
**nota**
Si necesitas un límite superior para alguno de estos requisitos APIs, [solicita un aumento de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o ponte en contacto con el equipo de asistencia.
| Nombre de API | Predeterminado | Límite ajustable máximo |
| --- | --- | --- |
| [BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html) | 50 | 100 |
| [PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html) | 50 | 100 |
| [BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html) | 50 | 100 |
| [ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html) | 50 | 100 |
| [GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html) | 50 | 100 |
| [BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html) | 50 | 100 |
## Otros límites de uso