clj-ocgeo

A Clojure library for accessing the OpenCage Geocoding API

Usage

The client should have an API key by registering with the OpenCage Geocoder. It's also always good to check the best practices for using the OpenCage API, and in particular how to format forward geocoding queries.

To make a "forward" request to get the coordinates of a given place or address, the following function call can be used:

(require '[clj-ocgeo.core :as ocgeo])

(ocgeo/forward-request "Friedrich-Ebert-Straße 7, 48153 Münster, Germany" "6d0e711d72d74daeb2b0bfd2a5cdfdba")

Or a "reverse" request (i.e. given the latitude and longitude coordinates, it returns a list of human understandable place names or addresses):

(ocgeo/forward-request 51.9526599 7.632473 "6d0e711d72d74daeb2b0bfd2a5cdfdba")

Both functions return a Clojure Map with keyword keys so for example to get the status code of the response you can do:

(:status response)
;; Returns:
;; {:code 200, :message "OK"}

(For this specific example, you can also call the response-ok? helper function that returns true when the status code is 200)

A number of keyword arguments corresponding to the optional parameters of the OpenCage Geocoding API can be also supplied to both "request" functions, e.g.

(ocgeo/forward-request 51.9526599 7.632473 "6d0e711d72d74daeb2b0bfd2a5cdfdba"
		:countrycode "de" :no_annotations true :min_confidence 5)