Documentação - API  

Dados do SIMBA disponibilizados por meio de API (Interface de Programação de Aplicações), de acordo com o padrão Darwin Core, disponível em http://rs.tdwg.org/dwc/.

Rotas:

https://simba.petrobras.com.br/simba/web/api/v1/occurrences/public?language=pt_BR

Descrição: Traz ocorrências disponiveis para o público, ordenadas pela data da ocorrência descendente
Método de acesso: GET
Autenticação necessária: Não
Observação: Essa rota retorna todos as ocorrências validadas existentes no sistemas, podendo levar alguns minutos para processar o retorno.

https://simba.petrobras.com.br/simba/web/api/v1/occurrences?language=pt_BR

Descrição: Traz ocorrências ordenadas pela data da ocorrência descendente
Método de acesso: GET
Autenticação necessária: Sim
Observação: Essa rota retorna todos as ocorrências validadas existentes no sistemas, podendo levar alguns minutos para processar o retorno.

Retorno das rotas:

Em XML pelo padrão Simple Darwin Core:
Tag root <SimpleDarwinRecordSet> com os seguintes atributos:

xmlns="http://rs.tdwg.org/dwc/xsd/simpledarwincore/"
xmlns:dc="http://purl.org/dc/terms/"
xmlns:dwc="http://rs.tdwg.org/dwc/terms/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://rs.tdwg.org/dwc/xsd/simpledarwincore/ http://rs.tdwg.org/dwc/xsd/tdwg_dwc_simple.xsd"


Uma tag <SimpleDarwinRecord> para cada ocorrência.


Tags de SimpleDarwinRecord:
smo multicelular
Tag Atributo no sistema Exemplo
<dc:type> Tipo PhysicalObject
<dc:modified> Data de modificação 2016-08-17T16:18:07-03:00
<dc:language> Linguagem pt-br
<dwc:institutionCode> Nome da instituição executora Univali
<dwc:datasetName> Nome do PMP PMP-BS Fase 1
<dwc:ownerInstitutionCode> Sigla da instituição responsável pela informação Univali
<dwc:basisOfRecord> Base de registro LivingSpecimen
<dc:dynamicProperties> JSON com dados adicionais. Código II do indivíduo e TSN(ITIS) da espécie
Para ocorrências de reprodução de quelônios, os dados estaram dispostos nessa tag
[{"tsn": "21412",
"cheloniaReproduction": { "family": "Emydidae", "species": "Trachemys dorbigni", "hatchingDay": "15", ... } }]
<dwc:occurrenceID> ID da ocorrência no Simba urn:[UNIVALI]:PMP_BS:SIMBA_123456
<dc:recordNumber> Identificador do indivíduo 024351
<dwc:recordedBy> Registrado por nome do usuário - nome do validador (esse último se existir) Alberto Martins - Marina Ferreira
<dwc:individualCount> Contagem de indivíduos 1
<dc:organismQuantity> Quantidade de organismos 1
<dc:organismQuantityType> Tipo da quantidade de organismos individuals
<dwc:associatedMedia> Imagens associadas http://exemplo.com/uploads/pmp_1/executing_institution_7/individual_fauna_occurrence/586beddb30437.JPG
<dwc:occurrenceRemarks> Observações Qualquer texto para observações da ocorrência
<dwc:organismID> Identificador do Indivíduo 065436
<dwc:organismScope> Tipo de organismo organismo multicelular
<dwc:eventID> ID do monitoramento/acionamento 5436
<dwc:event> Tipo do esforço Monitoramento
<dwc:parentEventID> Identificador do Indivíduo 065436
<dwc:fieldNumber> Ficha de campo UNI003121
<dwc:eventRemarks> Notações sobre o esforço Regular | Início: 22/04/2016 16:09 | Fim: 22/04/2016 16:29 | Ponto inicial: -24.5123556 | Ponto final: -48.4215123
<dwc:eventDate> Data da ocorrência 2016-02-24T16:43:07-03:00
<dwc:locationID> Código do trecho da praia em que ocorreu a ocorrência 5105
<dwc:continent> Continente América do Sul
<dwc:country> País Brasil
<dwc:countryCode> Código do país BR
<dwc:stateProvince> Estado Santa Catarina
<dwc:municipality> Cidade Laguna
<dwc:locality> Praia Barra do Saí
<dwc:decimalLatitude> Latitude -28.4738
<dwc:decimalLongitude> Longitude -48.76638
<dwc:geodeticDatum> Datum geodésico SIRGAS2000
Caso a ocorrência seja de fauna alvo individual:
Tag Atributo no sistema Exemplo
<dwc:sex> Sexo macho/fêmea/indefinido
<dwc:lifeStage> Estágio de desenvolvimento feto/filhote/juvenil/adulto/indeterminado
<dwc:habitat> Caracterização do ambiente água/arenoso/mangue/rochoso/outros
<dwc:scientificName> Nível taxonômico mais baixo Chelonia mydas
<dwc:kingdom> Reino taxonômico Animalia
<dwc:phylum> Filo taxonômico Chordata
<dwc:class> Classe taxonômica Reptilia
<dwc:order> Ordem taxonômica Testudines
<dwc:family> Família taxonômica Cheloniidae
<dwc:genus> Gênero taxonômico Chelonia
<dwc:specificEpithet> Espécie - sem o gênero mydas
<dwc:taxonRank> Menor nível taxonômico Espécie
Caso indivíduo tenha biometria:
Tag Atributo no sistema Exemplo
<dc:measurementID> ID da biometria, Tipo da biometria ID: 2544, Aves voadoras
<dc:measurementType> Campos da biometria "Comprimento da cabeça", "Altura do bico (na base)", "Altura do bico (em frente da narina-mínima)" ...
<dc:measurementValue> Valores dos campos, seguindo a ordem dos mesmos "23", "3,2", "1,5" ...
<dc:measurementDeterminedBy> Responsável da biometria Felipe Steiner
<dc:measurementDeterminedDate> Data da biometria 20/02/2017
Filtros existentes e suas regras:
Filtro Propósito Opções
beach Filtrar utilizando o nome da praia Praia brava
class Filtrar por classe taxonômica Mammalia
institution_code Filtrar utilizando o nome da instituição executora Argonauta
family Filtrar por família taxonômica Procellariidae
field_number Filtrar pela ficha de campo UNE000114
final_animal_condition Filtrar por condição final do animal alive/dead
gender Filtrar por sexo male/female/undefined
genus Filtrar por gênero taxonômico Puffinus
individual_identifier Filtrar por identificador do indivíduo 000004
language Linguagem de disponibilização dos dados. Filtro obrigatório en_US/pt_BR
limit Limite de resultados apresentados. Valor padrão 10, máximo 100. 10
monitoring_type Filtrar pelo tipo de monitoramento monitoring/nonEffort
municipality Filtrar utilizando o nome da cidade Itajaí
occurrence_id Filtrar por identificador do indivíduo 000004
occurrence_type Filtrar pelo tipo de ocorrência da desova (somente ORQ) cd_spawning/ml_half_moon/sd_without_spawning/pi_interrupted_process/undetermined
offset Quantidade de valores a serem ignorados a partir do primeiro resultado. Valor padrão 0. 0
order Filtrar por ordem taxonômica Procellariiformes
organism_id Filtrar por id do organismo urn:[UNIVALI]:PMP_BS:SIMBA_031332
point Filtrar por ponto latitude/longitude -24.26386,-46.91722
range Raio de distância a partir do ponto, em metros. 50
record_number Filtrar por identificador do indivíduo 000004
scientific_name Filtrar por espécie taxonômica Puffinus gravis
specific_epithet Filtrar por epíteto específico gravis
stretch Filtrar utilizando o nome do trecho Brava - Norte

Exemplo de filtro

Autenticado:https://simba.petrobras.com.br/simba/web/api/v1/occurrences?language=pt_BR&executing_institution=univali&gender=male&class=Aves
Público:https://simba.petrobras.com.br/simba/web/api/v1/occurrences/public?language=pt_BR&executing_institution=univali&gender=male&class=Aves

Obs: Os filtros devem estar separados por "&".
Exemplo de retorno XML:

    <?xml version="1.0" encoding="UTF-8"?>
        <SimpleDarwinRecordSet xmlns="http://rs.tdwg.org/dwc/xsd/simpledarwincore/"
                               xmlns:dc="http://purl.org/dc/terms/"
                               xmlns:dwc="http://rs.tdwg.org/dwc/terms/"
                               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                               xsi:schemaLocation="http://rs.tdwg.org/dwc/xsd/simpledarwincore/ http://rs.tdwg.org/dwc/xsd/tdwg_dwc_simple.xsd">
             <SimpleDarwinRecord>
              <dc:type>PhysicalObject</dc:type>
              <dc:modified>2016-11-21T20:42:38-02:00</dc:modified>
              <dc:language>pt_BR</dc:language>
              <dwc:institutionCode>Univali</dwc:institutionCode>
              <dc:datasetName>PMP-BS Fase 1</dc:datasetName>
              <dc:ownerInstitutionCode>Univali</dc:ownerInstitutionCode>
              <dc:basisOfRecord>LivingSpecimen</dc:basisOfRecord>
              <dc:dynamicProperties>[{"TSN": "176849", }]</dc:dynamicProperties>
              <dwc:occurrenceID>urn:[Univali]:PMP_BS:SIMBA_027509</dwc:occurrenceID>
              <dwc:recordNumber>027509</dwc:recordNumber>
              <dwc:recordedBy>João Paulo Zacharias Pfeilsticker</dwc:recordedBy>
              <dwc:individualCount>1</dwc:individualCount>
              <dwc:organismQuantity>1</dwc:organismQuantity>
              <dwc:organismQuantityType>individuals</dwc:organismQuantityType>
              <dwc:associatedMedia>
                  uploads/pmp_1/executing_institution_1/individual_fauna_occurrence/58335c144c44b.JPG,
                  uploads/pmp_1/executing_institution_1/individual_fauna_occurrence/58335c2d1f67b.JPG
              </dwc:associatedMedia>
              <dwc:organismID>027509</dwc:organismID>
              <dwc:organismScope>organismo multicelular</dwc:organismScope>
              <dwc:eventID>5966</dwc:eventID>
              <dwc:event>Acionamento</dwc:event>
              <dwc:parentEventID>027509</dwc:parentEventID>
              <dwc:fieldNumber>UNI002942</dwc:fieldNumber>
              <dwc:eventRemarks>Acionamento | Data: 17/11/2016 11:00</dwc:eventRemarks>
              <dc:eventDate>2016-11-17T12:06:00-02:00</dc:eventDate>
              <dwc:locationID>5041</dwc:locationID>
              <dwc:continent>América do Sul</dwc:continent>
              <dwc:country>Brasil</dwc:country>
              <dwc:countryCode>BR</dwc:countryCode>
              <dwc:stateProvince>Santa Catarina</dwc:stateProvince>
              <dwc:municipality>Itajaí</dwc:municipality>
              <dwc:locality>Praia não identificada</dwc:locality>
              <dwc:decimalLatitude>-26.9092</dwc:decimalLatitude>
              <dwc:decimalLongitude>-48.65168</dwc:decimalLongitude>
              <dwc:geodeticDatum>SIRGAS2000</dwc:geodeticDatum>
              <dwc:habitat>Outros</dwc:habitat>
              <dwc:scientificName>Larus dominicanus</dwc:scientificName>
              <dwc:sex>Indefinido</dwc:sex>
              <dwc:lifeStage>Adulto</dwc:lifeStage>
              <dwc:kingdom>Animalia</dwc:kingdom>
              <dwc:phylum>Chordate</dwc:phylum>
              <dwc:class>Aves</dwc:class>
              <dwc:order>Charadriiformes</dwc:order>
              <dwc:family>Laridae</dwc:family>
              <dwc:genus>Larus</dwc:genus>
              <dwc:specificEpithet>dominicanus</dwc:specificEpithet>
              <dwc:taxonRank>Espécie</dwc:taxonRank>
             </SimpleDarwinRecord>
        </SimpleDarwinRecordSet>