API description

The RLS PQ API provides content negotiated access to the Reef Life Survey's Photo Quadrats. It features json and csv output of the available PQ metadata, and provides original and 800px and 50px scaled versions of each PQ.

The PQs are part of the Reef Life Survey's visual census method. You can read more about the methods in the Methods manual over at reeflifesurvey.com.

PostMan

The RLS PQ API does not have styled output for viewing as webpages, rather it defaults to json formatting for metadata and allows inline display and download of the PQ images.

To specify CSV formatting for the metadata, your programming environment can set the Accept headers of the http request for the RLS PQ API server. Or you can use a visual application like Postman

Features

Metadata for a single survey

Default behaviour with webbrowser display in stylised json.

Available as content-type: application/json and text/csv

Example: http(s)://rls.tpac.org.au/pq/2000862/

Metadata for a single survey (downloaded)

Default behaviour with webbrowser: download as text file

Available as content-type: text/plain (content-disposition attachment; filename="[surveyid].txt")

Example: http(s)://rls.tpac.org.au/pq/2000862/index/download

List of all catalogued surveys

Default behaviour with webbrowser display in stylised json.

Available as content-type: application/json and text/csv

Example: http(s)://rls.tpac.org.au/pq/survey_ids/

Note: Because this is a long list stylised json, download and rendering performance can be low. Consider onlye use as application/json or text/csv.

Original scale Jpeg image

Default behaviour with webbrowser: inline display

Available as content-type: image/jpeg

Example: http(s)://rls.tpac.org.au/pq/912343962/LHI-19_6m190214SugarloafWestAJG(0).JPG/

Original scale Jpeg image (download)

Default behaviour with webbrowser: download as file

Available as content-type: image/jpeg (content-disposition →attachment; filename="[filename]")

Example: http(s)://rls.tpac.org.au/pq/912343962/LHI-19_6m190214SugarloafWestAJG(1).JPG/download/

800 pixel scaled Jpeg image

Default behaviour with webbrowser: download as file

Available as content-type: image/jpeg

Example: http(s)://rls.tpac.org.au/pq/912343962/scale/800/LHI-19_6m190214SugarloafWestAJG(0).JPG/

800 pixel Jpeg image (download)

Default behaviour with webbrowser: download as file

Available as content-type: image/jpeg (content-disposition →attachment; filename="[filename]")

Example: http(s)://rls.tpac.org.au/pq/912343962/scale/800/LHI-19_6m190214SugarloafWestAJG(0).JPG/download/

50 pixel scaled Jpeg image

Default behaviour with webbrowser: download as file

Available as content-type: image/jpeg

Example: http(s)://rls.tpac.org.au/pq/912343962/scale/50/LHI-19_6m190214SugarloafWestAJG(0).JPG/

50 pixel Jpeg image (download)

Default behaviour with webbrowser: download as file

Available as content-type: image/jpeg (content-disposition attachment; filename="[filename]")

Example: http(s)://rls.tpac.org.au/pq/912343962/scale/50/LHI-19_6m190214SugarloafWestAJG(0).JPG/download/

Archive of all PQs for a SurveyID (Original scale)

Default behaviour with webbrowser: download as zip file

Available as content-type application/zip (content-disposition attachment; filename="[surveyid].zip")

Example: http(s)://rls.tpac.org.au/pq/912344043/zip/

Note on Pseudo-coordinates

The PQs are taken at intervals along the Survey transect line. Each PQ gets a rough, post-calculated pseudo-coordinate pair assigned to aid in geo-referencing it. The pseudo-coordinate is not guaranteed to be an exact representation of where the PQ was taken.