Verificación de la ubicación

La herramienta de verificación de la ubicación le permite verificar la ubicación de un dispositivo de usuario final dentro de un área especificada. Utiliza técnicas de posicionamiento de redes celulares para localizar el dispositivo, lo que proporciona varias ventajas sobre el posicionamiento GPS, entre ellas:

  • Seguro y de confianza: El posicionamiento en redes celulares utiliza información procedente directamente de las redes de los operadores móviles, lo que elimina el riesgo de falsificación del GPS y de elusión a través de VPN.
  • Integración simplificada: Identity Insights puede integrarse fácilmente en sus aplicaciones, reduciendo la complejidad y el esfuerzo del desarrollo de software.

Algunos casos de uso de la prevención del fraude en los que resulta útil la verificación de la ubicación:

  • Verificación de usuarios de comercio electrónico: Las plataformas de comercio electrónico y de contenidos se enfrentan al problema de que los usuarios consumen servicios, contenidos y licencias fuera de la región para la que han sido autorizados. Location Verification insight permite a estas plataformas verificar si la ubicación de un usuario final se encuentra dentro de la región autorizada para el servicio, contenido o licencia.
  • Verificación en el punto de venta: Cuando un usuario realiza una compra en una tienda utilizando su tarjeta de crédito o bancaria, a veces su proveedor financiero querrá verificar si la transacción es fraudulenta. La verificación de la ubicación podría utilizarse con el número de teléfono introducido en la aplicación bancaria para consultar la ubicación en la que se inició la transacción y confirmar que el usuario se encuentra en ese lugar.
  • Contenidos basados en la localización: Verify a user's location during sports events or concerts to enrich their experience with custom content, such as goal replays, different angles, useful information, and more.

Requisitos previos

Para utilizar Identity Insights, debe asegurarse de que su Account está configurado correctamente; consulte la sección Primeros pasos para obtener más información:

  • Crear una Account,
  • Creación de una aplicación de Vonage para su uso con la API Identity Insights,
  • Los diferentes entornos disponibles y cómo configurar su Account para utilizarlos,
  • Y cómo utilizar la interfaz de usuario de inicio del panel de control para utilizar la API sin escribir ningún código.

Esta guía explicará cómo utilizar el programa Location Verification Insight utilizando cURL.

La API Identity Insights está disponible a través de varios puntos finales regionales. Los ejemplos de esta guía utilizan el punto final de la UE, pero puede consultar la lista completa en Detalles técnicos.

Realizar una llamada a la API

La autenticación para la API Identity Insights se realiza mediante JWT, un token JSON compacto y autocontenido. Para generar un JWT, puede utilizar nuestra herramienta generador en líneao, alternativamente, utilice el botón CLI de Vonage. Necesitará su ID de aplicación y su clave privada para generar el JWT. Una vez que tenga su JWT, puede enviar una solicitud a la API.

En este ejemplo se muestra una solicitud cURL para que la herramienta de verificación de la ubicación compruebe si la ubicación de un determinado dispositivo de usuario se encuentra dentro de la zona especificada:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "location_verification": {
         "location": {
            "type": "CIRCLE",
            "radius": 3000,
            "center": {
               "latitude": -90,
               "longitude": -180
                }
            }
          }
        }
    }'

A continuación, la API comparará la zona proporcionada como entrada para el usuario concreto del teléfono móvil con la ubicación disponible en los propios sistemas del operador del usuario del teléfono móvil, y devolverá una confirmación en caso de que coincidan:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "location_verification": {
        "is_verified": "TRUE",
        "latest_location_at": "2024-07-08T09:30:27.504Z",
        "match_rate": 1,
        "status": {
          "code": "OK",
          "message": "Success"
        }
    }
  }
}

Verá los siguientes campos en location_verification matriz:

Campo Descripción
is_verified Resultado de una solicitud de verificación:

TRUE: cuando la red localiza el dispositivo dentro de la zona solicitada.
FALSE: cuando la zona solicitada no coincide con la zona donde la red localiza el dispositivo.
UNKNOWN: cuando la red no puede localizar el dispositivo.
PARTIAL: cuando la zona solicitada coincide parcialmente con la zona en la que la red localiza el dispositivo. A match_rate podría incluirse en la respuesta.
latest_location_at Fecha y hora en UTC ISO 8601 de la última ubicación.
match_rate Estimación de la tasa de coincidencia entre el área de la solicitud (R), y el área donde la red localiza el dispositivo (N), calculada como el valor porcentual de la intersección de ambas áreas dividido por el área de la red, es decir (R ∩ N) / N * 100. Incluido sólo si se verifica es PARTIAL.
status Indica el estado de la información devuelta para el número de teléfono especificado.
code Código que indica el estado de la solicitud. Debe ser uno de los siguientes:

NO_COVERAGE: El país o la red móvil no son compatibles con los proveedores disponibles.
INVALID_PURPOSE: El propósito utilizado no es válido o no está permitido para este Insight.
UNAUTHORIZED: No se ha podido autorizar la solicitud para la combinación de solicitud, proveedor y número de teléfono.
INTERNAL_ERROR: Se ha producido un error interno al procesar la solicitud.
SUPPLIER_ERROR: El proveedor ha devuelto un error al procesar la solicitud.
NOT_FOUND: No se ha podido encontrar el número de teléfono para este Insight.
INVALID_NUMBER_FORMAT: El formato de número de teléfono no es válido para que las operadoras lo asignen a los usuarios.
OK: La entrada se ha procesado correctamente.
message Descripción más detallada del estado.

Lecturas complementarias