Где Сейчас

contact/{id}/activity

Получить список активности

GET http://geome.im/api/v1/contacts/{id}/activity

Данный метод возвращает список запросов и ответов между двумя пользователями(мной и выбранным контактом).
Если поле position пустое, то это пользователь сделал запрос, в обратном случае - отправил свою позицию. Поле incoming (true/false) дает понять от кого пришла позиция или запрос (true - мне прислали, false - я отправил).

Параметры:

limit (optional) Число элементов, отдаваемых за раз (по умолчанию 10).
page (optional) Номер страницы (1,2,...)

Пример ответа

{ "data": [ { "time":"2012-01-24T20:34:54Z", "position":{ "latitude":60.0479, "longitude":30.3391, "radius":65, "address":"ул. Есенина, 26, СПб, Россия", "time":"2012-01-24T20:34:54Z" }, "incoming":true }, { "time":"2012-01-24T20:33:36Z", "incoming":false }, { "time":"2012-01-24T17:21:55Z", "position":{ "latitude":59.9683, "longitude":30.3045, "radius":76, "name":"Дома", "address":"Ординарная ул., 20, СПб, Россия", "picture":"http://gdeseychas.s3.amazonaws.com/images/u1/yr86kzh4ra.jpg", "time":"2012-01-24T17:21:55Z" }, "incoming":false }, { "time":"2012-01-24T15:28:20Z", "incoming":false } ] }

Отправить запрос "Где ты?"

POST http://geome.im/api/v1/contacts/{id}/activity

Параметров нет.

Отправить местоположение (checkin)

POST http://geome.im/api/v1/contacts/{id}/activity

Если передаются параметры местоположения (latitude,longitude или placeId), то будет отправлена позиция. В обратном случае (никаких координат не передается) контакту будет отправлен запрос.

Параметры:

latitude, longitude (required) Широта и долгота.
radius (optional) Точность местоположения. Необходимо передавать если пользователь отправляет свое текущее вычесленное телефоном местоположение.
placeId (optional) Id метки пользователя (см. GET /places).
Контакту будет отправлено местоположение в данном месте (в этом случае параметры latitude и longitude не учитываются).
name (optional) Название метки/места (например "м. Черная речка").
comment (optional) Уточняющий комментарий. Не боллее 30 символов.
Например: "Выхожу", "Подьехал", "Стою в пробке".
image (optional) Фото прикрепленное к позиции, размером не более 1024x768, пропорции любые. (Формат: Base64)
live (optional) Время жизни позиции в миллисекундах (не более 3 часов) - "Живая метка".
arrival_latitude, arrival_longitude (optional) Место прибытия при отправке живой метки.
type (optional) Тип уведомления: 'noalert' - без Push-уведомления, 'nohistory' - без занесения в историю и без уведомления. По умолчанию с тем и другим.

Пример ответа

{ "data":[ { "time":"2012-01-24T17:21:55Z", "position":{ "latitude":59.9683, "longitude":30.3045, "radius":50, "address":"Ординарная ул., 20", "time":"2012-01-24T17:21:55Z" }, "incoming":false } ] }

Если предыдущий запрос был выполнен не поздее чем 3 минуты назад, то при повторном запросе будет возвращена ошибка:

{ "error":{ "message":"JustRequestException", "code":1601 } }

Удаление записи из истории

DELETE http://geome.im/api/v1/contacts/{id}/activity/{itemId}

Запись удаляется для того кто ее удаляет. После удаления записи обоими контактами - она полностью удаляется из базы.