Wildfire Tracker+ API v1

Last updated: Oct 6, 2022

The wildfire tracker+ API provides ongoing wildfire updates for the areas of interest you define.

We offer 2 main products:

• Area Monitoring
• Precision Tracking

Area Monitoring

Last updated: Oct 6, 2022

Active Fire

The Active Fire Area Monitoring API allows you to get all the active fires’ information within any of your predefined areas of interest, worldwide. Fires are considered ‘active’ based on accumulation of data from the last 72 hours. The predefined areas of interest are defined at the contract level, meaning you will be required to contact your account manager in order to change those areas.

Request Parameters

An API request returns the active fires within the predefined areas of interest, including fires that intersect the boundaries. Your API key ensures that all the fire information that is relevant to the predefinition will be given via the response.

https://api.breezometer.com/fires/v1/area-monitoring/active?key={YOUR_API_KEY}

While making an API request some parameters are required while some are optional.

Parameter	Type	Description	R/O
key	String	Your BreezoMeter API key 90	Required
features	String	Sets the data fields returned by the response. Possible values: See Features List below Note: You must separate every two features with a comma, and use the exact naming convention as shown in the possible values. Example: SourceID, SourceEventDescription	Optional

Was this section helpful? Yes No

Example

Last updated: Oct 6, 2022

This example shows a use case of tracking active wildfires in a predefined country- US only. In order to ensure that the key holds only the relevant area-of-interest (AoI) you will be required to contact your account manager. As long as there is at least one Active fire in the Aol, the response includes the perimeters and pertinent data of all active fires within (or intersecting) the Aol.

https://api.breezometer.com/fires/v1/area-monitoring/active?key={YOUR_API_KEY}

Was this section helpful? Yes No

Response Data Fields

Last updated: Oct 6, 2022

Active Area Monitoring API provides a list of fields for each active fire, based on the following statement: "Get all the active fires within your area of interest".

You will need to submit a single API request and supply the key to receive the following response fields.

Below you can find the default fields:

Field Name	Type	Description
LastUpdated	ISO datetime	The last time the wildfire data was updated.
CurrentLat	Float	Current location average of latitudes (center of mass)
CurrentLon	Float	Current location average of longitudes (center of mass)
CalculatedAcres	Float	Calculated area size of the polygon, in acres.
MaxCalculatedAcres	Float	Maximal wildfire size throughout the last 72 hours
ShapeConfidence	Integer	The confidence value (1-5) represents how accurate is the shape of the wildfire. Scale: 1-worst, 5-best
ExistenceConfidence	Integer	Value (1-5) represents how confident are we this wildfire is real
CreatedOnDateTime	ISO datetime	The timestamp the wildfire first crossed the 1000 acres.
Country	ISO 3 letters (String)	The country containing the POO.
State	ISO (String)	The State alpha code identifies the state or equivalent entity at the point of origin. For Australia and USA only
City	String	The closest city to the incident point of origin
EventId	string format: nyyyy-VLLLLLLL-HLLLLLLLL-xxxxxxxx	Unique identifier for each wildfire event
EventName	String	Name of the closest city to the polygons' initial central location
EventDescription	String	Direction and distance to the closest city to the polygon's initial central location
geometry	Polygon / MultiPolygon (Lat / Long coordinates)	Geographic representation of the wildfire extent (boundary) in WGS84 coordinates. The latitude points for the polygons are to be specified in decimal degrees. The longitude points for the polygons are to be specified in decimal degrees.
DiscoveryDateTime	ISO datetime	The DateTime of the earliest hotspot detected for this event
InitialLat	Float	Initial location average of latitudes (center of mass).
InitialLon	Float	Initial location average of longitudes (center of mass)

For the list of the data fields returned with each feature, see Features List

Was this section helpful? Yes No

Request-Response Example

This example shows a use case of all the active wildfires for a predefined area of interest: the US.
The request for active wildfires using this key allows clients to get all the relevant fire information for this area and only for it. Within the response, it is possible to notice cases when a local source data enrichment is available. When the data is not available the field is populated with a NULL value.

Request

https://api.breezometer.com/fires/v1/area-monitoring/active?key={KEY_FOR_US_DATA_ONLY}&features=SourceId,SourceEventDescription,SourcePercentContained,SourceDetailURL,SourceDetailURLName,SourceEventId,SourceInitialLatitude,SourceInitialLongitude

Response

  -   {  /* 3 items */  } ,         "metadata" :  null ,     -     "data" :  {  /* 2 items */  } ,           "type" :  "FeatureCollection" ,     -       "features" :  [  /* 3 items */  ] ,     -         {  /* 4 items */  } ,               "id" :  "0" ,               "type" :  "Feature" ,     -           "properties" :  {  /* 25 items */  } ,                 "CalculatedAcres" :  556.8499244610919 ,                 "City" :  "LOCUST GROVE" ,                 "Country" :  "USA" ,                 "CreatedOnDateTime" :  "2022-09-16T19:00:00Z" ,                 "CurrentLat" :  36.34720659670154 ,                 "CurrentLon" :  -95.01901202995886 ,                 "DiscoveryDateTime" :  "2022-09-16T17:05:05Z" ,                 "EventDescription" :  "Fire is located 26 Km North East of LOCUST GROVE" ,                 "EventId" :  "2022-N3635340-W09502341-deZMTFJRI4" ,                 "EventName" :  "LOCUST GROVE" ,                 "ExistenceConfidence" :  4 ,                 "InitialLat" :  36.353399040512144 ,                 "InitialLon" :  -95.02340689257016 ,                 "LastUpdated" :  "2022-09-17T08:09:00Z" ,                 "MaxCalculatedAcres" :  1614.498880183624 ,                 "ShapeConfidence" :  1 ,                 "SourceDetailURL" :  null ,                 "SourceDetailURLName" :  null ,                 "SourceEventDescription" :  null ,                 "SourceEventId" :  null ,                 "SourceId" :  null ,                 "SourceInitialLatitude" :  null ,                 "SourceInitialLongitude" :  null ,                 "SourcePercentContained" :  null ,                 "State" :  "OK"               } ,     -           "geometry" :  {  /* 2 items */  } ,                 "type" :  "Polygon" ,     +             "coordinates" :  [  /* 1 item */  ] ,     +               [  /* 27 items */  ] ,     +                 [  /* 2 items */  ] ,                       -95.0066888810575 ,                       36.3417160605202                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0065312033304 ,                       36.3423331491104                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0066689161988 ,                       36.342765931958                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0197308576821 ,                       36.3556923417287                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0226730373844 ,                       36.3588260260208                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0236132337274 ,                       36.3601128611757                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0240958678994 ,                       36.3603294475788                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0248672268396 ,                       36.3601935713061                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0262374447199 ,                       36.3595280753277                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0272175566902 ,                       36.3588326423805                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0278915776711 ,                       36.3576846423524                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0282009453286 ,                       36.3560522868899                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0281456596627 ,                       36.3539355759931                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0275047069384 ,                       36.3503598530107                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0262962327053 ,                       36.3462547089783                     ] ,     +                 [  /* 2 items */  ] ,                       -95.025226889118 ,                       36.3436886492667                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0240351454056 ,                       36.341633199954                     ] ,     +                 [  /* 2 items */  ] ,                       -95.022721001568 ,                       36.3400883610403                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0217769056068 ,                       36.339342140875                     ] ,     +                 [  /* 2 items */  ] ,                       -95.02077840959 ,                       36.3388228586648                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0146025905773 ,                       36.3365607194391                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0136047876356 ,                       36.3364002732973                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0122852216939 ,                       36.3366302332659                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0108489265089 ,                       36.3373093432436                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0094451443869 ,                       36.3383318172593                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0078904082979 ,                       36.3399289661117                     ] ,     +                 [  /* 2 items */  ] ,                       -95.0066888810575 ,                       36.3417160605202                     ]                   ]                 ]               }             } ,     -         {  /* 4 items */  } ,               "id" :  "1" ,               "type" :  "Feature" ,     -           "properties" :  {  /* 25 items */  } ,                 "CalculatedAcres" :  112.14331772949333 ,                 "City" :  "MADERA" ,                 "Country" :  "USA" ,                 "CreatedOnDateTime" :  "2022-08-12T20:00:00Z" ,                 "CurrentLat" :  37.63443280766591 ,                 "CurrentLon" :  -119.51986142276459 ,                 "DiscoveryDateTime" :  "2022-08-11T08:52:00Z" ,                 "EventDescription" :  "Fire is located 112 Km North East of MADERA" ,                 "EventId" :  "2022-N3766032-W11947528-X4LKhupoZ0" ,                 "EventName" :  "MADERA" ,                 "ExistenceConfidence" :  5 ,                 "InitialLat" :  37.66395545792201 ,                 "InitialLon" :  -119.46847306833725 ,                 "LastUpdated" :  "2022-09-17T21:12:00Z" ,                 "MaxCalculatedAcres" :  9704.161785027458 ,                 "ShapeConfidence" :  2 ,                 "SourceDetailURL" :  "https://inciweb.nwcg.gov/incident/8332/" ,                 "SourceDetailURLName" :  "InciWeb" ,                 "SourceEventDescription" :  "SOUTHERN SECTION OF YOSEMITE NP NEAR GREY PEAK" ,                 "SourceEventId" :  "1e643c3b-3be4-4669-892b-cf82b46fa820" ,                 "SourceId" :  "IRW_NIFC_USA" ,                 "SourceInitialLatitude" :  37.66138 ,                 "SourceInitialLongitude" :  -119.4713 ,                 "SourcePercentContained" :  100 ,                 "State" :  "CA"               } ,     -           "geometry" :  {  /* 2 items */  } ,                 "type" :  "Polygon" ,     +             "coordinates" :  [  /* 1 item */  ] ,     +               [  /* 21 items */  ] ,     +                 [  /* 2 items */  ] ,                       -119.509513466755 ,                       37.6314368346015                     ] ,     +                 [  /* 2 items */  ] ,                       -119.509648289034 ,                       37.6321962531676                     ] ,     +                 [  /* 2 items */  ] ,                       -119.509984312274 ,                       37.6326603499127                     ] ,     +                 [  /* 2 items */  ] ,                       -119.510521683969 ,                       37.633034046218                     ] ,     +                 [  /* 2 items */  ] ,                       -119.514130158623 ,                       37.6342158696078                     ] ,     +                 [  /* 2 items */  ] ,                       -119.520110741469 ,                       37.6367236222353                     ] ,     +                 [  /* 2 items */  ] ,                       -119.52538137674 ,                       37.6386007874469                     ] ,     +                 [  /* 2 items */  ] ,                       -119.527747885774 ,                       37.6389155351783                     ] ,     +                 [  /* 2 items */  ] ,                       -119.529133395665 ,                       37.6386371080825                     ] ,     +                 [  /* 2 items */  ] ,                       -119.529876371303 ,                       37.6381189896801                     ] ,     +                 [  /* 2 items */  ] ,                       -119.530903516645 ,                       37.6365148462354                     ] ,     +                 [  /* 2 items */  ] ,                       -119.530898856309 ,                       37.6362203502757                     ] ,     +                 [  /* 2 items */  ] ,                       -119.530720674914 ,                       37.6360459635768                     ] ,     +                 [  /* 2 items */  ] ,                       -119.527863797773 ,                       37.6356154287777                     ] ,     +                 [  /* 2 items */  ] ,                       -119.526060956704 ,                       37.6351060845782                     ] ,     +                 [  /* 2 items */  ] ,                       -119.512601054274 ,                       37.6299813960254                     ] ,     +                 [  /* 2 items */  ] ,                       -119.511576023188 ,                       37.6297864396629                     ] ,     +                 [  /* 2 items */  ] ,                       -119.51075702338 ,                       37.6298165135371                     ] ,     +                 [  /* 2 items */  ] ,                       -119.510144054851 ,                       37.630071617648                     ] ,     +                 [  /* 2 items */  ] ,                       -119.509647256577 ,                       37.6307618034972                     ] ,     +                 [  /* 2 items */  ] ,                       -119.509513466755 ,                       37.6314368346015                     ]                   ]                 ]               }             } ,     -         {  /* 4 items */  } ,               "id" :  "31" ,               "type" :  "Feature" ,     -           "properties" :  {  /* 25 items */  } ,                 "CalculatedAcres" :  1863.83489866134 ,                 "City" :  "ROCKSPRINGS" ,                 "Country" :  "USA" ,                 "CreatedOnDateTime" :  "2022-09-18T15:00:00Z" ,                 "CurrentLat" :  30.177708625793446 ,                 "CurrentLon" :  -100.17260742187501 ,                 "DiscoveryDateTime" :  "2022-09-18T13:45:05Z" ,                 "EventDescription" :  "Fire is located 21 Km North of ROCKSPRINGS" ,                 "EventId" :  "2022-N3017771-W10017261-0R1l4ea5x5" ,                 "EventName" :  "ROCKSPRINGS" ,                 "ExistenceConfidence" :  0 ,                 "InitialLat" :  30.177708625793446 ,                 "InitialLon" :  -100.17260742187501 ,                 "LastUpdated" :  "2022-09-18T13:45:05Z" ,                 "MaxCalculatedAcres" :  1863.83489866134 ,                 "ShapeConfidence" :  0 ,                 "SourceDetailURL" :  null ,                 "SourceDetailURLName" :  null ,                 "SourceEventDescription" :  null ,                 "SourceEventId" :  null ,                 "SourceId" :  null ,                 "SourceInitialLatitude" :  null ,                 "SourceInitialLongitude" :  null ,                 "SourcePercentContained" :  null ,                 "State" :  "TX"               } ,     -           "geometry" :  {  /* 2 items */  } ,                 "type" :  "Polygon" ,     +             "coordinates" :  [  /* 1 item */  ] ,     +               [  /* 38 items */  ] ,     +                 [  /* 2 items */  ] ,                       -100.15595895052 ,                       30.1816335581243                     ] ,     +                 [  /* 2 items */  ] ,                       -100.155641108752 ,                       30.1828448157758                     ] ,     +                 [  /* 2 items */  ] ,                       -100.155480176211 ,                       30.1844755541533                     ] ,     +                 [  /* 2 items */  ] ,                       -100.155855149031 ,                       30.1863023955375                     ] ,     +                 [  /* 2 items */  ] ,                       -100.156578540802 ,                       30.1874119192362                     ] ,     +                 [  /* 2 items */  ] ,                       -100.157271355391 ,                       30.1880275029689                     ] ,     +                 [  /* 2 items */  ] ,                       -100.158132612705 ,                       30.1885438077152                     ] ,     +                 [  /* 2 items */  ] ,                       -100.159740328789 ,                       30.189132116735                     ] ,     +                 [  /* 2 items */  ] ,                       -100.163262069225 ,                       30.1896162368357                     ] ,     +                 [  /* 2 items */  ] ,                       -100.165880441666 ,                       30.1896088719368                     ] ,     +                 [  /* 2 items */  ] ,                       -100.168698370457 ,                       30.1893878970295                     ] ,     +                 [  /* 2 items */  ] ,                       -100.173040866852 ,                       30.1885883286595                     ] ,     +                 [  /* 2 items */  ] ,                       -100.176196217537 ,                       30.1875605247915                     ] ,     +                 [  /* 2 items */  ] ,                       -100.179742097855 ,                       30.1857905834913                     ] ,     +                 [  /* 2 items */  ] ,                       -100.182260155678 ,                       30.1839864812791                     ] ,     +                 [  /* 2 items */  ] ,                       -100.185009419918 ,                       30.1812461670488                     ] ,     +                 [  /* 2 items */  ] ,                       -100.187316119671 ,                       30.1779667567462                     ] ,     +                 [  /* 2 items */  ] ,                       -100.189033806324 ,                       30.1744265519082                     ] ,     +                 [  /* 2 items */  ] ,                       -100.189573734998 ,                       30.1725724358111                     ] ,     +                 [  /* 2 items */  ] ,                       -100.189723134041 ,                       30.1714604571461                     ] ,     +                 [  /* 2 items */  ] ,                       -100.189516603946 ,                       30.1695343367755                     ] ,     +                 [  /* 2 items */  ] ,                       -100.188636302948 ,                       30.1680053323507                     ] ,     +                 [  /* 2 items */  ] ,                       -100.187533915043 ,                       30.1671191863715                     ] ,     +                 [  /* 2 items */  ] ,                       -100.186052531004 ,                       30.1664564181119                     ] ,     +                 [  /* 2 items */  ] ,                       -100.184192150831 ,                       30.1660170275718                     ] ,     +                 [  /* 2 items */  ] ,                       -100.181122094393 ,                       30.1657786499709                     ] ,     +                 [  /* 2 items */  ] ,                       -100.178377389908 ,                       30.1658604741096                     ] ,     +                 [  /* 2 items */  ] ,                       -100.174726366997 ,                       30.1662844903767                     ] ,     +                 [  /* 2 items */  ] ,                       -100.172173976898 ,                       30.1668289229274                     ] ,     +                 [  /* 2 items */  ] ,                       -100.169780910015 ,                       30.1675674300641                     ] ,     +                 [  /* 2 items */  ] ,                       -100.167547166348 ,                       30.1685000117868                     ] ,     +                 [  /* 2 items */  ] ,                       -100.165472745895 ,                       30.1696266680956                     ] ,     +                 [  /* 2 items */  ] ,                       -100.163557648659 ,                       30.1709473989904                     ] ,     +                 [  /* 2 items */  ] ,                       -100.161801874638 ,                       30.1724622044712                     ] ,     +                 [  /* 2 items */  ] ,                       -100.160205423832 ,                       30.1741710845381                     ] ,     +                 [  /* 2 items */  ] ,                       -100.158768296242 ,                       30.176074039191                     ] ,     +                 [  /* 2 items */  ] ,                       -100.157490491867 ,                       30.1781710684299                     ] ,     +                 [  /* 2 items */  ] ,                       -100.15595895052 ,                       30.1816335581243                     ]                   ]                 ]               }             }           ]         } ,        "error" :  null       }  

Visualization

These visualizations allow you to see all the active wildfire polygons using a GIS tool to demonstrate how an API response can be used.

TIP

Note:

These APIs do not provide any visualizations.
The example shown below demonstrate a common usage of the products

Example 1: Macro view of all the active wildfires at a given moment

Example 2: Micro view of a single fire perimeter

The images above used the following request-response from the Active Area Monitoring API. It is highly recommended to use colors that represent active fires for visualization purposes.

Features List

Last updated: Oct 6, 2022

You will get a list of all the active fires within your AoI, and receive in-depth information about each wildfire area boundaries, distance, fire name, start date and size.

Here are the various supported features:

Field Name	Type	Description
SourceCurrentLatitude	Float	The current point location latitude indicated by the source
SourceCurrentLongitude	Float	The current point location longitude indicated by the source
SourceDetailURL	String (link)	Link to a specific page for the wildfire. Could be a link from the same source as ‘SourceName’ or a different one
SourceDetailURLName	String	The name of the local source providing the ‘SourceDetailURL’ link. Same terminology as ‘SourceName’.
ComplexName	String	The name of the complex where this wildfire is located
SourceId	String	A consistent identifier for the source agency. E.g “IRW_USA”
SourceName	String	The organization providing authoritative wildfire information E.g ‘IRWIN’
SourceURL	String	General web address for wildfireAgencyName (the wildfire authority for a unique event)
SourceEventId	String	Unique identifier assigned to each wildland wildfire by the local source
SourceEventName	String	The name assigned to an incident by the local source
SourceEventDescription	String	General description of the incident given by the local source
SourceLastUpdated	ISO datetime	Date/time that the Agency Incident record was last modified
SourceDiscoveryDateTime	ISO datetime	The date and time a wildfire was reported as discovered or confirmed to exist. May also be the start date for reporting purposes
SourceCreatedOnDateTime	ISO datetime	Date/time that the Local source Incident record was created.
SourcePercentContained	Float	The wildfire containment %, provided by the local source
SourceContainmentForecast	ISO datetime	Expected containment date
SourceInitialLatitude	Float	Initial latitude value for the wildfire given by the local source
SourceInitialLongitude	Float	Initial Longitude value for the wildfire given by the local source
SourcePrescribed	Bool	When wildfires are reported as ‘prescribed’ by the local sources (if local sources provide this information)

TIP

Note:

There are two separate endpoints for area monitoring.
One endpoint for active fires, which is available now, and one for burnt areas, which will be available soon.
Once the Burnt Area endpoint will be ready, please make sure your key is permitted to call the end point of Burnt Area Monitoring:

https://api.breezometer.com/fires/v1/area-monitoring/burnt?key={YOUR_API_KEY}

Precision Tracking

Last updated: Nov 7, 2022

Active Fire

The Active Fire Precision Tracking solution allows you to pull updates on-demand without being limited to certain areas. As the fires move, so does the perimeter track, ensuring a timely and updated solution you can trust.

Request Parameters

Returns active wildfire conditions for a specific location

https://api.breezometer.com/fires/v1/locate-and-track?key=YOUR_API_KEY&lat={latitude}&lon={longitude}&radius={radius}

While making an API request some parameters are required while some are optional.

Parameter	Type	Description	R/O
lat	Float	Latitude (lat) specifies the north-south position of a point in a range between -90 and 90	Required
lon	Float	Longitude (lon) specifies the east-west position of a point in a range between -180 to 180	Required
radius	Integer	Desired radius from the location provided (lat, lon) Radius range: Min Value: 5 KM / 3 Mile Max Value: 100 KM / 62 Mile Note: By default, requests are sent as Metric measurements. Requests can be customized by setting the request’s units parameter. The defined value will be increased or decreased if a radius value exceeds the allowed range	Required
key	String	Your BreezoMeter API key	Required
units	String	Sets the response measurement system to either: metric for Metric (default) imperial for Imperial For more information, see Unit Systems	Optional
features	String	Sets the data fields returned by the response. Possible values: See Features List below Note: You must separate every two features with a comma, and use the exact naming convention as shown in the possible values. Example: CalculatedAcres, SourcePercentContained, CreatedOnDateTime	Optional

Was this section helpful? Yes No

Example

Last updated: Nov 7, 2022

A request to get the status of all the current wildfires within a designated radius (20 km) of the specified location (48.857456, 2.354611) using the default request parameters settings.

https://api.breezometer.com/fires/v1/locate-and-track?key=YOUR_API_KEY&lat=48.857456&lon=2.354611&radius=20

Response Data Fields

Precision Tracking solution provides a list of response fields for each wildfire, based on the following statement: "Get all the fires around your chosen objects".

You will need to submit a single API request and supply the object's input to receive the following response fields (included by default with all packages):

DiscoveryDateTime

Default

The DateTime of the earliest hotspot detected for this event

LastUpdated

Default

The last time the wildfire data was updated.

CurrentLat

Default

The current latitude (lat) of the wildfire

CurrentLon

Default

The current longitude (lon) of the wildfire

geometry

Default

The fire perimeter consists of all the coordinates of the fire polygon. For example: "geometry": { "type": "Polygon", "coordinates": [ [ [ -17.9119606274645, 28.6068773236325 ], [ -17.9099705306238, 28.6080715099283 ], [ -17.9045284977173, 28.6106982885562 ], [ -17.8953817270035, 28.6142966182073 ], [ -17.8893890246955, 28.6161486793994 ] ]]}

Features List

Using the Precision Tracking solution, you will receive a comprehensive list of all the active wildfires in the specified radius, along with detailed information about their boundaries, distance, fire name, start date, and size.

Here are the various supported features:

Confidence & Polygon

Field Name	Type	Description
ShapeConfidence	Integer	The confidence value (1-5) represents how accurate the shape of the wildfire is. Scale: 1-worst, 5-best
geometry	Polygon / MultiPolygon (Lat / Long coordinates)	Geographic representation of the wildfire extent (boundary) in WGS84 coordinates. The latitude points for the polygons are to be specified in decimal degrees. The longitude points for the polygons are to be specified in decimal degrees
CalculatedAcres	Float	Calculated area size of the polygon, in acres.
MaxCalculatedAcres	Float	Maximal wildfire size throughout the last 72 hours
ExistenceConfidence	Integer	GValue (1-5) represents how confident are we this wildfire is real

Location

Field Name	Type	Description
InitialLat	Float	Initial location average of latitudes (center of mass)
InitialLon	Float	Initial location average of longitudes (center of mass)
CurrentLat	ISO 3 letters (String)	Current location average of latitudes (center of mass)
CurrentLon	Float	Current location average of longitudes (center of mass)
Country	ISO 3 letters (String)	The country containing the POO
State	ISO (String)	The State alpha code identifies the state or equivalent entity at the point of origin. For Australia and USA only
City	String	The closest city to the incident point of origin

Date & Time

Field Name	Type	Description
CreatedOnDateTime	ISO datetime	The timestamp of the wildfire first crossed the 1000 acres
LastUpdated	ISO datetime	The last time the active wildfire data was updated
DiscoveryDateTime	ISO datetime	The DateTime of the earliest hotspot detected for this event

Source Data Enrichment

Field Name	Type	Description
SourceCurrentLatitude	Float	The current point location latitude indicated by the source
SourceCurrentLongitude	Float	The current point location longitude indicated by the source
SourceDetailURL	String (link)	Link to a specific page for the wildfire. Could be a link from the same source as ‘SourceName’ or a different one
SourceDetailURLName	String	The name of the local source providing the ‘SourceDetailURL’ link. Same terminology as ‘SourceName’.
ComplexName	String	The name of the complex where this wildfire is located
SourceId	String	A consistent identifier for the source agency. E.g “IRW_USA”
SourceName	String	The organization providing authoritative wildfire information E.g ‘IRWIN’
SourceURL	String	General web address for wildfireAgencyName (the wildfire authority for a unique event)
SourceEventId	String	Unique identifier assigned to each wildland wildfire by the local source
SourceEventName	String	The name assigned to an incident by the local source
SourceEventDescription	String	General description of the incident given by the local source
SourceLastUpdated	ISO datetime	Date/time that the Agency Incident record was last modified
SourceDiscoveryDateTime	ISO datetime	The date and time a wildfire was reported as discovered or confirmed to exist. May also be the start date for reporting purposes
SourceCreatedOnDateTime	ISO datetime	Date/time that the Local source Incident record was created.
SourcePercentContained	Float	The wildfire containment %, provided by the local source
SourceContainmentForecast	ISO datetime	Expected containment date
SourceInitialLatitude	Float	Initial latitude value for the wildfire given by the local source
SourceInitialLongitude	Float	Initial Longitude value for the wildfire given by the local source
SourcePrescribed	Bool	When wildfires are reported as ‘prescribed’ by the local sources (if local sources provide this information)

Event

Field Name	Type	Description
EventId	String format:yyyy-VLLLLLLL-HLLLLLLLL-xxxxxxxx	Unique identifier for each wildfire event
EventName	String	Name of the closest city to the polygons' initial central location
EventDescription	String	Direction and distance to the closest city to the polygon's initial central location

Was this section helpful? Yes No

Unit Systems

This table lists the Precision Tracking fields and the units in which they are measured or calculated according to the Metric and the Imperial systems.

TIP

Note:

By default, requests return Metric measurement. Requests can be customized by setting the request’s units parameter.

Field/units	metric	imperial
radius	km	mi

Burnt Area

The Burnt Area Precision Tracking solution allows you to get all burnt areas surrounding a given location within a certain radius.

Request parameters

Returns the burnt areas for a specific location, in accordance with a lookback window. With the lookback window, you can choose the amount of time past the fire extinguished time, either in days or hours.

https://api.breezometer.com/fires/v1/burnt-area?key=YOUR_API_KEY&lat={latitude}&lon={longitude}&radius={radius}&daysFromExtinguish={days}

While making an API request some parameters are required while some are optional.

Example

This example shows a use case of tracking burnt areas of an active wildfire. In order to have no burnt areas visible on the map, after the wildfire is flagged as ‘Extinguished’, set up the daysFromExtinguish = 0. In practice, both active fire perimeters and their burnt areas are removed together, when the fire is out.

https://api.breezometer.com/fires/v1/burnt-area?key=YOUR_API_KEY&lat=14&lon=-10.7&radius=20&daysFromExtinguish=0

Response Data Fields

The Burnt Area Precision Tracking solution provides a list of fields for each burnt area, based on the following statement: "Get all the burnt areas around your

You will need to submit a single API request and supply the point’s input to receive the following response fields.

Below you can find the default fields

geometry

Geography

The burnt area geometry represents accumulated areas that got no indication of fire burning in the last 72 hours

BurntLat

Float

Last burnt area location average of latitudes (center of geometry's mass)

BurntLon

Float

Last burnt area location average of longitudes (center of geometry's mass)

BurntAcres

Float

The total size of the burnt areas [acres]. Accumulations are based on the geometry

ExtinguishedTS

Datetime

The fire extinguished timestamp indicates when (at least) 72 hours have passed since the fire was burning

DiscoveryDateTime

Datetime

detected for this event.

InitialLat

Float

Initial location of the wildfire, average of latitudes (center of mass)

InitialLon

Float

Initial location of the wildfire, average of longitudes (center of mass)

Response Example 1

Burnt Area service as an additional service to the Active Fire Precision Tracking solution

This example shows a use case of tracking burnt areas of an active wildfire, and demonstrates the polygons of both active fire and its related burnt areas.

Response Example 2

Burnt Area as stand-alone service
This example shows a use case of 2 wildfires for a given location with a desired radius=100 [km]. The request for daysFromExtinguish=30, allows clients to get all the burnt areas of wildfires that have been extinguished during a lookback window of the last 30 days.

Features List

Using the Precision Tracking solution, you will receive a list of all the burnt areas within the specified radius of the designated location, and receive in-depth information about each burnt area boundaries, distance, fire name, start date and size.

Here are the various supported features:

Burnt Area Fields

Field Name	Type	Description
geometry	Geography	The burnt area geometry represents accumulated areas that got no indication of fire burning in the last 72 hours
BurntLat	Float	Last burnt area location average of latitudes (center of geometry's mass)
BurntLon	Float	Last burnt area location average of longitudes (center of geometry's mass)
BurntAcres	Float	The total size of the burnt areas [acres]. Accumulations are based on the geometry
BurntTS	Timestamp	Last timestamp the burnt area was updated
LastSatelliteTime	Datetime	Latest pixel acquisition time by the satellite
ExtinguishedTS	Datetime	The fire extinguished timestamp indicates when (at least) 72 hours have passed since the fire was burning

Date & Time

Field Name	Type	Description
DiscoveryDateTime	Datetime	The DateTime of the earliest hotspot detected for this event

Location

Field Name	Type	Description
InitialLat	Float	Initial location of the wildfire, average of latitudes (center of mass)
InitialLon	Float	Initial location of the wildfire, average of longitudes (center of mass)
Country	ISO 3 letters (String)	The country containing the POO
State	ISO (String)	The State alpha code identifies the state or equivalent entity at the point of origin *For Australia only
City	String	The closest city to the incident point of origin

Event

Field Name	Type	Description
EventId	String	Unique identifier for each event
EventName	String	Name of the closest city to the wildfire's initial central location
EventDescription	String	Direction and distance to the closest city to the wildfire's initial central location

Source Date Enrichment

Field Name	Type	Description
ComplexName	String	The name of the complex where this wildfire is located
SourceId	String	A consistent identifier for the source agency. E.g “IRW_USA”
SourceName	String	The organization providing authoritative wildfire information E.g ‘IRWIN’
SourceURL	String	General web address for wildfireAgencyName (the wildfire authority for a unique event)
SourceEventId	String	Unique identifier assigned to each wildland wildfire by the local source
SourceEventName	String	The name assigned to an incident by the local source
SourceEventDescription	String	General description of the incident given by the local source
SourceLastUpdated	ISO datetime	Date/time that the Agency Incident record was last modified
SourceDiscoveryDateTime	ISO datetime	The date and time a wildfire was reported as discovered or confirmed to exist. May also be the start date for reporting purposes
SourceDetailURL	String	Link to a specific page for the wildfire. Could be a link from the same source as ‘SourceName’ or a different one
SourceDetailURLName	String	The name of the local source providing the ‘SourceDetailURL’ link. Same terminology as ‘SourceName’.
SourcePrescribed	Boolean	When wildfires are reported as ‘prescribed’ by the local sources (if local sources provide this information)
SourceCreatedOnDateTime	ISO datetime	Date/time that the Local source Incident record was created.
SourceInitialLatitude	Float	Initial latitude value for the wildfire given by the local source
SourceInitialLongitude	Float	Initial Longitude value for the wildfire given by the local source