Get_Where

Description

Gets a collection of POI filtering by various criteria. You can request several POI in a single call.

URL

/VERSION/pois/get_where.FORMAT

Available Format

KML,JSON

HTTP Method

GET

Accepted Version

1

Requires

Authorization.

Headers

Parameters

  • access_token: (Required) access_token to user resources.
  • pois: (Optional) POI identifier list you want to retrieve, separated by commas.
  • categories: (Required)IDs of categories filter, the POI obtained belong to all specified, separated by commas.
  • city: (Optional) get the POI in the city specified.
  • country: (Optional) get the POI in the province specified.
  • postal_code:(Optional) get the POI whose zip code matches the specified.
  • q: (Optional) get the POI whose name or description matched the pattern

Example

https://api.topoos.com/1/pois/get_where.json?access_token=b9955415-82d3-4481-a736-330d962df9ea&categories=21&pois=6595

Reply

JSON example reply

[{
    id: 6595,
    name: "Recoletas",
    description: "Monasterio",
    latitude: 40.953107,
    longitude: -4.123233,
    elevation: 0,
    accuracy: 0,
    vaccuracy: 0,
    registertime: "2012-12-11T08:11:56.570+01:00",
    categories: [{
        Id: 21,
        Description: "carreras",
        is_system_category: false
    }],
    address: "Paseo Del Obispo 18,40001 Segovia",
    cross_street: "Paseo Del Obispo 18",
    city: "Segovia",
    country: null,
    postal_code: null,
    phone: null,
    twitter: "#Recoletas",
    last_update: "2012-12-11T08:11:56.570+01:00",
    warnings: {
        closed: 1,
        duplicated: 1,
        wrong_indicator: 1,
        wrong_info: 1
    }
}]