Base de Conhecimento

A API GeoCoordenadas permite pesquisar geoCoordenadas coletadas em execuções de atividades, bem como a coleta de geoCoordenadas geradas periodicamente.

Elementos da GeoCoordenada

Busca por lista de GeoCoordenadas

GET /CenterWeb/api/{$apiKey}/geoCoordinate.xml?date=2020-08-19

É sempre necessário informar uma data para realizar a busca. Se ainda preferir, pode refinar as pesquisas enviando parâmetros na requisição, para isso é necessário adicionar parâmetros igual realizamos em uma requisição HTTP:

Exemplo 1: Filtro por agente

GET /CenterWeb/api/{$apiKey}/geoCoordinate.xml?agent=111

Esta requisição está pedindo todas as geoCoordenadas para o agente de código 111.

Exemplo 2: Filtro por data de inicio e fim

GET /CenterWeb/api/{$apiKey}/geoCoordinate.xml?initialDate=2015-01-01&finalDate=2015-01-10

Esta requisição está pedindo todas as geoCoordenadas realizadas entre o dia 01 de Janeiro de 2015 e 10 de Janeiro de 2015.

Exemplo 3: Filtro por data e hora de inicio e fim

GET /CenterWeb/api/{$apiKey}/geoCoordinate.xml?initialDateTime=2015-01-01 09:00:00&finalDateTime=2015-01-01 10:30:00

Esta requisição está pedindo todas as geoCoordenadas realizadas no dia 01 de Janeiro de 2015 entre 9hs e 10:30hs.

Enviar parâmetros para a API uMov.me é simples assim.

A resposta da requisição será uma mensagem contendo o total de registro retornados e uma lista simples, sem detalhes de cada registro retornado, contendo para cada entrada, o Id do registro no uMov.me e o link que pode ser usado para recuperar os dados específicos deste registro. Veja um exemplo, do resultado de uma requisição que foi feita em XML:

<result>

<resourceName>geoCoordinate</resourceName>

<size>20</size>

<entries>

<entry id="1" link="/geoCoordinate/1.xml"/>

<entry id="2" link="/geoCoordinate/2.xml"/>

</entries>

</result>

Busca por uma GeoCoordenada em específico

GET /CenterWeb/api/{$apiKey}/geoCoordinate/{$id}.xml

Este recurso serve para puxar dados de uma geoCoordenada específica do sistema. Veja o exemplo de retorno de uma entidade abaixo (considerando uma requisição feita em XML):

<geoCoordinate>

<id>1031047</id>

<agent>...</agent>

<date>2012-12-27</date>

<hour>161243</hour>

<latitude>0.0</latitude>

<longitude>0.0</longitude>

<type>ON_START_ACTIVITY</type>

<observation>Não foi possível capturar as coordenadas. A pessoa desistiu após tentar novamente 0 vezes.</observation>

<provider/>

<withGps>true</withGps>

<gpsEnabled>true</gpsEnabled>

<networkEnabled>false</networkEnabled>

<activityHistory>...</activityHistory>

</geoCoordinate>

GeoCoordinate (GeoCoordenadas)