Reference codebooks · lookupReferencePeIneiUbigeo
OpenAPI

Peru district geography codebook

GET https://api.latinfo.dev/pe/inei/ubigeo/{code}

A district code and administrative hierarchy with reference coordinates. Use the six-digit UBIGEO district code. Preserve leading zeros. Coordinates locate the district reference point, not a company establishment.

Contrato da fonte

Publicador
INEI; augmented codebook by Jose M. Castagnetto
Cobertura
Peruvian districts in the augmented UBIGEO codebook.
Significado do registro
A district code and administrative hierarchy with reference coordinates.
Identificador
Use the six-digit UBIGEO district code. Preserve leading zeros.
Padrão aceito
^\d{6}$
Quantidade de registros
one
Licença
A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

  • Coordinates locate the district reference point, not a company establishment.

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

codestringpathobrigatório

Use the six-digit UBIGEO district code. Preserve leading zeros.

Example: 130101

Exemplo de requisição

curl https://api.latinfo.dev/pe/inei/ubigeo/130101 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

200Codebook entry; values and identifiers remain strings.
Content-Type: application/json

Campos da resposta

ubigeo string obrigatório
departamento string obrigatório

Published department name.

provincia string obrigatório

Published province name.

distrito string obrigatório

Published district name.

latitude string obrigatório

District reference latitude; not the company coordinates.

longitude string obrigatório

District reference longitude; not the company coordinates.

Esquema de resposta
{
  "type": "object",
  "required": [
    "ubigeo",
    "departamento",
    "provincia",
    "distrito",
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "properties": {
    "ubigeo": {
      "type": "string"
    },
    "departamento": {
      "type": "string",
      "description": "Published department name."
    },
    "provincia": {
      "type": "string",
      "description": "Published province name."
    },
    "distrito": {
      "type": "string",
      "description": "Published district name."
    },
    "latitude": {
      "type": "string",
      "description": "District reference latitude; not the company coordinates."
    },
    "longitude": {
      "type": "string",
      "description": "District reference longitude; not the company coordinates."
    }
  }
}
400Invalid code format
Nenhum corpo de resposta documentado.
401Chave de api ausente ou inválida
Nenhum corpo de resposta documentado.
404Code not in this reference snapshot
Nenhum corpo de resposta documentado.
429Request limit exceeded
Nenhum corpo de resposta documentado.
503Reference source unavailable
Nenhum corpo de resposta documentado.
Exemplo JSON

Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.

{
  "ubigeo": "string",
  "departamento": "string",
  "provincia": "string",
  "distrito": "string",
  "latitude": "string",
  "longitude": "string"
}

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.