[App Municipal] POIs

Organização: Município da Guarda
Tema: Economia
Licença: Creative Commons Attribution 4.0 International
Status: Approved
Última atualização: 20/12/2025
Descrição:

API para disponibilização estruturada de Pontos de Interesse relacionados com a área económica, permitindo acesso rápido e normalizado a dados sobre estabelecimentos, serviços e atividades que contribuem para o desenvolvimento local.

A API fornece informação em formato JSON, garantindo integração simples com portais, aplicações móveis e sistemas de gestão, com suporte para pesquisa, filtragem e categorização por setores económicos.

Funcionalidades principais:

  • Consulta de POIs por categoria (comércio, serviços, indústria, turismo).
  • Metadados completos: título, descrição, coordenadas GPS, contactos e horários.
  • Respostas otimizadas para integração com mapas interativos e dashboards.

Benefícios:

  • Informação centralizada e atualizada sobre a oferta económica local.
  • Apoio à promoção do território e à tomada de decisão estratégica.
  • Integração simplificada com plataformas de turismo, comércio e planeamento urbano.

Endpoints

NomeURLMétodo
Endpoint V1.0 https://od.mun-guarda.pt/api/appmunicipal/pois GET

Schemas

Schema URL
https://od.mun-guarda.pt/files/schemas/2025/schema_20251220112526.json
Schema Media Type
application/schema+json
Schema JSON
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "required": [
              "id",
              "status",
              "featured",
              "title",
              "mobile_phone",
              "phone",
              "email",
              "website",
              "created_at",
              "updated_at"
            ],
            "properties": {
              "id": {
                "type": "number"
              },
              "status": {
                "type": "string",
                "minLength": 1
              },
              "featured": {
                "type": "boolean"
              },
              "title": {
                "type": "string",
                "minLength": 1
              },
              "category": {
                "type": "array",
                "uniqueItems": true,
                "minItems": 1,
                "items": {
                  "required": [
                    "id",
                    "title"
                  ],
                  "properties": {
                    "id": {
                      "type": "number"
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1
                    }
                  }
                }
              },
              "mobile_phone": {
                "type": "string"
              },
              "phone": {
                "type": "string",
                "minLength": 1
              },
              "email": {
                "type": "string",
                "minLength": 1
              },
              "website": {
                "type": "string",
                "minLength": 1
              },
              "coordinates": {
                "type": "object",
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  }
                },
                "required": [
                  "lat",
                  "lng"
                ]
              },
              "image": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "minLength": 1
                  },
                  "alt": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "url",
                  "alt"
                ]
              },
              "images_gallery": {
                "type": "array",
                "uniqueItems": true,
                "minItems": 1,
                "items": {
                  "required": [
                    "url",
                    "alt"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "minLength": 1
                    },
                    "alt": {
                      "type": "string",
                      "minLength": 1
                    }
                  }
                }
              },
              "created_at": {
                "type": "string",
                "minLength": 1
              },
              "updated_at": {
                "type": "string",
                "minLength": 1
              }
            }
          }
        }
      },
      "required": [
        "items"
      ]
    }
  },
  "required": [
    "success",
    "data"
  ]
}

Ficheiros

NomeFormatoTamanho

Versão Atual

  • Status do Schema: Approved
  • Última Atualização: 20/12/2025 14:03
  • Versão Atual: 3