setLocationRaw method

  1. @experimental
DynamiteRawResponse<WeatherStatusSetLocationResponseApplicationJson, void> setLocationRaw({
  1. String? address,
  2. double? lat,
  3. double? lon,
  4. bool? oCSAPIRequest,
})

Set address and resolve it to get coordinates or directly set coordinates and get address with reverse geocoding.

This method and the response it returns is experimental. The API might change without a major version bump.

Returns a Future containing a DynamiteRawResponse with the raw HttpClientResponse and serialization helpers. Throws a DynamiteApiException if the API call does not return an expected status code.

Parameters:

  • address Any approximative or exact address.
  • lat Latitude in decimal degree format.
  • lon Longitude in decimal degree format.
  • oCSAPIRequest Required to be true for the API request to pass. Defaults to true.

Status codes:

  • 200: Location updated

See:

Implementation

@experimental
DynamiteRawResponse<WeatherStatusSetLocationResponseApplicationJson, void> setLocationRaw({
  String? address,
  double? lat,
  double? lon,
  bool? oCSAPIRequest,
}) {
  final _parameters = <String, dynamic>{};
  final _headers = <String, String>{
    'Accept': 'application/json',
  };

// coverage:ignore-start
  final authentication = _rootClient.authentications.firstWhereOrNull(
    (auth) => switch (auth) {
      DynamiteHttpBearerAuthentication() || DynamiteHttpBasicAuthentication() => true,
      _ => false,
    },
  );

  if (authentication != null) {
    _headers.addAll(
      authentication.headers,
    );
  } else {
    throw Exception('Missing authentication for bearer_auth or basic_auth');
  }

// coverage:ignore-end
  final $address = jsonSerializers.serialize(address, specifiedType: const FullType(String));
  _parameters['address'] = $address;

  final $lat = jsonSerializers.serialize(lat, specifiedType: const FullType(double));
  _parameters['lat'] = $lat;

  final $lon = jsonSerializers.serialize(lon, specifiedType: const FullType(double));
  _parameters['lon'] = $lon;

  var $oCSAPIRequest = jsonSerializers.serialize(oCSAPIRequest, specifiedType: const FullType(bool));
  $oCSAPIRequest ??= true;
  _headers['OCS-APIRequest'] = const dynamite_utils.HeaderEncoder().convert($oCSAPIRequest);

  final _path =
      UriTemplate('/ocs/v2.php/apps/weather_status/api/v1/location{?address*,lat*,lon*}').expand(_parameters);
  return DynamiteRawResponse<WeatherStatusSetLocationResponseApplicationJson, void>(
    response: _rootClient.executeRequest(
      'put',
      _path,
      _headers,
      null,
      const {200},
    ),
    bodyType: const FullType(WeatherStatusSetLocationResponseApplicationJson),
    headersType: null,
    serializers: jsonSerializers,
  );
}