Geocoding

Manage reverse-geocoding results (address, city, and country resolved for stay locations). Correct names, re-resolve locations with a different provider, and define normalization rules that rename cities or countries consistently.

📄️ List geocoding results

Returns the reverse-geocoding results used by the signed-in user's stays, one page at a time, with optional provider and text filters.

📄️ Set city or country of several results

Sets the city, the country, or both, on several geocoding results at once. Shared provider results are not changed: the first edit creates a private copy for the signed-in user, and the user's stays are updated to use it.

📄️ List normalization rules

Returns the signed-in user's rules for renaming cities or countries, for example 'Kiev' to 'Kyiv'.

📄️ Create a normalization rule

Creates a rule that renames a country (`ruleType: COUNTRY`) or a city within a country (`ruleType: CITY`). New favorites and re-resolved locations use the rule automatically; apply it to existing data with the apply endpoints.

📄️ Apply all normalization rules

Starts a background job that applies all of the user's normalization rules to existing geocoding results, favorites, or both. Poll `GET /api/v1/geocoding/reconcile/jobs/{jobId}` for progress. Only one such job per user can run at a time.

📄️ Update a normalization rule

Changes the source or target names of a normalization rule. Existing data is not changed until the rule is applied.

📄️ Delete a normalization rule

Deletes a normalization rule. Names it already changed stay as they are.

📄️ Apply one normalization rule

Starts a background job that applies a single normalization rule to existing geocoding results, favorites, or both. Poll `GET /api/v1/geocoding/reconcile/jobs/{jobId}` for progress. Only one such job per user can run at a time.

📄️ List geocoding providers

Returns the geocoding providers enabled on this server, which can be used for re-resolving locations.

📄️ List providers used by your data

Returns the names of the providers that produced the signed-in user's geocoding results, for filtering.

📄️ Re-resolve geocoding results

Starts a background job that looks up locations again with a chosen geocoding provider and updates the results that changed. Pass specific `geocodingIds`, or set `reconcileAll` with an optional provider filter. Poll `GET /api/v1/geocoding/reconcile/jobs/{jobId}` for progress. Only one such job per user can run at a time.