GeTS API¶

API based on HTTP protocol and YMapsML language.

• Table of contents
• GeTS API
  • Points
    • Add point
    • Remove point
    • Load points
    • Update point
  • Tracks
    • Add track
    • Load track
    • Update track's info
    • Remove track
  • Category
    • addCategory
    • getCategory
  • Users
    • Registration
    • Authorization
    • Quit session
    • Remove user

Points¶

Add point¶

Adds one or several points into database.

Request should be http://kappa.cs.karelia.ru/~davydovs/gets/addPoints.php

Request:

<request token="%token%" isPublic="%true/false%" channel="%channel%">
  <point>
    <!-- points in Yandex format -->
  </point>
<request>

Params:

• token - user's token (see function login)
• true/false - true if point should be in public space, otherwise - false
• channel - the name of user's channel or name of category channel
• list of points

Response:

<response>
%message%
%error%
<response>

Remove point¶

Load points¶

Loads points for circle defined by given: category, radius, latitude and longitude; or radius, latitude and longitude; or category.

Request should be GETS_SERVICE_URL/loadPoints.php

Request:

<request>
  <params>
    <auth_token>...</auth_token>
    <latitude>...</latitude>
    <longitude>...</longitude>
    <radius>...</radius>
    <category_name>...</category_name>
  </params>
</request>

auth_token - auth token string
latitude - float value
longitude - float value
radius - float non-negative value
category_name - name of category string

Response:

<response>
  <status>
    &lt;code&gt;...&lt;/code&gt;
    <message>...</message>
  </status>
  <content>
    %list of points in kml format%
  </content> 
</response>

Update point¶

Tracks¶

Add track¶

Load track¶

Update track's info¶

Remove track¶

Category¶

addCategory¶

getCategory¶

Users¶

Registration¶

Authorization¶

Authorize user with given login and password.
In response service will send auth token.

Request should be GETS_SERVICE_URL/login.php

Request:

<request>
  <params>
    <login>...</login>
    <password>...</password>
  </params>
</request>

login - login name string
password - password string

Response:

<response>
  <status>
    &lt;code&gt;...&lt;/code&gt;
    <message>...</message>
  </status>
  <content>
    <auth_token>...</auth_token>
  </content> 
</response>

auth_token - token which will be used in further GeTS transactions

Quit session¶

Remove user¶