Switching and adding OpenStreetMap data APIs

Switching and adding OpenStreetMap data APIs#

Simon Poole 20250826

Vespucci supports utilizing multiple instances of the OpenStreetMap API, and has configurations for the default OpenStreetMap instance, the developer sandbox, and OpenHistoricalMap (since V21.1.2). Currently only one configuration can be active at any one time.

Switching between existing configurations#

Activate the target entry by checking the corresponding checkbox#

Return to the main screen#

Authorize the app with the new API#

If you haven't used the newly selected API earlier and the API instances uses OAuth (all pre-configured API instances do) you will need to authorize the app. You will automatically be asked to do this on an upload if you didn't do this previously, however it is likely more convenient for you to start the process manually.

Depending on the dimensions of your device the tools menu will either be directly availably from the bottom menu (spanner button), or from the overflow (three dots) menu.

Select Authorize OAuth...#

A browser-like window will open and you will be requested to login and confirm the authorization of the app.

Adding a new configuration#

Adding a new configuration is complicated by the fact that most target APIs require OAuth authorization and you need to provide a client key to support that. However if you simply want to modify an existing entry, for example by adding a read only source, you can copy the entry and modify it retaining the exiting client keys, as long as the API URL remains the same.

Adding additional OAuth client keys#

Obtain a new client key for the app, create a vespucci key file and add it to the configuration by using Load keys from file....

An example key file can be found here (to add a key you only need the relevant entry): keys2-default.txt.

Switching and adding OpenStreetMap data APIs