This document refers to a feature that was removed after Graph API v1.0.
Graph API Version

Graph API Reference /{user-id}/locations

A feed of posts and photos that include location information and in which this person has been tagged. This is useful for constructing a chronology of places that the person has visited.

Reading

Graph API Explorer
GET /v2.9/me/locations HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/me/locations'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/me/locations",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/locations",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/locations"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • A user access token with user_photos and user_status permissions is required to request this feed for that person.
  • A user access token with friend_photos and friend_status permissions is required to request this feed for any friends of that person.
  • You can use only either user_photos or user_status permissions, but the feed will only contain posts of that type.

Fields

An array of Post and Photo objects with one additional field:

NameDescriptionType

type

Indicates the type of each object in the feed.

enum{checkin, photo, status}

Publishing

Use the /{user-id}/feed edge to create new posts, or the /{user-id}/photos edge to create new photos.

Deleting

You can't delete using this edge, however you can delete posts using the /{post-id} node or photos using the /{photo-id} node.

Updating

You can't update using this edge.