Types Of Clouds Recognition API

Types Of Clouds Recognition API - Cloudaerias (also known as types of clouds detection API) is a cross browsers REST API which get a JSON input with a still photo (as base64 encoded string) or an url of the image and returns a JSON string which contains predictions with certain amount of probability (filtered for output with minimum 30%), which contain the basic types of clouds (cirrus, cirrocumulus, cirrostratus, altocumulus, altostratus, altonimbus, stratus, stratocumulus, cumulus, cumulonimbus) each of it with some description of the type of cloud and the weather forecast based on the detected type of cloud from the input photo. If the probability of prediction is under 30% then these info are not shown.

Allthough this Types Of Clouds Recognition API (currently we do not offer a types of clouds recognition sdk) is intended for software development and therefore developers, we have also here a types of clouds detection online application that may be used to check the input and output JSONs of the API.

The necessary steps are written below, basically for this real time types of clouds detection or recognition API you send an authorized POST request in JSON format to the API endpoint and you get as JSON response the output as described below through parameters and examples.

This Types Of Clouds Recognition API is useful for a large number of domains like: enthusiasts, professionals, students, researchers, developers etc.You own the commercial copyright of the resulted JSON with no additional fee meaning you may use it in your own apps for sale.

For using our types of clouds recognition API and/or APP you must create an account (free of charge, no card required), activate it from your received email, login and then start your TRIAL package with no fees as you can see at our pricing packages. After you have tested the API and/or APP and you are satisfied, you may buy a paid package. You will always see at your Admin Console page the real resources consumption in real time, your invoices, you may see/edit/delete your profile or export log consents as GDPR instructed, you may read our FAQs.

Types Of Clouds Recognition APP

Photo File
Image URL(*)
* Let the "NO" value of Image URL if you upload a Photo File, otherwise write the image url like http://domainname.com/image.jpg



API Endpoint (method POST):
https://gatiosoft.ro/cloudaerias.aspx
Headers:
Authorization: Basic //Your username:password are base64 encoded string
Content-Type: application/json
Accept: application/json
JSON Request Body (change inputs here and see in real time below):
                   {
  "base64_Photo_String": "iVBORw0KGgoAAAA...base64 encoded string photo...GAAAAAElFTkSuQmCC",
  "photo_url": "NO"
}
               
JSON Response From API (change inputs here and see in real time below):
{
  "created": "2020-07-02T12:28:09.989Z",
  "predictions": [
    {
      "probability": 0.5513594,
      "tagId": "6b333d95-e461-4155-890c-9921158f7d17",
      "tagName": "cumulus",
      "description": "Low-level clouds, generally less than 2,000 m (6,600 ft) in altitude unless they are the more vertical cumulus congestus form. Cumulus clouds are flat bases and are often described as 'puffy', 'cotton-like' or 'fluffy' in appearance. Cumulus clouds may appear by themselves, in lines, or in clusters. (Source: Wikipedia)",
      "weather_forecast": "Fair weather"
    },
    {
      "probability": 0.3309611,
      "tagId": "6b333d95-e461-4155-890c-994538f7c28",
      "tagName": "cumulonimbus",
      "description": "Towering cumulonimbus clouds are typically accompanied by smaller cumulus clouds. The cumulonimbus base may extend several kilometres across and occupy low to middle altitudes - formed at altitude from approximately 200 to 4,000 m (700 to 10,000 ft). Peaks typically reach to as much as 12,000 m (39,000 ft), with extreme instances as high as 21,000 m (69,000 ft) or more. Well-developed cumulonimbus clouds are characterized by a flat, anvil-like top (anvil dome), caused by wind shear or inversion near the tropopause. The shelf of the anvil may precede the main cloud's vertical component for many kilometres, and be accompanied by lightning. Occasionally, rising air parcels surpass the equilibrium level (due to momentum) and form an overshooting top culminating at the maximum parcel level. When vertically developed, this largest of all clouds usually extends through all three cloud regions. Even the smallest cumulonimbus cloud dwarfs its neighbors in comparison. (Source: Wikipedia)",
      "weather_forecast": "Be aware of rain, hail or tornadoes"
    }
  ]
}
JSON Response (Example) From API in case of ERROR:

 [
  {
    "cd": "1001",
    "description": "The authorization header Is either empty Or isn't Basic"
  }
]

Request Parameters Table

Parameter Name
Parameter Description
base64_Photo_String
This is the input photo as base64 encoded string[string] which will be scaned for types of clouds. If you set this parameter, the below photo_url parameter value must be set to NO
photo_url
This is the image url [string] used for detecting types of clouds. Its default value is NO because the above parameter base64_Photo_String is set. If this parameter is set to an image url, base64_Photo_String value must be NO.

Response Parameter Table

Parameter Name
Parameter Description
created  
This is the timestamp as  [string] at the moment that request is made.
predictions
This is a list or array which contains the parameters explained below.
probability
This is the probability score [real] of the detected type of clouds.
tagId
This is the tagId [string] for the detected type of clouds. Example: 6b333d95-e461-4155-890c-9921158f7d17.
tagName
This is the tagName [string] for the detected type of clouds. Example: cumulonimbus.
description
This is the description of the detected type of cloud from the input photo [string] . If the probability is less than 30% this parameter has empty value.
weather_forecast
This is the weather forecast based upon the detected type of clouds in the input photo [string] . If the probability is less than 30% than this parameter has empty value.

Response Error Codes Table

Parameter Name
Parameter Description
cd

This is the error code which may be:

  • 1001
  • 1002
  • 1003
  • 1004
  • 1005
  • 1006
  • 1007
  • 1008
  • 1009
  • 1010
  • 1011
  • 1012
  • 1013
  • 1014
  • 1015
  • 1016
  • 2001
description

This is the description of the error code which may be:

  • 1001 - The authorization header is either empty or isn't Basic.
  • 1002 - Daily requests number exceeded in TRIAL mode!
  • 1003 - Trial expired!
  • 1004 - Predictions number exceeded!
  • 1005 - Package expired!
  • 1006 - No invoice!
  • 1007 - Reader is NULL for TRIAL!
  • 1008 - Cannot Read if TRIAL exists!
  • 1009 - Error connecting to database looking for TRIAL! (and a detailed description message of the encountered error)
  • 1010 - Reader is NULL for Invoice!
  • 1011 - Cannot Read if Invoice exists!
  • 1012 - Error connecting to database! (and a detailed description message of the encountered error)
  • 1013 - Input request too long! Maximum 5 MB per request are allowed / Nothing to upload
  • 1014 - Invalid request data! (and a detailed description message of the encountered error)
  • 2001 - Invalid request data after passing to the API (and a detailed description message of the encountered error)

Source Code Examples for Using Our Types Of Clouds Detection API

                       
Imports System
Imports System.Text
imports System.Collections.Generic
Imports System.Net
Imports Newtonsoft.Json

Public Class types_of_clouds_recognition_api
    Public Class ResponseFields
	 Public Property created As String
         Public Property predictions As New List(Of prediction)
    End Class

    Public Class prediction
	 Public Property probability As Single
         Public Property tagId As String
         Public Property tagName As String
         Public Property description As New String
         Public Property weather_forecast As String
    End Class
   
    Public Class ErrorFields
        Public Property cd As String
        Public Property description As String
    End Class

    Protected Sub SendRequest()
        Dim Client As WebClient = New WebClient()
        Dim credentials As String = Convert.ToBase64String(Encoding.ASCII.GetBytes("your_username:your_password"))
        Client.Headers(HttpRequestHeader.Authorization) = String.Format("Basic {0}", credentials)
        Client.Headers(HttpRequestHeader.Accept) = "application/json"
        Client.Headers(HttpRequestHeader.ContentType) = "application/json"
	Client.BaseAddress = "https://gatiosoft.ro/cloudaerias.aspx"
        Dim resString As String = ""

        Try
            Dim js As String = "Replace this string with your JSON Request Body string like in the example above on the website"
            Dim reqString As Byte() = Encoding.UTF8.GetBytes(js)
            Dim url As Uri = New Uri(Client.BaseAddress)
            Dim resByte As Byte() = Client.UploadData(url, "post", reqString)
            resString = Encoding.UTF8.GetString(resByte)

	    If resString.IndexOf("predictions") > 0 Then
                Dim r As ResponseFields = New ResponseFields()
                r = JsonConvert.DeserializeObject(Of ResponseFields)(resString)
                Console.Write(resString)
            Else
		Dim e As list(of ErrorFields) = New list(of ErrorFields)
		e = JsonConvert.DeserializeObject(Of list(of ErrorFields))(resString)
                Console.Write(e(0).cd)
                Console.Write(e(0).description)
            End If

            Client.Dispose()
        Catch exception As Exception
            Dim ex As System.Exception = exception
            Console.Write("ERROR: " & resString & ex.Message)
        End Try
    End Sub

    Public Shared Sub Main()
	Dim b As types_of_clouds_recognition_api = New  types_of_clouds_recognition_api
        b.SendRequest()
    End Sub
End Class



Cloudaerias Online Video Presentation

Types Of Clouds Detection API, Cloudaerias is in the video presentation below. There are several search terms which you may use like: types of clouds recognition api, types of clouds, cirrus, cirrocumulus, cirrostratus, altocumulus, altostratus, altonimbus, stratus, stratocumulus, cumulus, cumulonimbus, weather forecast based on clouds image.

 



Pricing Packages

Please choose one of the below pricing packages for start using our Types Of Clouds Recognition API and online APP!

Start TRIAL
No catches

  • 7 days TRIAL.
  • Use our cloud REST API and online APP.
  • Maximum 50 requests per DAY in trial period.
  • You do NOT own the commercial copyright for using the API in your apps in trial period.
  • Get type of clouds.
  • Get the description of the type of clouds detected in the input photo.
  • Get the weather forecast based on the type of clouds detected in the input photo.
  • Get timestamp at the moment of the request
  • Unlimited Devices
  • Administration console
  • Support through online chat and/or tickets
  • We do NOT allow spam accounts for TRIAL



Monthly TIER
Popular

  • 80 USD per month
  • Use our cloud REST API and online APP
  • Maximum 10000 predictions(*) per month
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get type of clouds.
  • Get the description of the type of clouds detected in the input photo.
  • Get the weather forecast based on the type of clouds detected in the input photo.
  • Get timestamp at the moment of the request
  • Unlimited Devices
  • Get timestamp at the moment of the request
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Yearly TIER
(15% Discount)

  • 816 USD per year
  • Use our cloud REST API and online APP
  • Maximum 10000 predictions(*) per month
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get type of clouds.
  • Get the description of the type of clouds detected in the input photo.
  • Get the weather forecast based on the type of clouds detected in the input photo.
  • Get timestamp at the moment of the request
  • Unlimited Devices
  • Get timestamp at the moment of the request
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Note: VAT rate may be added or not, function to your country and/or if you are a taxable person or company.
* Prediction - on the input photo may exist many predictions, each of it with certain amount of probability of the detected type of clouds. Even we filter the output predictions to those with probability score greater than 30%, for the input photo all predictions are counted.