Skip to Content

TwentyThree

TwentyThree™ API

API Method: /api/photo/coordinate/add

Add a new geographic coordinate to a photo or video, usually in order to place it on a map. You can add multiple coordinates to any single photo or video object.

Once a coordiate has been added, it's is listed in /api/photo/list.

Parameters

ParameterDescription
photo_id (required) The ID of the photo object to attach to a coordinates
search_string A search string for a coordinate to attach to the photo or video. Behind the scenes we're using Google Maps API to perform the lookup, and we will attach only the best match as a coordinate. If the search string doesn't yield any matches, a no_such_coodinate error is returned. If you wish for more flexibility in which coordinate is chosen, use latitude and longitude to specify the locations.
latitude A latitude to attach to the photo or video. This parameter must be used along with longitude.
longitude A longitude to attach to the photo or video. This parameter must be used along with latitude.

Permission level

The minimum required permission level is:

write

Example XML Response

<response status="ok" permission_level="write" 
  message="The coordinate was added"/>

Example JSON Response

{
  "status": "ok", 
  "message":"The coordinate was added",
  "permission_level":"write",
  "cached":"0",
  "photo":{},
  "p": "1",
  "size": "1",
  "site": { ... },
  "endpoint": "/api/photo/coordinate/add"
}