GEO API PT

RESTful API which provides information on official divisional administrative regions of Portugal (based on "Carta Administrativa Oficial de Portugal, 2020", from here). It includes information on mainland Portugal, Azores and Madeira. It also provides information on Postal Codes and Census.

You can use freely the public API at https://geoapi.pt. The limit per IP is 900 requests per 15 minutes (average of 1/sec).

It uses NodeJS (much faster than Python) to create a HTTP server allowing several GET requests. It also pre-processes all the raw data for fast real-time delivery.

Routes

This API follows the OpenAPI Specification, thus you can see all the routes in the file openapi.yaml file. See also docs/routes.md or the main page at geoapi.pt.

JSON or HTML

By default the server replies with text/html format. To receive JSON format, chose one of these:

add the query GET parameter json=1 to the URL (ex.: /municipios/évora?json=1);
set the HTTP request header Accept as JSON, that is, Accept: application/json; or
in case you're using the public API, use the host json.geoapi.pt (ex: json.geoapi.pt/cp/2495-300)

Install this API on your machine

Install NodeJS and git
Clone the project (just the latest version):
git clone --depth=1 https://github.com/jfoclpf/geoapi.pt.git
Enter the newly created directory and install dependencies
cd geoapi.pt && npm ci
Start the server
npm start -- --port=8080

For more information run npm start -- --help

Continuous operation

For permanent and continuous operation (production) use for example pm2 or forever.

With pm2

npm install pm2@latest -g
pm2 start src/server/index.js -- --port 8080

Debug

DEBUG=geoapipt:* npm start --port=8080