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
Dear API users, I'm developing a software tool for managing taxonomic information within a given area. This for (re)building community assemblages based on the data provided by GBIF. I need to have the global Id key for all the taxonomic levels but so far I haven't found the way for making the API to include these fields, it only gives me the names (strings) and I want an integer. Can you throw me some light on the needed http request ? Or, Is it possible at all? Thank you for your time, Best wishes, Juan On 04/04/16 15:56, Christian Gendreau 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@lists.gbif.org http://lists.gbif.org/mailman/listinfo/api-users
Hi Juan, Can you please send an example of a call you make? The occurrence records return the higher keys, as per this example: http://api.gbif.org/v1/occurrence/1227769253 Thanks, Tim From: API-users <api-users-bounces@lists.gbif.org<mailto:api-users-bounces@lists.gbif.org>> on behalf of "Juan M. Escamilla Molgora" <j.escamillamolgora@lancaster.ac.uk<mailto:j.escamillamolgora@lancaster.ac.uk>> Date: Monday 4 April 2016 at 17:36 To: "api-users@lists.gbif.org<mailto:api-users@lists.gbif.org>" <api-users@lists.gbif.org<mailto:api-users@lists.gbif.org>> Subject: [API-users] Missing Id field for taxonomic levels (genus, family, class, order, phylum) Dear API users, I'm developing a software tool for managing taxonomic information within a given area. This for (re)building community assemblages based on the data provided by GBIF. I need to have the global Id key for all the taxonomic levels but so far I haven't found the way for making the API to include these fields, it only gives me the names (strings) and I want an integer. Can you throw me some light on the needed http request ? Or, Is it possible at all? Thank you for your time, Best wishes, Juan On 04/04/16 15:56, Christian Gendreau 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@lists.gbif.org<mailto:API-users@lists.gbif.org>http://lists.gbif.org/mailman/listinfo/api-users
Excellent! On Mon, Apr 4, 2016 at 11:56 AM, Christian Gendreau <cgendreau@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@lists.gbif.org http://lists.gbif.org/mailman/listinfo/api-users
Awesome! Will those be included in the non-verbatim downloads too?
Op 4 apr. 2016 om 18:32 heeft John Wieczorek <tuco@berkeley.edu> het volgende geschreven:
Excellent!
On Mon, Apr 4, 2016 at 11:56 AM, Christian Gendreau <cgendreau@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@lists.gbif.org http://lists.gbif.org/mailman/listinfo/api-users
_______________________________________________ API-users mailing list API-users@lists.gbif.org http://lists.gbif.org/mailman/listinfo/api-users
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@gbif.org http://www.gbif.org From: "Peter (work)" <peter.desmet.work@gmail.com<mailto:peter.desmet.work@gmail.com>> Date: Monday 4 April 2016 18:02 To: "tuco@berkeley.edu<mailto:tuco@berkeley.edu>" <tuco@berkeley.edu<mailto:tuco@berkeley.edu>> Cc: Christian Gendreau <cgendreau@gbif.org<mailto:cgendreau@gbif.org>>, "api-users@lists.gbif.org<mailto:api-users@lists.gbif.org>" <api-users@lists.gbif.org<mailto:api-users@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@berkeley.edu<mailto:tuco@berkeley.edu>> het volgende geschreven: Excellent! On Mon, Apr 4, 2016 at 11:56 AM, Christian Gendreau <cgendreau@gbif.org<mailto:cgendreau@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@lists.gbif.org<mailto:API-users@lists.gbif.org> http://lists.gbif.org/mailman/listinfo/api-users _______________________________________________ API-users mailing list API-users@lists.gbif.org<mailto:API-users@lists.gbif.org> http://lists.gbif.org/mailman/listinfo/api-users
participants (5)
-
Christian Gendreau -
John Wieczorek -
Juan M. Escamilla Molgora -
Peter (work) -
Tim Robertson