Documentación API

Volver al inicio

Cómo funciona la API de Orion

Orion permite resolver coordenadas geográficas con datos de identidad de celda usando una integración simple y robusta.

API v1Respuesta JSONAutenticación por API key
POST/api/v1/lookup

Este endpoint resuelve coordenadas geográficas a partir de identidad de celda. Orion busca usando solo los campos presentes en el body.

Base URL

https://api.orion.geminislabs.com/api/v1/

Headers requeridos

x-api-key: <tu-api-key>

Content-Type: application/json

Validación de búsqueda

Debes enviar al menos uno de estos campos:mccmnclaccid

El parámetro include acepta solamente el valor "cell".

Requests

POST /api/v1/lookup
curl -X POST https://api.orion.geminislabs.com/api/v1/lookup \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcc": 310,
    "mnc": 260,
    "lac": "F303",
    "cid": 5678,
    "include": ["cell"]
  }'

Búsqueda parcial

{
  "lac": "F303"
}

Búsqueda completa

{
  "mcc": 310,
  "mnc": 260,
  "lac": "F303",
  "cid": 5678,
  "include": ["cell"]
}

Responses

200 OKSin include
{
  "matches": [
    {
      "lat": 40.416775,
      "lon": -3.70379,
      "confidence": 1.0
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8"
  }
}
200 OKCon include: ["cell"]
{
  "matches": [
    {
      "lat": 41.18549,
      "lon": -80.361315,
      "confidence": 1.0,
      "cell": {
        "mcc": 310,
        "mnc": 260,
        "lac": "F303",
        "cellid": "12345"
      }
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8"
  }
}

Campos del body

CampoTipoRequeridoDescripción
mccnumberNoMobile Country Code.
mncnumberNoMobile Network Code.
lacstringNoLocation Area Code en hexadecimal, ejemplo "F303".
cidnumberNoCell ID.
includearrayNoSolo acepta el valor ["cell"].

Cómo empezar

  • 1Crear cuenta y verificar el correo
  • 2Generar API Key desde el panel de Geminis Labs
  • 3Hacer la primera consulta

El registro toma menos de un minuto.

Buenas prácticas

Envío mínimo

Para reducir latencia, envia solo los campos disponibles en tu fuente.

Trazabilidad

Guarda meta.request_id en logs para depurar incidentes con soporte tecnico.

Resiliencia

Aplica timeout y reintentos con backoff para mantener la integración estable.