Strayos offers a suite of API services to help Enterprise developers and organizations to export, generate, display, measure, integrate, and back up data. The API can be used to directly integrate the data collected and processed with Strayos into your own applications and services.
API services can only be accessed by Admin or Sub domain Admin.
Steps to generate API Key:
- Go to Admin Dashboard
2. There is a menu item ‘Data API settings’ . Click on it
3. Give a name for your API key and Click submit button.
4. Strayos will generate an API key and it’ll be shown in the screen. Copy the API key and save it for your records. In case when you forget the API key, you’ll have the ability to copy it again from the same place.
Domain Info API
Allows you to list the all the associated subdomains, sites, datasets of your domain.
Sample URL -> https://appdb.strayos.com/api/external/domain/DOMAIN_NAME?api_key=API_KEY
Response:
{
domain: {
id: domain_id,
domain_name: 'Domain Name',
subdomains: [
{
id: subdomain_id_1,
subdomain_name: 'Subdomain 1',
sites: [
{
id: site_id_1,
site_name: 'Site 1',
datasets: [
{
id: dataset_id_1,
dataset_name: 'Dataset 1'
},
{
id: dataset_id_1,
dataset_name: 'Dataset 1'
},
........
]
},
{
id: site_id_2,
site_name: 'Site 2',
datasets: []
},
]
},
{
id: subdomain_id_2,
subdomain_name: 'Subdomain 2',
sites: []
},
]
}
}
Export API
Allows you to list all the available downloads of your project.
Sample URL -> https://appdb.strayos.com/api/external/exports/PROJECT_ID?api_key=API_KEY
Response:
Response is an array of available exports.
[
{
name: ‘Source Images’,
url: ‘https://s3download.azureedge.net/output/airzaar/output/33376/source_images.zip’
},
……….
]
where
name: specifies what type of export it is
url: Export download URL
Measurement API
Allows you to list all the measurements of your project.
Sample URL -> https://appdb.strayos.com/api/external/measurements/PROJECT_ID?api_key=API_KEY
Response:
Response is an array of available measurements.
[
{
name: ‘Iris Satun’,
tool: ‘Polygon’,
geometry: { type: ‘FeatureCollection’, features: [] },
cut_volume: 50803.62484,
net_volume: 50803.62397,
fill_volume: -0.0008775308,
area: 9701.1777554
},
……….
]
where
name: Name of measurement Annotation
tool: Type of measurement Tool (LineString, Point, Polygon)
geometry: Geometry of Annotation
cut_volume, net_volume, fill_volume and area are the individual parameters of corresponding annotations
Drill Design API
Allows you to get the Drill Design data of your project.
Sample URL -> https://appdb.strayos.com/api/external/drill_design/PROJECT_ID?api_key=API_KEY
Response:
Response of Drill Design API has following information
{
type: ‘shot’,
row_count: 2,
hole_count: 16,
back_break: 0.94,
burden_sample_type: { interval: 1},
hole_diameter: 0.10160000000000001,
max_burden_threshold: 4.572,
min_burden_threshold: 2.1336,
shot_area: 172.22972452041108,
shot_volume: 4566.2078918392945,
subdrill: 1.2192,
rows: [
{
"row_name": "Row 1 (A-B 1)",
"holes": [
{
"hole_name": "Hole 1",
"area": 4.85143419695145,
"volume": 132.63894387421306,
"burden_azimuth": "auto",
"collar": [-10889491.917,3932317.646,263.683],
"toe": [-10889491.917,3932317.646,235.118],
"diameter": 0.10160000000000001,
"face_hole": "auto",
"planned": true
},
……….
]
},
{
"row_name": "Row 2 (A-B 1)",
“holes”: [........]
}
]
where
type: ‘shot’: indicates, it is a Drill Design
row_count: Total number of rows
hole_count: Total number of holes
back_break: Back break,
burden_sample_type: Burden Sample Type,
hole_diameter: Hole Diameter,
max_burden_threshold: Maximum Burden Threshold,
min_burden_threshold: Minimum Burden Threshold,
shot_area: Shot Area,
shot_volume: Shot Volume,
subdrill: Subdrill,
rows: lists number of rows with the corresponding holes
row_name: Row Name of the row,
holes: List of holes of a row
hole_name: Hole name,
area: Area,
volume: Volume,
burden_azimuth: Burden Azimuth,
collar: Collar of a hole,
toe: Toe of a hole,
diameter: Hole Diameter,
face_hole: Is hole a Face Hole?,
planned: Is hole a Planned Hole?
Fragmentation API
Allows you to get the Fragmentation Data of your project. Fragmentation API lists all the detected and created Muckpiles and their corresponding information
Sample URL -> https://appdb.strayos.com/api/external/fragmentation/PROJECT_ID?api_key=API_KEY
Response:
Response of Fragmentation API as follows.
[
{
name: "Delta",
cut_volume: 1073.790439075117,
net_volume: 1016.8631464133698,
fill_volume: -56.92729266174727,
area: 1069.0994048563684,
max_base_elevation: 264.62985244256566,
min_base_elevation: 264.62985244256566,
mean_base_elevation: 264.62985244370503,
reference_elevation: 264.62985244256566,
rock_sizes: [0.169,0.243,0.326,0.442,0.631,0.905,1.189,1.424,1.74,2.55],
rock_sizes_3d: [0.189,0.263,0.36,0.507,0.745,1.08,1.26,1.498,1.83,2.55],
spoil_pile_degree: 0.5235987755982988,
rocks_statistics: {
rocks_count: 22591,
empty_aspect_ratio: 0.19294426039148826,
std_rocks_diameter: 0.16460804748535157,
mean_rocks_diameter: 0.09586089324951172,
maximum_rocks_diameter: 2.55,
minimum_rocks_diameter: 0.01
},
muckpile_statistics: {
area_m2: 1068.1876525878906
},
volume_bottom_manual_values: {
grade: 0,
azimuth: 0,
elevation: 263.7199072030749
},
rock_sizes_passing_percents: [
{ size: 10, passing_percent: 0.00019396833233752388 },
.....,
.....,
{ size: 2500, passing_percent: 0.9954619640612574 },
{ size: 2550, passing_percent: 1 }
],
rock_sizes_passing_percents_3d: [
{ size: 10, passing_percent: 0.00012985913371751324},
.....,
.....,
{ size: 2500, passing_percent: 0.994932076276007 },
{ size: 2550, passing_percent: 1 }
]
},
……….
]
where
name: Name of Muckpile
cut_volume, net_volume, fill_volume and area are the individual parameters of corresponding muckpiles
Stockpiles API
Allows you to get all the Stockpiles of your project. Stockpile API lists all the detected and created stockpiles and their corresponding information
Sample URL -> https://appdb.strayos.com/api/external/stockpiles/PROJECT_ID?api_key=API_KEY
Response:
Response of Stockpiles API as follows.
[
{
name: "Delta",
geometry: "FeatureCollection",
cut_volume: 1073.790439075117,
net_volume: 1016.8631464133698,
fill_volume: -56.92729266174727,
area: 1069.0994048563684,
stockpile_material: {
name: "No. 4 Stone Unwashed",
description: "No. 4 Stone Unwashed",
sku: "24150 - 535 - 0004",
stockpile_density: "52.208288",
stockpile_tonnage: "111750.611633342990256608",
currency: "USD",
price: "26.19",
notes: "Description notes about Stockpile"
},
}
……….
]
where
name: Name of Stockpile
geometry: Geometry of Stockpile
cut_volume, net_volume, fill_volume and area are the individual parameters of corresponding stockpiles
stockpile_material:
name: Stockpile Material Name
description: Stockpile Material Description
SKU: Stockpile Material SKU
currency, price: Stockpile Material currency and price details
density, tonnage: of Stockpile based on Material