ICGC Geocoder

Geocoding is the process of turning addresses and place names into geographic coordinates.

The ICGC Geocoder allows you to obtain the coordinates of a place located in Catalonia from its postal address or its name (toponym). It also allows the opposite operation, reverse geocoding, which consists of turning geographic coordinates into places and addresses.

Connection URL: https://eines.icgc.cat/geocodificador

The ICGC Geocoder is a Web Application Programming Interface API REST, embeddable into other applications, making it simple to add an address finder to a map viewer.

Functions

• Search for postal addresses of the following types:
  • House number (street name + house number + municipality or llogaret).
  • Isolated building (name of the isolated building + municipality or llogaret).
• Search for streets (street name + municipality or llogaret).
• Get the bounding box of a street.
• Search for toponyms (name + municipality).
• Reverse geocoding: to get the list of places near a given latitude/longitude point.
• Search within a circular or rectangular geographic area.
• Search within a 'comarca' or a municipality.
• Narrow the search to certain types of toponyms.
• Prioritize results by proximity.
• Availability of two direct geocoding endpoints, which are advisable to combine:
  • autocompletar: to give real-time result suggestions without having to type the whole location
  • cerca (whole search): Once the text has been completed, if the answers provided by autocompletar are not sufficient, a request can be made to the cerca operation.

It is recommended to use client libraries that incorporate these usage guidelines, such as Leaflet and the Nextzen (formerly Mapzen) plugin, as done in the example Viewer, implemented with Leaflet and explained in Map Viewer with queries to the ICGC Geocoding service

Operations

It has the following operations:

• cerca (direct geocoding typing the whole location)

• autocompletar (direct geocoding without having to type the whole location)

• reverse (reverse geocoding)

Documentation

https://eines.icgc.cat/geocodificador/api-docs/

Examples

• 1.1 Search for a postal address
• 1.2 Search for a toponym
• 1.3 Reverse Geocoding
• 1.4 Get the 'llogaret' to which an address belongs
• 1.5 Search for a postal address according to the 'llogaret'
• 1.6 Integration in a Leaflet viewer
• 1.7 Prioritize the results closest to a point
• 1.8 Narrow the search within a circular or rectangular geographic area
• 1.9 Filter by toponym type
• 1.10 Filter by 'comarca' or municipality
• 1.11 Other integration examples

Viewer

Viewer