flickcurl_free_place ()

void
flickcurl_free_place (flickcurl_place *place);

Destructor for place object

flickcurl_free_places ()

void
flickcurl_free_places (flickcurl_place **places_object);

Destructor for array of place object

flickcurl_place_type_to_id ()

int
flickcurl_place_type_to_id (flickcurl_place_type place_type);

Turn a place type into a place ID

flickcurl_free_place_type_infos ()

void
flickcurl_free_place_type_infos (flickcurl_place_type_info **ptis_object);

Destructor for place type info list

flickcurl_get_place_type_by_label ()

flickcurl_place_type
flickcurl_get_place_type_by_label (const char *place_label);

Get a place type by label

flickcurl_get_place_type_label ()

const char *
flickcurl_get_place_type_label (flickcurl_place_type place_type);

Get label for a place type

flickcurl_places_find ()

flickcurl_place **
flickcurl_places_find (flickcurl *fc,
                       const char *query);

Return a list of place IDs for a query string.

The flickr.places.find method is NOT a geocoder. It will round up to the nearest place type to which place IDs apply. For example, if you pass it a street level address it will return the city that contains the address rather than the street, or building, itself.

This API announced 2008-01-18 http://tech.groups.yahoo.com/group/yws-flickr/message/3716

Implements flickr.places.find (1.1)

flickcurl_places_findByLatLon ()

flickcurl_place *
flickcurl_places_findByLatLon (flickcurl *fc,
                               double lat,
                               double lon,
                               int accuracy);

Return a place ID for a latitude, longitude and accuracy triple.

The flickr.places.findByLatLon method is not meant to be a (reverse) geocoder in the traditional sense. It is designed to allow users to find photos for "places" and will round up to the nearest place type to which corresponding place IDs apply.

This API announced 2008-01-23 http://tech.groups.yahoo.com/group/yws-flickr/message/3735

Implements flickr.places.findByLatLon (1.1)

flickcurl_places_forUser ()

flickcurl_place **
flickcurl_places_forUser (flickcurl *fc,
                          flickcurl_place_type place_type,
                          int woe_id,
                          const char *place_id,
                          int threshold);

Return a list of the top 100 unique places clustered by a given place type for a user.

deprecated : Use flickcurl_places_placesForUser()

flickcurl_places_getChildrenWithPhotosPublic ()

flickcurl_place **
flickcurl_places_getChildrenWithPhotosPublic
                               (flickcurl *fc,
                                const char *place_id,
                                const char *woe_id);

Return a list of locations with public photos that are parented by a Where on Earth (WOE) or Places ID.

Implements flickr.places.getChildrenWithPhotosPublic (1.7)

deprecated : Replaced by flickcurl_places_getChildrenWithPhotosPublic2() with integer woe_id argument.

flickcurl_places_getChildrenWithPhotosPublic2 ()

flickcurl_place **
flickcurl_places_getChildrenWithPhotosPublic2
                               (flickcurl *fc,
                                const char *place_id,
                                int woe_id);

Return a list of locations with public photos that are parented by a Where on Earth (WOE) or Places ID.

You must pass either a valid Places ID or a WOE ID.

Replaces flickcurl_places_getChildrenWithPhotosPublic() with integer woe_id arg.

flickcurl_places_getInfo ()

flickcurl_place *
flickcurl_places_getInfo (flickcurl *fc,
                          const char *place_id,
                          const char *woe_id);

Get information about a place.

While optional, you must pass either a valid Places ID or a WOE ID.

Implements flickr.places.getInfo (1.7)

Announced 2008-10-30 http://code.flickr.com/blog/2008/10/30/the-shape-of-alpha/ and in detail 2008-11-05 http://tech.groups.yahoo.com/group/yws-flickr/message/4510

deprecated : Replaced by flickcurl_places_getInfo2() with integer woe_id argument.

flickcurl_places_getInfo2 ()

flickcurl_place *
flickcurl_places_getInfo2 (flickcurl *fc,
                           const char *place_id,
                           const int woe_id);

Get information about a place.

While optional, you must pass either a valid Places ID or a WOE ID.

Replaces flickcurl_places_getInfo() with integer woe_id argument.

flickcurl_places_getInfoByUrl ()

flickcurl_place *
flickcurl_places_getInfoByUrl (flickcurl *fc,
                               const char *url);

Lookup information about a place, by its flickr.com/places URL.

Implements flickr.places.getInfoByUrl (1.7)

Announced 2008-10-30 http://code.flickr.com/blog/2008/10/30/the-shape-of-alpha/ and in detail 2008-11-05 http://tech.groups.yahoo.com/group/yws-flickr/message/4510

flickcurl_places_getPlaceTypes ()

flickcurl_place_type_info **
flickcurl_places_getPlaceTypes (flickcurl *fc);

Get a list of available place types

Implements flickr.places.getPlaceTypes (1.8)

flickcurl_places_getShapeHistory ()

flickcurl_shapedata **
flickcurl_places_getShapeHistory (flickcurl *fc,
                                  const char *place_id,
                                  int woe_id);

Return an historical list of all the shape data generated for a Places or Where on Earth (WOE) ID.

While optional, you must pass either a valid Places ID or a WOE ID.

Implements flickr.places.getShapeHistory (1.8)

Announced 2009-01-12 in http://tech.groups.yahoo.com/group/yws-flickr/message/4669

Addition of donut holes announced 2009-05-06 http://code.flickr.com/blog/2009/05/06/the-absence-and-the-anchor/

flickcurl_places_getTopPlacesList ()

flickcurl_place **
flickcurl_places_getTopPlacesList (flickcurl *fc,
                                   flickcurl_place_type place_type,
                                   const char *date,
                                   int woe_id,
                                   const char *place_id);

Return the top 100 most geotagged places for a day.

Implements flickr.places.getTopPlacesList (1.12)

flickcurl_place_id_to_type ()

flickcurl_place_type
flickcurl_place_id_to_type (int place_type_id);

Turn a place type into a place ID

flickcurl_places_placesForBoundingBox ()

flickcurl_place **
flickcurl_places_placesForBoundingBox (flickcurl *fc,
                                       flickcurl_place_type place_type,
                                       double minimum_longitude,
                                       double minimum_latitude,
                                       double maximum_longitude,
                                       double maximum_latitude);

Return all the locations of a matching place type for a bounding box.

The maximum allowable size of a bounding box (the distance between the SW and NE corners) is governed by the place type you are requesting. Allowable sizes are as follows: neighbourhood: 3km (1.8mi), locality: 7km (4.3mi), county: 50km (31mi), region: 200km (124mi), country: 500km (310mi), continent: 1500km (932mi)

Implements flickr.places.placesForBoundingBox (1.8)

flickcurl_places_placesForContacts ()

flickcurl_place **
flickcurl_places_placesForContacts (flickcurl *fc,
                                    flickcurl_place_type place_type,
                                    int woe_id,
                                    const char *place_id,
                                    int threshold,
                                    const char *contacts,
                                    int min_upload_date,
                                    int max_upload_date,
                                    int min_taken_date,
                                    int max_taken_date);

Return a list of the top 100 unique places clustered by a given placetype for a user's contacts.

One of woe_id or place_id must be given.

Implements flickr.places.placesForContacts (1.8)

flickcurl_places_placesForUser ()

flickcurl_place **
flickcurl_places_placesForUser (flickcurl *fc,
                                flickcurl_place_type place_type,
                                int woe_id,
                                const char *place_id,
                                int threshold);

Return a list of the top 100 unique places clustered by a given place type for a user.

This API added 2008-09-04 as announced in http://code.flickr.com/blog/2008/09/04/whos-on-first/

Implements flickr.places.placesForUser (1.6)

flickcurl_places_placesForTags ()

int
flickcurl_places_placesForTags (flickcurl *fc,
                                flickcurl_place_type place_type,
                                int woe_id,
                                const char *place_id,
                                const char *threshold,
                                const char *tags,
                                const char *tag_mode,
                                const char *machine_tags,
                                const char *machine_tag_mode,
                                const char *min_upload_date,
                                const char *max_upload_date,
                                const char *min_taken_date,
                                const char *max_taken_date);

Return a list of the top 100 unique places clustered by a given placetype for set of tags or machine tags.

Machine tags extra information. Aside from passing in a fully formed machine tag, there is a special syntax for searching on specific properties :

Implements flickr.places.placesForTags (1.8)

flickcurl_places_resolvePlaceId ()

flickcurl_place *
flickcurl_places_resolvePlaceId (flickcurl *fc,
                                 const char *place_id);

Find places information by Place ID

Implements flickr.places.resolvePlaceId (1.0)

flickcurl_places_resolvePlaceURL ()

flickcurl_place *
flickcurl_places_resolvePlaceURL (flickcurl *fc,
                                  const char *url);

Find Places information by Place URL

Implements flickr.places.resolvePlaceURL (1.0)

flickcurl_places_tagsForPlace ()

flickcurl_tag **
flickcurl_places_tagsForPlace (flickcurl *fc,
                               int woe_id,
                               const char *place_id,
                               int min_upload_date,
                               int max_upload_date,
                               int min_taken_date,
                               int max_taken_date);

Return a list of the top 100 unique tags for a Flickr Places or Where on Earth (WOE) ID

(While optional, you must pass either a valid Places ID or a WOE ID.)

Implements flickr.places.tagsForPlace (1.8)

flickcurl_place

typedef struct {
  char* names[FLICKCURL_PLACE_LAST+1];
  char* ids[FLICKCURL_PLACE_LAST+1];
  char* urls[FLICKCURL_PLACE_LAST+1];
  flickcurl_place_type type;
  char* woe_ids[FLICKCURL_PLACE_LAST+1];
  flickcurl_location location;
  int count;

  /* DEPRECATED shapefile fields; now are pointers into @shape */
  char* shapedata;
  size_t shapedata_length;
  char** shapefile_urls;
  int shapefile_urls_count;

  struct flickcurl_shapedata_s* shape;
  char* timezone;
} flickcurl_place;

A Place.

Index 0 in the array is the location itself. flickcurl_get_place_type_label() can give labels for the array indexes of type flickcurl_place_type.

enum flickcurl_place_type

Place type

flickcurl_place_type_info

typedef struct {
  flickcurl_place_type type;
  int id;
  char *name;
} flickcurl_place_type_info;

Place type information