Acesso e Estrutura

A API RESTful provê acesso programático aos metadados descritivos e dados vetoriais (GeoJSON) da plataforma Mapas de Fortaleza.

A estrutura informacional segue a seguinte hierarquia relacional: Categorias possuem Subcategorias, que por sua vez, agrupam coleções de Mapas.

Categorias

Retorna a lista de eixos temáticos raiz da plataforma.

Parâmetros (Query String)

• id (integer) - Filtra pelo ID exato da categoria.
• name (string) - Filtra pelo nome exato da categoria.

curl -X GET "https://mapas.fortaleza.ce.gov.br/api/v1/categories" \
  -H "Accept: application/json"

fetch('https://mapas.fortaleza.ce.gov.br/api/v1/categories')
  .then(response => response.json())
  .then(data => console.log(data));

[
  {
    "id": 1,
    "name": "Infraestrutura",
    "description": "Redes de serviços básicos..."
  }
]

Subcategorias

Retorna a lista de subcategorias, permitindo rastrear o mapeamento para uma categoria específica.

Parâmetros (Query String)

• id (integer) - Filtra pelo ID exato da subcategoria.
• category (integer) - Filtra subcategorias atreladas ao ID de uma categoria pai.

curl -X GET "https://mapas.fortaleza.ce.gov.br/api/v1/subcategories?category=1" \
  -H "Accept: application/json"

[
  {
    "id": 10,
    "name": "Saneamento",
    "description": "Redes de esgoto...",
    "category": "Infraestrutura"
  }
]

Mapas (Metadados)

Fornece o catálogo de entidades geográficas, retornando propriedades como tipo de geometria (Point, Polygon, LineString), fonte primária dos dados e ano de referência.

Parâmetros (Query String)

• id (integer) - ID único do mapa no banco de dados.
• type (string) - Filtra pelo tipo de geometria vetorial.

curl -X GET "https://mapas.fortaleza.ce.gov.br/api/v1/maps?type=Point" \
  -H "Accept: application/json"

[
  {
    "id": 42,
    "name": "Escolas Municipais",
    "type": "Point",
    "description": "Localização das escolas...",
    "source": "SME",
    "year": 2023
  }
]

GeoJSON (Vetor)

Retorna a projeção vetorial do mapa em formato GeoJSON RFC 7946, processando e encapsulando as feições geométricas e seus atributos tabulares em um FeatureCollection.

Parâmetros Obrigatórios

• id (integer) - ID do mapa-alvo.

Parâmetros Opcionais

• download (boolean) - Força o response como 'application/octet-stream' para download do arquivo `.json`.

fetch('https://mapas.fortaleza.ce.gov.br/api/v1/geojson?id=42')
  .then(res => res.json())
  .then(geojson => {
    // Processamento da geometria
    console.log(geojson.features.length);
  });

import geopandas as gpd

url = "https://mapas.fortaleza.ce.gov.br/api/v1/geojson?id=42"
gdf = gpd.read_file(url)

print(gdf.head())