Yes, the 2 new interpreted fields will be included in downloads (DarwinCore 
Archive and Simple CSV).

--
Christian Gendreau
Software Developer
Global Biodiversity Information Facility (GBIF)
cgendreau at gbif.org
http://www.gbif.org

From: "Peter (work)" <peter.desmet.work at 
gmail.com<mailto:peter.desmet.w...@gmail.com>>
Date: Monday 4 April 2016 18:02
To: "tuco at berkeley.edu<mailto:tuco at berkeley.edu>" <tuco at 
berkeley.edu<mailto:tuco at berkeley.edu>>
Cc: Christian Gendreau <cgendreau at gbif.org<mailto:cgendreau at gbif.org>>, 
"api-users at lists.gbif.org<mailto:api-users at lists.gbif.org>" <api-users at 
lists.gbif.org<mailto:api-users at lists.gbif.org>>
Subject: Re: [API-users] Changes to GBIF API

Awesome! Will those be included in the non-verbatim downloads too?

Op 4 apr. 2016 om 18:32 heeft John Wieczorek <tuco at berkeley.edu<mailto:tuco 
at berkeley.edu>> het volgende geschreven:

Excellent!

On Mon, Apr 4, 2016 at 11:56 AM, Christian Gendreau <cgendreau at 
gbif.org<mailto:cgendreau at gbif.org>> wrote:
Dear API users,

Based on the recommendations from the GBIF Data Fitness for Use in Distribution 
Modelling group and user feedback, the GBIF Informatics team decided to apply 
some changes to the GBIF API for the occurrences[1] response. We decided to 
deprecate the field "coordinateAccuracy" in favor of the DarwinCore terms based 
fields "coordinateUncertaintyInMeters"[2] and "coordinatePrecision"[3] as 
provided(see details below) by the data publishers.

The JSON response will remain the same structure except:
- coordinateAccuracy will never be found since it will be null and null values 
are not provided explicitly (same as the current behaviour for most records)
- coordinateUncertaintyInMeters and coordinatePrecision will be included 
(example: coordinateUncertaintyInMeters: 1000, coordinatePrecision: 0.0001)

These changes should not break existing applications using the JSON API, and 
therefore as a non breaking change can be included in the V1 of our API as an 
enhancement.

Details:
-coordinateUncertaintyInMeters:
DarwinCore definition: "The horizontal distance (in meters) from the given 
decimalLatitude and decimalLongitude describing the smallest circle containing 
the whole of the Location. Leave the value empty if the uncertainty is unknown, 
cannot be estimated, or is not applicable (because there are no coordinates). 
Zero is not a valid value for this term."
GBIF comment: double, must be greater and not equals to 0 and lower than 
5000000 (5000 km), as provided by data publishers with unit stripped (if the 
value is provided in imperial, conversion will be applied), related issue 
OccurrenceIssue.COORDINATE_UNCERTAINTY_METERS_INVALID.

-coordinatePrecision:
DarwinCore definition: "A decimal representation of the precision of the 
coordinates given in the decimalLatitude and decimalLongitude."
GBIF comment: double, must be between 0 and 1, elated occurrence issue 
OccurrenceIssue.COORDINATE_PRECISION_INVALID

We expect the changes to be available next week (between 11-15 April 2016).

The GBIF Informatics team

----
[1] http://www.gbif.org/developer/occurrence
[2] http://rs.tdwg.org/dwc/terms/coordinateUncertaintyInMeters
[3] http://rs.tdwg.org/dwc/terms/coordinatePrecision

GBIF Issue tracking reference: http://dev.gbif.org/issues/browse/POR-2795


_______________________________________________
API-users mailing list
API-users at lists.gbif.org<mailto:API-users at lists.gbif.org>
http://lists.gbif.org/mailman/listinfo/api-users


_______________________________________________
API-users mailing list
API-users at lists.gbif.org<mailto:API-users at lists.gbif.org>
http://lists.gbif.org/mailman/listinfo/api-users
-------------- next part --------------
An HTML attachment was scrubbed...
URL: 
<http://lists.gbif.org/pipermail/api-users/attachments/20160405/0d15f254/attachment.html>

Reply via email to