Описание API
1 AUTH
1.1 login
описание
В обмен на логин и пароль возвращает – hash hash – ключ живущий вне текущей HTTP сессии. Пердача hash достаточна для авторизации пользователя в функциях требующих авторизации. При вызове даной функции генерируется новый hash и соответсквенно старый перестает дейсвовать. Также hash может быть сброшен в связи с устареванием либо пользователем на своей странице.
API
HTTP GET/POST http://mytrails.ru/data/login?username={username}&password={password}
где
{username}
{password}
Ответ приходит в JSON в виде
{”message”:”сообщение об ошибке”,”cod”:”200″,”hash”:”" }
где
hash – формат – mt5621380a173991.52163263
2 UPLOAD DATA
2.1 Запись одной точки в трек по умолчанию
описание
Интерфейс для записи текущих координат логгером Для записи точки, пользоваетль должен аутентифицироваться Запись будет призводиться в терк по умолчанию. В случае отсутсвия такого трека, будет создан новый трек.
API
HTTP GET/POST http://mytrails.ru/data/save?hash={hash}&lat={lat}&lng={lng}&alt={alt}&utime={utime}&vl={vl}&qa={qa}&cell={cell}
где
{hash} – обязательный.
{lat} – обязательный. формат 55.987609
{lng} – обязательный. формат 34.908890
{alt} – высота в метрах [не обязательный]
{vl} – скорость [не обязательный]
{qa} – пеогрешность приема в метрах [не обязательный]
{cell} – cellid [не обязательный]
{utime} – время. формат unix time – 1155043457
Ответ приходит в JSON в виде
{”message”:”сообщение об ошибке”,”cod”:”200″,”track”:”122″ }
точка записыватес в трек по умолчанию, если такого нет, то создается новый трек.
примеры
2.2 upload
описание
Устаревшая. Будет удалена.
2.3 uploadraw
описание
Загрузка группы точек. Для записи, пользоваетль должен аутентифицироваться Запись будет призводиться в терк по умолчанию. В случае отсутсвия такого трека, будет создан новый трек.
API
HTTP GET/POST http://mytrails.ru/data/uploadraw?hash={hash}
где
{hash} – обязательный.
Ответ приходит в JSON в виде
{”message”:”сообщение об ошибке”,”cod”:”200″,”track”:”122″ }
3. MAPS
3.1 delmap
3.2 createmap
4. POINT
4.1 createpoint
API
HTTP GET/POST http://mytrails.ru/data/createpoint?hash={hash}[parametrs]
где
{hash} – обязательный.
[parametrs] {map_id} – ID карты {lat} – обязательный. формат 55.987609
{lng} – обязательный. формат 34.908890
{title}
{note}
{small_url}
{med_url}
{big_url}
{icon_id}
4.2 setpicture
API
HTTP GET/POST http://mytrails.ru/data/setpicture?hash={hash}[parametrs]
где
{hash} – обязательный.
[parametrs] {map_id} – ID карты {lat} – обязательный. формат 55.987609
{lng} – обязательный. формат 34.908890
{title}
{note}
{small_url}
{med_url}
{big_url}
{icon_id}
4.3 delpoint
4.4 Icons list
[{"name":"red34","id":"0","image":"/images/markers/marker_34_red.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"blue34","id":"1","image":"/images/markers/marker_34_blue.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"brow34","id":"2","image":"/images/markers/marker_34_brown.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"green34","id":"3","image":"/images/markers/marker_34_green.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"orange34","id":"4","image":"/images/markers/marker_34_orange.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"purple34","id":"5","image":"/images/markers/marker_34_purple.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"white34","id":"6","image":"/images/markers/marker_34_white.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"yellow34","id":"7","image":"/images/markers/marker_34_yellow.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"black34","id":"8","image":"/images/markers/marker_34_black.png","shadow":"", "sizeH":"34", "sizeW":"20", "anchorH":"34", "anchorW":"10" },
{"name":"green22A","id":"9","image":"/images/markers/marker_22_green_b.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"green22B","id":"10","image":"/images/markers/marker_22_green_b.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"red20","id":"11","image":"/images/markers/marker_20_red.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"blue20","id":"12","image":"/images/markers/marker_20_blue.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"20", "anchorW":"6" },
{"name":"brown20","id":"13","image":"/images/markers/marker_20_brown.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"green20","id":"14","image":"/images/markers/marker_20_green.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"orange20","id":"15","image":"/images/markers/marker_20_orange.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"purple20","id":"16","image":"/images/markers/marker_20_purple.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"white20","id":"17","image":"/images/markers/marker_20_white.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"yellow20","id":"18","image":"/images/markers/marker_20_yellow.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"black20","id":"19","image":"/images/markers/marker_20_black.png","shadow":"/images/markers/marker_20_shadow.png", "sizeH":"20", "sizeW":"12", "anchorH":"10", "anchorW":"10" },
{"name":"red10","id":"20","image":"/images/markers/marker_10_red.png","shadow":"", "sizeH":"10", "sizeW":"10", "anchorH":"5", "anchorW":"5" },
{"name":"green10","id":"21","image":"/images/markers/marker_10_green.png","shadow":"", "sizeH":"10", "sizeW":"10", "anchorH":"5", "anchorW":"5" },
{"name":"foto","id":"22","image":"/images/markers/marker_20_blue.png","shadow":"", "sizeH":"30", "sizeW":"40", "anchorH":"6", "anchorW":"20" }];
5. TRACK
5.1 deltrack
5.2 createtrack
описание
Создание нового трека. Для записи, пользоваетль должен аутентифицироваться.
API
HTTP GET/POST http://mytrails.ru/data/createtrack?hash={hash}
где
{hash} – обязательный.
{name} – имя
{privat} – 0 – просмотр для всех, 2 – закрытый, 1 – видим друзьям
{default} – 1 – сделать треком по умолчанию
Ответ приходит в JSON в виде
{”message”:”сообщение об ошибке”,”cod”:”200″,”id”:”122″ }
5.3 gettrackheader
6. GET DATA TRACK
6.1 Get track imgage
описание
интерфейс для генерации картинки с треком и картой.
API
Вариант вызова 1. Показ трека по его ID
HTTP GET http://mytrails.ru/data/img/id/{trackID}/zoom/{zoom}/size/{picture size}/type/{type}/format/{format}
где
{trackID} – ID трека -[обязательный параметр]
{zoom} – масштаб в понимании гугловых карт. 1 – самый большой/общий [не обязательный параметр, по умолчанию 16]
{picture size} – размер картинки в пиксехах. Пример – 200×300. 200 – ширина, 300 – высота картинки [не обязательный параметр, по умолчанию 250x300]
{format} – png32 , gif, jpg [не обязательный параметр, по умоляанию png32]
{type} – тип карты. ( не реализован) {mode} – all|start|end [не обязательный параметр, по умолчанию all]
Вариант вызова 2. Показ основного трека пользователя
HTTP GET http://mytrails.ru/data/img/uid/{UID}/zoom/{zoom}/size/{picture size}/type/{type}
где
{UID}- ID пользователя [обязательный параметр]
остальное аналогично варианту 1.
примеры
http://mytrails.ru/data/img/id/36
http://mytrails.ru/data/img/id/34/zoom/15/size/512×512
http://mytrails.ru/data/img/uid/1/zoom/15/size/250×300/format/gif
6.1 track
7. Copy Paste
7.1 selpastetrack
7.2 selcopytrack
7.3 selcuttrack
7.4 seldeltrack
8. ***************************** MAPS TRACK API start *******************************
8.1 mapsaddtrack
8.2 mapstrackslist
8.3 mapsdeltrack
9. MAPS POINTS API
9.1 mapspointslist
9.2 recalcpointslist
10 блоги
10.1 createblog
описание
Загрузка описания точки. Для записи, пользоваетль должен аутентифицироваться Запись будет призводиться в терк по умолчанию.
HTTP GET/POST http://mytrails.ru/data/описание?
+ параметры
{hash} – обязательный.
{pointid} – обязательный.
{iconid}
{title}
Ответ приходит в JSON в виде
{”message”:”сообщение об ошибке”,”cod”:”200″ }
11 Коды ошибок
200 – OK
400
401
403
500