List up to three locations, their primary/alternate names, coordinates, and default status.

Search a real place name for geographic candidates without changing settings.

Use country_code (JP by default) for the country. Check administrative regions when names are ambiguous. Japanese ward names use GSI as a fallback.

Add a location requested by the user. Only location settings are persisted.

Example: alias=Office, place_name=Osaka, Japan, country_code=JP. At most three locations. additional_aliases supplies alternate names. make_default=true selects this location when alias is omitted in weather_get. Multiple geocoding matches are returned without saving; pass a selected candidate_id as a string. Use weather_update_location to modify an existing location.

Update an existing location without adding a slot.

alias identifies the location using any current name. Changing place_name resolves new coordinates. new_alias renames the primary alias. additional_aliases replaces the alternate names; [] removes them. Omitted fields remain unchanged. make_default=true selects this place as the default. Ambiguous geocoding returns candidates without saving. Retry with the selected candidate_id as a string.

Remove a location as requested. Removing the default selects the first remaining location.

Fetch fresh weather for a registered primary or alternate name.

Omit alias to use the default (initially Tokyo). target: current, today, or tomorrow. Forecasts include temperature_range: value_c, threshold_c, is_large (>= threshold), and basis=daily_max_minus_min. Missing/invalid temperatures yield null value and flag. Includes rain intervals and temperature/umbrella advice. Today's rain covers the remaining hours. include_hourly=true adds hourly values. Units: Celsius, m/s, mm; timestamps use the location timezone. No weather storage, cache or scheduling. language=en|ja overrides the server default. Both summary_en and summary_ja are included for forecasts; summary and weather labels use the selected language.