places.getCheckins

Возвращает список отметок пользователей в местах согласно заданным параметрам.

Данный метод устарел и может быть отключён через некоторое время, пожалуйста, избегайте его использования.

Этот метод можно вызвать с ключом доступа пользователя.

Параметры

latitude

string

Географическая широта исходной точки поиска, заданная в градусах (от -90 до 90).

longitude

string

Географическая долгота исходной точки поиска, заданная в градусах (от -180 до 180).

place

string

Идентификатор места. Игнорируется, если указаны latitude и longitude.

user_id

string

Идентификатор пользователя. Игнорируется, если указаны latitude и longitude или place.

offset

string

Смещение относительно первой отметки для выборки определенного подмножества. Игнорируется, если установлен ненулевой timestamp.

count

string

Количество возвращаемых отметок. Игнорируется, если установлен ненулевой timestamp.

timestamp

string

Указывает, что нужно вернуть только те отметки, которые были созданы после заданного timestamp.

friends_only

string

1 — указывает, что следует выводить только отметки друзей, если заданы географические координаты. Игнорируется, если не заданы параметры latitude и longitude.

need_places

string

Указывает, следует ли возвращать информацию о месте в котором была сделана отметка. Игнорируется, если указан параметр place.

Результат

После успешного выполнения возвращает количество отметок и массив объектов chekin, каждый из которых имеет следующие поля:

•
id — идентификатор отметки;
•
user_id — идентификатор отметившегося пользователя;
•
date — дата добавления отметки в формате unixtime;
•
latitude — географическая широта, заданная в градусах (от -90 до 90);
•
longitude — географическая долгота, заданная в градусах (от -180 до 180);
•
place_id — идентификатор места;
•
text — текст сопроводительного сообщения;
•
distance — расстояние от места до заданной точки.

Если в запросе был задан параметр need_places, то в объекте могут дополнительно содержаться следующие поля:

•
place_title — наименование места,
•
place_country — идентификатор страны,
•
place_city — идентификатор города,
•
place_address — адрес,
•
place_type — тип места,
•
place_icon.

Если не заданы параметры latitude и longitude или параметр place, то будет возвращена лента обновлений отметок друзей. При указании параметра timestamp будут возвращены только те отметки из ленты обновлений, которые были созданы после указанного значения timestamp. Если timestamp не указан, то отметки из ленты будут возвращены с учетом параметров offset и count (если они заданы).

Если заданы параметры latitude и longitude, то будут возвращены все отметки, сделанные за последние 24 часа, координаты которых находятся недалеко от Вас. Если задан параметр friends_only, то будут возвращены только последние ближайшие отметки Ваших друзей.

Если задан параметр place, то будут возвращены последние 20 отметок, сделанные в месте с идентификатором, указанном в параметре place.

Если задан параметр uid, то будут возвращены последние 20 отметок, сделанные пользователем с идентификатором, указанном в параметре uid.

Коды ошибок

В ходе выполнения могут произойти общие ошибки.