Add

Description

Add a new point of interest (POI). Address Fields, cross_street, city, country, and postalCode not specified, it will attempt to automatically generate.

URL

/VERSION/pois/add.FORMAT

Available Format

JSON

HTTP Method

GET

Accepted Version

1

Require

Authorization.

Headers

Parameters

  • access_token: (Required) access_token to user resources.
  • lat: (Required)latitude of the new position. Decimal.
  • lng: (Required) length of the new position. Decimal.
  • geocode: (Optional) Try to geocode the specified lat and lng, to fill unspecified attributes. Default value: true. WARNING: This default value will be deprecated at 15/05/2013; if you need this functionality, you must specify explicit true value.
  • accuracy: (Optional) accuracy of the position (latitude, longitude). Decimal.
  • vaccuracy: (Optional) accuracy of the elevation. Decimal.
  • elevation: (Optional) elevation relative to sea level. Decimal.
  • categories: (Required) IDs of the categories to which the POI belongs, separated by commas
  • name: (Required) landmark name. String. 255 characters.
  • desc: (Optional) landmark description. String. Maximum 1024 characters.
  • address: (Optional) direction of the point of interest. String. Maximum 255 characters.
  • cross_street: (Optionall) cross street. String. Maximum 255 characters.
  • city: (Optional) City landmark. String. Maximum 100 characters.
  • country: (Optional)status. String. Maximum 100 characters.
  • postal_code: (Optional) ZIP code. String. Maximum 12 characters.
  • phone: (Optional) telephone number. String. Maximum 20 characters.
  • twitter: (Optional) userid or Twitter hashtag. String. Maximum 50 characters.

Example

https://api.topoos.com/1/pois/add.json?access_token=62f5280d-c954-4ee7-a0a8-68ff9c2810d8&lat=40.953107&lng=-4.123233&accuracy=0.0&vaccuracy=0.0&elevation=0.0&categories=21&name=Recoletas&desc=Monasterio&postal_code=40003

Reply

JSON example reply

{
    "id": 6548,
    "name": "Recoletas",
    "description": "Monasterio",
    "latitude": 40.953107,
    "longitude": -4.123233,
    "elevation": 0,
    "accuracy": 0,
    "vaccuracy": 0,
    "registertime": "2012-12-05T13:17:13.738+00: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-05T13:17:13.738+00:00",
    "warnings": {
        "closed": 0,
        "duplicated": 0,
        "wrong_indicator": 0,
        "wrong_info": 0
    }
}