API - Dados de ocorrências das espécies

INTERFACE

Esta interface permite o acesso aos dados de registros de ocorrências de espécies do explorador do SiBBr. Para realizar consultas à interface, siga as orientações abaixo.

1. /ocorrencias - REGISTROS DE OCORRÊNCIA

Estas consultas permitem buscar registros de ocorrência a partir da aplicação do filtro nome científico (scientificname).

Os resultados serão exibidos no formato JSON, com os seguintes campos:

  • count - Número de registros retornados pela constula.
  • occurrences - Lista de registros retornados pela consulta, com os seguintes campos:
    • auto_id - Identificador único de uma ocorrência dentro do sistema do Explorador de dados de biodiversidade.
    • decimallatitude - Latitude da coordenada, caso exista.
    • decimallongitude - Longitude da coordenada, caso exista.
    • resourcename - Nome do recurso ao qual a ocorrência pertence.
    • publishername - Nome do publicador ao qual a ocorrência pertence.
    • kingdom - O nome científico completo do reino em que o táxon é classificado.
    • phylum - O nome científico completo do filo em que o táxon é classificado.
    • _class - O nome científico completo da classe em que o táxon está classificado.
    • _order - O nome científico completo da ordem em que o táxon está classificado.
    • family - O nome científico completo da família em que o táxon é classificado.
    • genus - O nome científico completo do gênero em que o táxon está classificado.
    • specificepithet - O nome do epíteto específico do scientificName.
    • infraspecificepithet - O nome do epíteto de menor categoria ou hierarquia do scientificName, excluindo qualquer designação de categoria taxonômica.
    • species - Nome taxonômico completo da espécie à qual o registro de ocorrência pertence.
    • scientificname - O nome científico completo, com autoria e informações atualizadas se conhecido. Ao formar parte de uma identificação, este deve ser o nome em nível mais baixo da classificação taxonômica que pode ser determinado. Este termo não deve conter qualificações de identificação, que devem antes ser fornecidos no termo IdentificationQualifier.
    • taxonrank - O nível taxonômico do nome mais específico em scientificName. A prática recomendada é a utilização de um vocabulário controlado.
    • typestatus - Uma lista de tipos nomenclaturais (concatenada e separada) (status do tipo, nome científico tipificado, publicação) aplicada ao espécime.
    • recordedby - Uma lista de nomes de pessoas, grupos ou organizações (concatenados e separados) responsáveis ​​pelo registro da ocorrência original. O coletor ou observador primário, especialmente aquele que dá um identificador pessoal (recordNumber), deve ser o primeiro da lista.
    • eventdate - A data ou intervalo durante o qual ocorreu um evento. Para ocorrências, esta é a data quando o evento foi registrado. Não é adequado para um tempo em um contexto geológico. A prática recomendada é a utilização de um esquema de codificação, como a ISO 8601:2004 (E).
    • continent -O nome do continente em que a localização ocorre. A prática recomendada é a utilização de um vocabulário controlado, como o Getty Thesaurus of Geographic Names ou o código ISO 3166 Continent.
    • country - O nome do país ou maior unidade administrativa em que o local ocorre. A prática recomendada é a utilização de um vocabulário controlado, como o Getty Thesaurus of Geographic Names.
    • stateprovince - O nome da região administrativa menor do que país (estado, província, cantão, departamento, região, etc), em que ocorrre a localização.
    • municipality - O nome completo e não abreviado da próxima região administrativa menor do county (cidade, município, etc), em que a localização ocorre. Não use este termo para um incluir um nome de um lugar próximo que não contém a localização real.
    • county - O nome completo e não abreviado da próxima região administrativa menor do county (cidade, município, etc), em que a localização ocorre. Não use este termo para um incluir um nome de um lugar próximo que não contém a localização real.
    • minimumelevationinmeters - O limite inferior do intervalo de elevação (altitude, geralmente acima do nível do mar), em metros.
    • maximumelevationinmeters - O limite superior do intervalo de elevação (altitude, geralmente acima do nível do mar), em metros.
    • hascoordinates - Indica se o registro de ocorrência possui ou não coordenadas.
    • decimallatitude - A latitude geográfica (em graus decimais, utilizando o sistema de referência espacial dado em geodeticDatum) do centro geográfico de uma localização. Os valores positivos são ao norte do Equador, os valores negativos são ao sul. Os valores corretos ficam entre -90 e 90.
    • decimallongitude - A longitude geográfica (em graus decimais, utilizando o sistema de referência espacial dada em geodeticDatum) do centro geográfico de uma localização. Os valores positivos estão a leste do meridiano de Greenwich, valores negativos são a oeste dela. Os valores legais encontram-se entre -180 e 180.
    • hasmedia - Indica se o registro possui ou não dados multimedia.
    • associatedmedia - Uma lista de identificadores (concatenados e separados) (publicação, identificador único global, URI) da mídia associada com a ocorrência.
  • scientificName - Nome utilizado como filtro para consulta.
  • queryLength - Duração, em milissegundos, do tempo necessário para realizar a consulta.
PARÂMETROS
2. /recursos - RECURSOS

Esta consulta permite a listagem dos recursos disponíveis e a filtragem de ocorrências por recurso.

Os resultados serão exibidos no formato JSON, com os seguintes campos:

  • count - Número total de recursos disponíveis.
  • resources - Lista de recursos, com os seguintes campos:
    • id - Identificador único de um recurso dentro do sistema do explorador de dados de biodiversidade.
    • name - Nome do recurso.
    • archiveurl - O link do DwC-A na instalação de IPT (Integrated Publishing Toolkit) que está servindo o recurso na internet.
    • gbifpackageid - Identificador único do recurso no GBIF (Global Biodiversity Information Facility), caso exista, ou algum identificador alternativo para o recurso (alternateIdentifier).
    • recordcount - Número de registros de ocorrência pertencentes ao recurso no sistema.
    • publisherid - Identificador único do publicador do recuso dentro do sistema.
PARAMETERS
INTERFACE

This interface allows access to species occurrence data records from the SiBBr explorer. To query the interface, please follow the instructions:

1. /ocorrencias - OCCURRENCE RECORDS

These queries allow the search for occurrence records based on the usage of the scientific name filter (scientificname).

Results will be returned in the JSON format, with the following fields:

  • count - Amount of records returned by the query.
  • occurrences - List of records returned by the query, with the following fields:
    • auto_id - Unique identifier of an occurrence within the biodiversity data explorer.
    • resourcename - Name of the resource to which the occurrence belongs.
    • publishername - name of the publisher to which the occurrence belongs.
    • kingdom - The full scientific name of the kingdom in which the taxon is classified.
    • phylum - The full scientific name of the phylum or division in which the taxon is classified.
    • _class - The full scientific name of the class in which the taxon is classified.
    • _order - The full scientific name of the order in which the taxon is classified.
    • family - The full scientific name of the family in which the taxon is classified.
    • genus - The full scientific name of the genus in which the taxon is classified.
    • specificepithet - The name of the first or species epithet of the scientificName.
    • infraspecificepithet - The name of the lowest or terminal infraspecific epithet of the scientificName, excluding any rank designation.
    • species - The complete scientific name of the species which the the taxon is classified.
    • scientificname - The full scientific name, with authorship and date information if known. When forming part of an Identification, this should be the name in lowest level taxonomic rank that can be determined. This term should not contain identification qualifications, which should instead be supplied in the IdentificationQualifier term.
    • taxonrank - The taxonomic rank of the most specific name in the scientificName. Recommended best practice is to use a controlled vocabulary.
    • typestatus - A list (concatenated and separated) of nomenclatural types (type status, typified scientific name, publication) applied to the subject.
    • recordedby - The number of individuals represented present at the time of the Occurrence.
    • eventdate - The date-time or interval during which an Event occurred. For occurrences, this is the date-time when the event was recorded. Not suitable for a time in a geological context. Recommended best practice is to use an encoding scheme, such as ISO 8601:2004(E).
    • continent - The name of the continent in which the Location occurs. Recommended best practice is to use a controlled vocabulary such as the Getty Thesaurus of Geographic Names.
    • country - The name of the country or major administrative unit in which the Location occurs. Recommended best practice is to use a controlled vocabulary such as the Getty Thesaurus of Geographic Names.
    • stateprovince - The name of the next smaller administrative region than country (state, province, canton, department, region, etc.) in which the Location occurs.
    • municipality - The full, unabbreviated name of the next smaller administrative region than county (city, municipality, etc.) in which the Location occurs. Do not use this term for a nearby named place that does not contain the actual location.
    • county - The full, unabbreviated name of the next smaller administrative region than stateProvince (county, shire, department, etc.) in which the Location occurs.
    • minimumelevationinmeters - The lower limit of the range of elevation (altitude, usually above sea level), in meters.
    • maximumelevationinmeters - The upper limit of the range of elevation (altitude, usually above sea level), in meters.
    • hascoordinates - Indicates weather the occurrence record has coordinates or not.
    • decimallatitude - The geographic latitude (in decimal degrees, using the spatial reference system given in geodeticDatum) of the geographic center of a Location. Positive values are north of the Equator, negative values are south of it. Legal values lie between -90 and 90, inclusive.
    • decimallongitude - The geographic longitude (in decimal degrees, using the spatial reference system given in geodeticDatum) of the geographic center of a Location. Positive values are east of the Greenwich Meridian, negative values are west of it. Legal values lie between -180 and 180, inclusive.
    • hasmedia - indicates if the record has or not multimedia information.
    • associatedmedia - A list (concatenated and separated) of identifiers (publication, global unique identifier, URI) of media associated with the Occurrence.
  • scientificName - The name that was used as the query filter.
  • queryLength - Length, in milliseconds, of the amount of time required to fetch the results.
PARAMETERS
2. /recursos - RESOURCES

This query allows the listing of the available resources.

Results will be returned in the JSON format, with the following fields:

  • count - Total number of available resources.
  • resources - List of resources, with the following fields:
    • id - Unique identifier to a resource inside the biodiversity data explorer.
    • name - Resource name.
    • archiveurl - The DwC-A link in the IPT (Integrated Publishing Toolkit) installation that is serving the resource on the internet.
    • gbifpackageid - Unique identifier to the resource in GBIF (Global Biodiversity Information Facility), when it exists, or some alternate identifier to the resource (alternateIdentifier).
    • recordcount - Number of occurrence records in the system that belong to this resource.
    • publisherid - Unique identifier to the resource's publisher whithin the system.
PARAMETERS
SiBBr - Sistema de Informação sobre a Biodiversidade Brasileira