Account Management
To use the Geodesic API you must first authenticate your account with our the platform. This can be done either from Python or from the command line.
CLI Authentication
geodesic authenticate
returns:
geodesic authenticate
To authorize access needed by Geodesic, open the following URL in a web browser and follow the instructions.
If the web browser does not start automatically, please manually browse the URL below.
A browser window should open and you will see the following screen.
{
"api_key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
if you have already authenticated, you will see:
Authentication successful!
Credentials have been retrieved. Please close this window.
Python Authentication
Python authentication can be done either in the python interpreter or a Jupyter environment.
import geodesic
geodesic.authenticate()
note
You will not need to log in each time you use the API. The credentials stored are long lived. If you
are worried that you may have copied the key incorrectly you can check the stored credentials in
~/.config/geodesic/config.json
file.