API Documentation - MAP API


        <h1>API Documentation - MAP API</h1>

        <b>Only use &ts=UNIX_TIMESTAMP  parameter to view archived data.</b>

        <h2>Get data for monitoirng map.</h2>

        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/data?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/data?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386<br/>
            
        <br/>
        <b>View Archived</b>:<br/>
        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/data?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386&ts=1747283517<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/data?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386&ts=1747283517<br/>
            
        <p>
            Returns JSON object used to make monitoring map.
        </p>
        
        <h2>Get data in GEO JSON Format Within Predefined Area</h2>

        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson/geojson?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386<br/>

        <br/>
        <b>View Archived</b>:<br/>
        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386&ts=1747283517<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?lat1=46.1749&lat2=46.2250&long1=-122.2161&long2=-122.14386&ts=1747283517<br/>

        <h2>Get data in GEO JSON Format Within Polygon</h2>

        curl -i --header "device_token:MY-DEVICE-TOKEN" -X POST 
            -d  '{"coordinates":[[-121.76, 46.853],[-121.49, 46.206],[-122.18, 46.2]]}'
            https://volcanoes.usgs.gov/vsc/api/instrumentApi/polygon<br/>
        <b>OR</b><br/>
        curl -i -X POST -d '{"coordinates":[[-121.76, 46.853],[-121.49, 46.206],[-122.18, 46.2]]}'
            https://volcanoes.usgs.gov/vsc/api/instrumentApi/polygon<br/>

        <br/>
        <b>View Archived</b>:<br/>
        curl -i --header "device_token:MY-DEVICE-TOKEN" -X POST 
            -d  '{"coordinates":[[-121.76, 46.853],[-121.49, 46.206],[-122.18, 46.2]], "ts":1747283517}'
            https://volcanoes.usgs.gov/vsc/api/instrumentApi/polygon<br/>
        <b>OR</b><br/>
        curl -i -X POST -d  '{"coordinates":[[-121.76, 46.853],[-121.49, 46.206],[-122.18, 46.2]], "ts":1747283517}'
            https://volcanoes.usgs.gov/vsc/api/instrumentApi/polygon<br/>
        <br/>


        <h2>Get data in GEO JSON Format By Volcano VNUM</h2>

        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vnum=311060<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson/geojson?vnum=311060<br/>

        <br/>
        <b>View Archived</b>:<br/>
        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vnum=311060&ts=1747283517<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vnum=311060&ts=1747283517<br/>

        <h2>Get data in GEO JSON Format By Volcano Group (Usually Volcano Observatory)</h2>

        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vgroup=AVO<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson/geojson?vgroup=AVO<br/>
        
        <br/>
        <b>View Archived</b>:<br/>
        curl -i --header "device_token:MY-DEVICE-TOKEN" -X GET 
                https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vgroup=AVO&ts=1747283517<br/>
        <b>OR</b><br/>
        curl -i -X GET https://volcanoes.usgs.gov/vsc/api/instrumentApi/geojson?vgroup=AVO&ts=1747283517<br/>

        <h2>Notes:</h2>
        
        <p>
            TIMESTAMP values are optional. TIMESTAMP is seconds since January 1, 1970 UTC. Currently 1747283517
            If not provided, 
            current data is returned. <b>Add &ts=UNIX_TIMESTAMP as a parameter to view archived data.</b>
        </p>