History¶

0.11.0 (2020-11-04)¶

Added new functions for Node API Places endpoints:
- get_places_by_id()
- get_places_nearby()
- get_places_autocomplete()
Added new functions for Node API Projects endpoints:
- get_projects()
- get_projects_by_id()
Added new function for an additional Node API Observation endpoint:
- get_observation_species_counts()
- get_all_observation_species_counts()

Added support for simplified observation field syntax (observation_fields={id: value}) for create_observations() and update_observation()
Updated node_api.get_taxa_by_id() to accept multiple IDs
Updated rest_api.get_observations() with type conversion from strings to floats for response lat/long coordinates. Only applies to JSON response format.
Updated node_api.get_taxa_autocomplete() with optional min_rank and max_rank parameters, for consistency with get_taxa()
Using the params positional argument for the handful of functions that used it will raise a DeprecationWarning, but will otherwise still be functional until 0.12
Renamed search_query argument to q to be consistent with API request parameters
Using the search_query argument for rest_api.get_observation_fields() and rest_api.get_all_observation_fields() will raise a DeprecationWarning, but will otherwise still be functional until 0.12
Renamed create_observations() to create_observation(), as this only supports creating a single observation per call. This is aliased to create_observations() for backwards-compatibility, but will raise a DeprecationWarning.

Added example response data to docs all endpoints
Added links to official API reference to docs for all endpoints
Added full API request parameters to all API functions, in the form of keyword arguments with type annotations and docstrings
Added complete table of iNaturalist API endpoints and endpoints implemented by pyinaturalist
Added and improved usage examples
Numerous other documentation improvements
Made all API function signatures consistent by taking request params as keyword arguments

Added new Observation endpoint: rest_api.get_observations(), with 6 additional observation response formats, including GeoJSON, Darwin Core, and others

Added more info & examples to README for taxa endpoints, and other documentation improvements
Added conversion for all date and datetime parameters to timezone-aware ISO 8601 timestamps
Added a dry-run mode to mock out API requests for testing
Set up pre-release builds for latest development version

Bugfix: proper support for boolean and integer list parameters (see https://github.com/niconoe/pyinaturalist/issues/17).

Added new functions for Node API Taxa endpoints:
- node_api.get_taxa()
- node_api.get_taxa_autocomplete()
- node_api.get_taxa_by_id()

All functions now take an optional user-agent parameter in order to identify yourself to iNaturalist. If not set, Pyinaturalist/<VERSION> will be used.

rest_api.delete_observation() now raises ObservationNotFound if the observation doesn’t exist
minor dependencies update for security reasons