🧭 Obtendo a distância entre CEPs

Exemplo de uso

Você deve distâncias no seguinte padrão:

GET https://api.brasilaberto.com/v1/distance?pointA={pointA}&pointB={pointB}&mode={mode}

Atualmente, somente o modo STRAIGHT_LINE (ou linha reta) está disponível. O cálculo é baseado em dados do Instituto Nacional de Pesquisas Espaciais, retornando o valor aproximado considerando uma linha reta entre os dois pontos. Estamos trabalhando para disponibilizar outros tipos de cálculo, como distância considerando meios de transporte terrestres. Supondo que você queira obter a distância em linha reta entre o CEP 26277-645 e o cep 29703-270, realize a seguinte consulta:

// GET https://api.brasilaberto.com/v1/distance?pointA=29703270&pointB=26277645&mode=STRAIGHT_LINE
{
  "meta": {
    "currentPage": 1,
    "itemsPerPage": 1,
    "totalOfItems": 1,
    "totalOfPages": 1
  },
  "result": {
    "pointA": {
      "street": "Rua Nossa Senhora Aparecida",
      "complement": "",
      "district": "São Silvano",
      "districtId": 24722,
      "city": "Colatina",
      "cityId": 788,
      "ibgeId": 3201506,
      "state": "Espírito Santo",
      "stateShortname": "ES",
      "zipcode": "29703270",
      "coordinates": {
        "latitude": -19.52258,
        "longitude": -40.6368
      }
    },
    "pointB": {
      "street": "Rua Cajurana",
      "complement": "",
      "district": "Jardim Palmares",
      "districtId": 22687,
      "city": "Nova Iguaçu",
      "cityId": 669,
      "ibgeId": 3303500,
      "state": "Rio de Janeiro",
      "stateShortname": "RJ",
      "zipcode": "26277645",
      "coordinates": {
        "latitude": -22.75901,
        "longitude": -43.51527
      }
    },
    "distance": 462.48,
    "unit": "Km"
  }
}

Status de retorno

200 Sucesso
404 Cep inexistente
500 Erro na nossa API