Microsoft Azure Maps Weather Service

swagger: '2.0'
info:
  title: Microsoft Azure Azure Maps Weather Service
  version: '1.0'
host: atlas.microsoft.com
schemes:
  - https
consumes: []
produces:
  - application/json
securityDefinitions:
  AADToken:
    type: oauth2
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
    flow: implicit
    description: >-
      These are the [Microsoft Entra OAuth
      2.0](https://docs.microsoft.com/azure/active-directory/develop/v1-overview)
      Flows. When paired with [Azure role-based
      access](https://docs.microsoft.com/azure/role-based-access-control/overview)
      control it can be used to control access to Azure Maps REST APIs. Azure
      role-based access controls are used to designate access to one or more
      Azure Maps resource account or sub-resources. Any user, group, or service
      principal can be granted access via a  built-in role or a custom role
      composed of one or more permissions to Azure Maps REST APIs.


      To implement scenarios, we recommend viewing [authentication
      concepts](https://aka.ms/amauth). In summary, this security definition
      provides a solution for modeling application(s) via objects capable of
      access control on specific APIs and scopes.


      #### Notes

      * This security definition **requires** the use of the `x-ms-client-id`
      header to indicate which Azure Maps resource the application is requesting
      access to. This can be acquired from the [Maps management
      API](https://aka.ms/amauthdetails).

      * 

      The `Authorization URL` is specific to the Azure public cloud instance.
      Sovereign clouds have unique Authorization URLs and Microsoft Entra ID
      configurations. 

      * 

      The Azure role-based access control is configured from the [Azure
      management plane](https://aka.ms/amrbac) via Azure portal, PowerShell,
      CLI, Azure SDKs, or REST APIs.

      * 

      Usage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for
      configuration based setup of an application for multiple use cases.

      * For more information on Microsoft identity platform, see [Microsoft
      identity platform
      overview](https://learn.microsoft.com/entra/identity-platform/v2-overview).
    scopes:
      https://atlas.microsoft.com/.default: https://atlas.microsoft.com/.default
  SharedKey:
    type: apiKey
    description: >-
      This is a shared key that is provisioned when you [Create an Azure Maps
      account](https://docs.microsoft.com/azure/azure-maps/quick-demo-map-app#create-an-azure-maps-account)
      in the Azure portal or using PowerShell, CLI, Azure SDKs, or REST API.

       With this key, any application can access all REST API. In other words, this key can be used as a master key in the account that they are issued in.

       For publicly exposed applications, our recommendation is to use the [confidential client applications](https://docs.microsoft.com/azure/azure-maps/authentication-best-practices#confidential-client-applications) approach to access Azure Maps REST APIs so your key can be securely stored.
    name: subscription-key
    in: query
  SasToken:
    type: apiKey
    description: >-
      This is a shared access signature token is created from the List SAS
      operation on the [Azure Maps resource](https://aka.ms/amauth) through the
      Azure management plane via Azure portal, PowerShell, CLI, Azure SDKs, or
      REST APIs.

       With this token, any application is authorized to access with Azure role-based access controls and fine-grain control to the expiration, rate, and region(s) of use for the particular token. In other words, the SAS Token can be used to allow applications to control access in a more secured way than the shared key.

       For publicly exposed applications, our recommendation is to configure a specific list of allowed origins on the [Map account resource](https://aka.ms/amauth) to limit rendering abuse and regularly renew the SAS Token.
    name: SAS Token
    in: header
security:
  - AADToken:
      - https://atlas.microsoft.com/.default
  - SharedKey: []
  - SasToken: []
responses:
  '400':
    description: >-
      Bad request: one or more parameters were incorrectly specified or are
      mutually exclusive.
    schema:
      $ref: '#/definitions/ODataErrorResponse'
  '401':
    description: >-
      Access denied due to invalid subscription key or invalid Microsoft Entra
      ID bearer token.  Make sure to provide a valid key for an active Azure
      subscription and Maps resource.  Otherwise, verify the
      [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#section-3.1) header
      for error code and description of the provided Microsoft Entra ID bearer
      token.
    schema:
      $ref: '#/definitions/ODataErrorResponse'
    headers:
      WWW-Authenticate:
        type: string
        description: >-
          Bearer realm="https://atlas.microsoft.com/", error="invalid_token",
          error_description="The access token expired"
  '403':
    description: Permission, capacity, or authentication issues.
    schema:
      $ref: '#/definitions/ODataErrorResponse'
  '404':
    description: >-
      Not Found: the requested resource could not be found, but it may be
      available again in the future.
    schema:
      $ref: '#/definitions/ODataErrorResponse'
  '500':
    description: An error occurred while processing the request. Please try again later.
    schema:
      $ref: '#/definitions/ODataErrorResponse'
parameters:
  ClientId:
    name: x-ms-client-id
    description: >-
      Specifies which account is intended for usage in conjunction with the
      Microsoft Entra ID security model.  It represents a unique ID for the
      Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Microsoft Entra ID security in Azure Maps see
      the following [articles](https://aka.ms/amauthdetails) for guidance.
    type: string
    in: header
    required: false
    x-ms-parameter-location: client
  SubscriptionKey:
    name: subscription-key
    description: >-
      One of the Azure Maps keys provided from an Azure Map Account. Please
      refer to this
      [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication)
      for details on how to manage authentication.
    type: string
    in: query
    required: false
    x-ms-parameter-location: client
  ApiVersion:
    name: api-version
    description: Version number of Azure Maps API. Current version is 1.0
    type: string
    in: query
    required: true
    default: '1.0'
    x-ms-parameter-location: client
  JsonFormat:
    name: format
    description: Desired format of the response. Only `json` format is supported.
    type: string
    in: path
    required: true
    enum:
      - json
    x-ms-enum:
      name: JsonFormat
      modelAsString: true
      values:
        - value: json
          description: >-
            [The JavaScript Object Notation Data Interchange
            Format](https://tools.ietf.org/html/rfc8259)
    x-ms-parameter-location: method
  WeatherLanguage:
    name: language
    description: >-
      Language in which search results should be returned. Should be one of
      supported IETF language tags, case insensitive. When data in specified
      language is not available for a specific field, default language is used.  Default value is en-us. 


      Please refer to [Supported
      languages](https://docs.microsoft.com/azure/azure-maps/supported-languages)
      for details.
    type: string
    in: query
    required: false
    x-ms-parameter-location: method
  WeatherUnit:
    name: unit
    description: >-
      Specifies to return the data in either metric units or imperial units.
      Default value is metric.
    default: metric
    in: query
    type: string
    required: false
    enum:
      - metric
      - imperial
    x-ms-enum:
      name: Unit
      modelAsString: true
      values:
        - value: metric
          description: >-
            Return data in metric units. Some example units of metric system are
            Celsius and kilometer.
        - value: imperial
          description: >-
            Return data in imperial units. Some example units of imperial system
            are Fahrenheit and mile.
    x-ms-parameter-location: method
paths:
  /weather/forecast/hourly/{format}:
    get:
      description: >-
        **Get Hourly Forecast**<br><br>**Applies to**: S0 and S1 pricing
        tiers.<br><br><br>Request detailed weather forecast by the hour for the
        next 1, 12, 24 (1 day), 72 (3 days), 120 (5 days), and 240 hours (10
        days) for the given the given coordinate location.  The API returns
        details such as temperature, humidity, wind, precipitation, and
        ultraviolet (UV) index.<br><br>In S0 you can request hourly forecast for
        the next 1, 12, 24 hours (1 day), and 72 hours (3 days). In S1 you can
        also request hourly forecast for the next 120 (5 days) and 240 hours (10
        days).
      operationId: microsoftAzureWeatherGethourlyforecast
      x-ms-examples:
        HourlyForecast:
          $ref: ./examples/GetHourlyForecast.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which hourly forecast information is
            requested. The applicable query is specified as a comma separated
            string composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherUnit'
        - name: duration
          description: >-
            Time frame of the returned weather forecast. By default, the
            forecast data for next hour will be returned. Available values are
              * `1` - Return forecast data for the next hour. Default value.
              * `12` - Return hourly forecast for next 12 hours.
              * `24` - Return hourly forecast for next 24 hours.
              * `72` - Return hourly forecast for next 72 hours (3 days).
              * `120` - Return hourly forecast for next 120 hours (5 days). Only available in S1 SKU. 
              * `240` - Return hourly forecast for next 240 hours (10 days). Only available in S1 SKU.
          default: 1
          in: query
          type: integer
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/HourlyForecastResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Forecast Hourly Format
      tags:
        - Weather
  /weather/forecast/minute/{format}:
    get:
      description: >-
        **Get Minute Forecast**<br>  <br>  <br>**Applies to**: S1 pricing
        tier.<br><br><br>Get Minute Forecast service returns minute-by-minute
        forecasts for a given location for the next 120 minutes.  Users can
        request weather forecasts in the interval of 1, 5 and 15 minutes.  The
        response will include details such as the type of precipitation
        (including rain, snow, or a mixture of both), start time, and
        precipitation intensity value (dBZ).
      operationId: microsoftAzureWeatherGetminuteforecast
      x-ms-examples:
        MinuteForecast:
          $ref: ./examples/GetMinuteForecast.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which minute forecast information is
            requested. The applicable query is specified as a comma separated
            string composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - name: interval
          description: >-
            Specifies time interval in minutes for the returned weather
            forecast. Supported values are
              * `1` -  Retrieve forecast for 1-minute intervals. Returned by default.
              * `5` - Retrieve forecasts for 5-minute intervals.
              * `15` - Retrieve forecasts for 15-minute intervals.
          default: 1
          in: query
          type: integer
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/MinuteForecastResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Forecast Minute Format
      tags:
        - Weather
  /weather/forecast/quarterDay/{format}:
    get:
      description: >-
        **Get Quarter-Day Forecast**<br>  <br>  <br>**Applies to**: S0 and S1
        pricing tiers.<br><br><br>Service returns detailed weather forecast by
        quarter-day for the next 1, 5, 10, or 15 days for a given location.
        Response data is presented by quarters of the day - morning, afternoon,
        evening, and overnight. Details such as temperature, humidity, wind,
        precipitation, and UV index are returned.
      operationId: microsoftAzureWeatherGetquarterdayforecast
      x-ms-examples:
        QuarterDayForecast:
          $ref: ./examples/GetQuarterDayForecast.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which quarter-day forecast
            information is requested. The applicable query is specified as a
            comma separated string composed by latitude followed by longitude
            e.g. "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherUnit'
        - name: duration
          description: >-
            Specifies for how many days the quester-day forecast responses are
            returned. Supported values are:
              * `1` - Return forecast data for the next day. Returned by default.
              * `5` - Return forecast data for the next 5 days.
              * `10` - Return forecast data for next 10 days.
              * `15` - Return forecast data for the next 15 days.
          default: 1
          in: query
          type: integer
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/QuarterDayForecastResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Forecast Quarterday Format
      tags:
        - Weather
  /weather/currentConditions/{format}:
    get:
      description: >-
        **Get Current Conditions**<br>  <br>  <br>**Applies to**: S0 and S1
        pricing tiers.<br><br><br>Get Current Conditions service returns
        detailed current weather conditions such as precipitation, temperature
        and wind for a given coordinate location. Also, observations from the
        past 6 or 24 hours for a particular location can be retrieved. The basic
        information returned with the response include details such as
        observation date and time, brief description of the weather conditions,
        weather icon, precipitation indicator flags, and temperature. Additional
        details such as RealFeel™ Temperature and UV index are also returned.
      operationId: microsoftAzureWeatherGetcurrentconditions
      x-ms-examples:
        CurrentConditions:
          $ref: ./examples/GetCurrentConditions.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which current conditions information
            is requested. The applicable query is specified as a comma separated
            string composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherUnit'
        - name: details
          description: |-
            Return full details for the current conditions. Available values are
              * `true` - Returns full details. By default all details are returned.
              * `false` - Returns a truncated version of the current condition data, which includes observation date time, weather phrase, icon code, precipitation indicator flag, and temperature.
          default: 'true'
          in: query
          type: string
        - name: duration
          description: >-
            Time frame of the returned weather conditions. By default, the most
            current weather conditions will be returned. Default value is 0.
            Supported values are:
               * `0` - Return the most current weather conditions.
               * `6` - Return weather conditions from past 6 hours.
               * `24` - Return weather conditions from past 24 hours.
          default: 0
          in: query
          type: integer
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/CurrentConditionsResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Currentconditions Format
      tags:
        - Weather
  /weather/forecast/daily/{format}:
    get:
      description: >-
        **Get Daily Forecast**<br>  <br>  <br>**Applies to**: S0 and S1 pricing
        tiers.<br><br><br>The service returns detailed weather forecast such as
        temperature and wind by day for the next 1, 5, 10, 15, 25, or 45 days
        for a given coordinate location.  The response include details such as
        temperature, wind, precipitation, air quality, and UV index.<br><br>In
        S0 you can request daily forecast for the next 1, 5, 10, and 15 days. In
        S1 you can also request daily forecast for the next 25 days, and 45
        days.
      operationId: microsoftAzureWeatherGetdailyforecast
      x-ms-examples:
        DailyForecast:
          $ref: ./examples/GetDailyForecast.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which current conditions information
            is requested. The applicable query is specified as a comma separated
            string composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherUnit'
        - name: duration
          description: >-
            Specifies for how many days the daily forecast responses are
            returned. Available values are
              * `1` - Return forecast data for the next day. Returned by default.
              * `5` - Return forecast data for the next 5 days.
              * `10` - Return forecast data for the next 10 days.
              * `25` - Return forecast data for the next 25 days. Only available in S1 SKU.
              * `45` - Return forecast data for the next 45 days. Only available in S1 SKU.
          default: 1
          in: query
          type: integer
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/DailyForecastResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Forecast Daily Format
      tags:
        - Weather
  /weather/route/{format}:
    get:
      description: >-
        **Get Weather along route**<br>   <br>   <br> **Applies to**: S1 pricing
        tier.<br><br> Weather along a route API returns hyper local (one
        kilometer or less), up-to-the-minute weather nowcasts, weather hazard
        assessments, and notifications along a route described as a sequence of
        waypoints. <br> This includes a list of weather hazards affecting the
        waypoint or route, and the aggregated hazard index for each waypoint
        might be used to paint each portion of a route according to how safe it
        is for the driver. When submitting the waypoints, it is recommended to
        stay within, or close to, the distance that can be traveled within
        120-mins or shortly after. Data is updated every five minutes. <br> <br>
        The service supplements Azure Maps [Route
        Service](https://docs.microsoft.com/rest/api/maps/route) that allows you
        to first request a route between an origin and a destination and use
        that as an input for Weather Along Route endpoint.<br> <br> In addition,
        the service supports scenarios to generate weather notifications for
        waypoints that experience an increase in intensity of a weather hazard.
        For example, if the vehicle is expected to begin experiencing heavy rain
        as it reaches a waypoint, a weather notification for heavy rain will be
        generated for that waypoint allowing the end product to display a heavy
        rain notification before the driver reaches that waypoint. <br> The
        trigger for when to display the notification for a waypoint could be
        based, for example, on a
        [geofence](https://docs.microsoft.com/azure/azure-maps/tutorial-iot-hub-maps),
        or selectable distance to the waypoint.<br><br> The API covers all
        regions of the planet except latitudes above Greenland and Antarctica.
      operationId: microsoftAzureWeatherGetweatheralongroute
      x-ms-examples:
        WeatherAlongRoute:
          $ref: ./examples/GetWeatherAlongRoute.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates through which the route is calculated, separated by
            colon (:) and entered in chronological order. A minimum of two
            waypoints is required. A single API call may contain up to 60
            waypoints. 

            A waypoint indicates location, ETA, and optional heading:
            latitude,longitude,ETA,heading, where
              * `Latitude` - Latitude coordinate in decimal degrees.
              * `Longitude` - Longitude coordinate in decimal degrees.
              * `ETA (estimated time of arrival)` - The number of minutes from the present time that it will take for the vehicle to reach the waypoint. Allowed range is from 0.0 to 120.0 minutes.
              * `Heading` - An optional value indicating the vehicle heading as it passes the waypoint. Expressed in clockwise degrees relative to true north. This is issued to calculate sun glare as a driving hazard. Allowed range is from 0.0 to 360.0 degrees. If not provided, a heading will automatically be derived based on the position of neighboring waypoints.

            It is recommended to stay within, or close to, the distance that can
            be traveled within 120-mins or shortly after. This way a more
            accurate assessment can be provided for the trip and prevent
            isolated events not being captured between waypoints.  Information
            can and should be updated along the route (especially for trips
            greater than 2 hours) to continuously pull new waypoints moving
            forward, but also to ensure that forecast information for content
            such as precipitation type and intensity is accurate as storms
            develop and dissipate over time.
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherLanguage'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/WeatherAlongRouteResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Route Format
      tags:
        - Weather
  /weather/severe/alerts/{format}:
    get:
      description: >-
        **Get Severe Weather Alerts**<br><br>**Applies to**: S0 and S1 pricing
        tiers.<br><br>Severe weather phenomenon can significantly impact our
        everyday life and business operations. For example, severe weather
        conditions such as tropical storms, high winds or flooding can close
        roads and force logistics companies to reroute their fleet causing
        delays in reaching destinations and breaking the cold chain of
        refrigerated food products.  Azure Maps Severe Weather Alerts API
        returns the severe weather alerts that are available worldwide
        from both official Government Meteorological Agencies and leading
        global to regional weather alert providers. The service can return
        details such as alert type, category, level and detailed description
        about the active severe alerts for the requested location, like
        hurricanes, thunderstorms, lightning, heat waves or forest fires.
      operationId: microsoftAzureWeatherGetsevereweatheralerts
      x-ms-examples:
        SevereWeatherAlert:
          $ref: ./examples/GetSevereWeatherAlerts.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which severe weather alerts are
            requested. The applicable query is specified as a comma separated
            string composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherLanguage'
        - name: details
          description: >-
            Return full details for the severe weather alerts. Available values
            are
              * `true` - Returns full details. By default all details are returned.
              * `false` - Returns a truncated version of the alerts data, which excludes the area-specific full description of alert details (`alertDetails`).
          default: 'true'
          in: query
          type: string
      responses:
        '200':
          description: OK,
          schema:
            $ref: '#/definitions/SevereWeatherAlertsResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Severe Alerts Format
      tags:
        - Weather
  /weather/indices/daily/{format}:
    get:
      description: >-
        **Get Daily Indices**<br><br>**Applies to**: S0 and S1 pricing
        tiers.<br><br>There may be times when you want to know if the weather
        conditions are optimal for a specific activity, for example, for outdoor
        construction, indoor activities, running or farming including soil
        moisture information.  Azure Maps Indices API returns index values that
        will guide end users to plan future activities. For example, a health
        mobile application can notify users that today is good weather for
        running or for other outdoors activities like for playing golf, and
        retail stores can optimize their digital marketing campaigns based on
        predicted index values. The service returns in daily indices values for
        current and next 5, 10 and 15 days starting from current day.
      operationId: microsoftAzureWeatherGetdailyindices
      x-ms-examples:
        DailyIndices:
          $ref: ./examples/GetDailyIndices.json
      parameters:
        - $ref: '#/parameters/ClientId'
        - $ref: '#/parameters/SubscriptionKey'
        - $ref: '#/parameters/ApiVersion'
        - $ref: '#/parameters/JsonFormat'
        - name: query
          description: >-
            Coordinates of the location for which daily indices are requested.
            The applicable query is specified as a comma separated string
            composed by latitude followed by longitude e.g.
            "47.641268,-122.125679".
          in: query
          type: string
          required: true
        - $ref: '#/parameters/WeatherLanguage'
        - name: duration
          description: >-
            Specifies for how many days the daily indices are returned. By
            default, the indices data for the current day will be returned. When
            requesting future indices data, the current day is included in the
            response as day 1. Available values are
              * `1` - Return daily index data for the current day. Default value.
              * `5` - Return 5 days of daily index data starting from the current day.
              * `10` - Return 10 days of daily index data starting from the current day.
              * `15` - Return 15 days of daily index data starting from the current day.
          default: 1
          in: query
          type: integer
        - name: indexId
          description: >-
            Numeric index identifier that can be used for restricting returned
            results to the corresponding index type. Cannot be paired with
            `indexGroupId`. Please refer to [Weather Service
            Concepts](https://aka.ms/AzureMapsWeatherConcepts) for details and
            to see the supported indices.
          in: query
          type: integer
        - name: indexGroupId
          description: >-
            Numeric index group identifier that can be used for restricting
            returned results to the corresponding subset of indices (index
            group). Cannot be paired with `indexId`. Please refer to [Weather
            Service Concepts](https://aka.ms/AzureMapsWeatherConcepts) for
            details and to see the supported index groups.
          in: query
          type: integer
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/DailyIndicesResponse'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      summary: Microsoft Azure Get Weather Indices Daily Format
      tags:
        - Weather
definitions:
  ODataErrorResponse:
    type: object
    description: >-
      This response object is returned when an error occurs in the Azure Maps
      API.
    properties:
      error:
        $ref: '#/definitio

# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/azure-maps-weather-service-openapi-original.yml