Esta API JSON é acessível através do domínio json.geoapi.pt e é pública e de acesso gratuito, mas apresenta um limite conservador de 30 pedidos por dia por cada IP.

Caso queira ter acesso ilimitado através de self-hosting, ou seja, caso queira instalar esta API na sua máquina ou no seu servidor sem qualquer limitação ou restrição, tal envolve um patrocínio no Github tendo um custo unitário e único de 99 USD. A implementação é compatível com qualquer máquina (Linux, Windows ou Mac) pois é efetuada através de docker.

Primeiro entra-se na conta:
docker login -u jfoclpf -p {CHAVE}

Depois faz-se o 'pull' do 'container' para a sua máquina:
docker pull jfoclpf/geoapi.pt:latest

E corre-se o 'container':
docker run -t -p 8080:8080 jfoclpf/geoapi.pt:latest

Caso queira correr em pano de fundo:
docker run -p 8080:8080 -d jfoclpf/geoapi.pt:latest

Caso queira configurar as variáveis internas:
docker run -e geoapipt_mainTitle='A minha GEO API' \
  -e geoapipt_description='Esta é a minha API personalizada' \
  -e geoapipt_defaultOrigin='https://geoapi.mydomain.pt' \
  -e geoapipt_jsonApiOrigin='https://json.geoapi.mydomain.pt' \
  -p 8080:8080 \
  jfoclpf/geoapi.pt:latest


Para depois obter resultados em JSON, escolher uma das opções:

• - adicionar a variável json=1 ao pedido GET, ex: http://localhost:8080/cp/2495-300?json=1; ou
• - colocar Accept: application/json no cabeçalho HTTP do pedido

Pedido da Chave

Para pedir a sua Chave, faça o seu patrocínio AQUI. Após fazer o seu patrocínio contacte-nos, reenviando-nos o seu username do Github, para obter a sua Chave.