Xtify Pull API

    Overview

    The Xtify API provides a simple interface for a developer to access their users' location. This API uses a REST interface and XML as the message format. The method for querying a user's location requires the content provider to include two parameters, one identifying the application and the other identifying the particular user associated with the location query.

    Location Query

    Location Query Format
    Once your application including the Xtify SDK is up and running, you can query Xtify for a user's location.  This API is meant for occassional querying or for an on-demand location use case (ie rendering a users' locations on a map).  Please use the API responsibly.

    The location query is formatted much the same as the download and user registration URL:
    http://query.xtify.com/api/1.0/xml/location?cpid=XXX&userkey=XXX

    cpid = The Application ID for the application that is making the query. userkey = The unique identifier for the user to query location for.

Print

Location Query Response

The location query response will include a UTC timestamp and location information, such as latitude, longitude, and nearest street address. The Xtify client allows every user to set a maximum level of detail for every application, so that setting determines the specificity of the reply data. A successful location query will include the following information in response:

<xml version="1.0" encoding="UTF-8" ?>

<response>

<locationset userkey="xxxx-xxxx">

<location>

<timestamp>2008-04-01 12:17:14 UTC</timestamp>

<coords lod="1" lod-name="exact">

<lat>40.744916</lat>

<lon>-73.987062</lon>

<accuracy>500.0</accuracy>

<provider>gps</provider>

</coords>

<addressDetail>

<street1>Broadway</street1>

<street2>25th</street2>

<address>45 west 25th street</address>

<city>New York</city>

<state>New York</state>

<postalcode>10011</postalcode>

<country>USA</country>

</addressDetail>

</location>

</locationset>

</response>

Print

Powered by Olark