Get started with your own Fire Eagle application in three easy steps:
|
Get your API key
You need a Fire Eagle API key and secret for each of the applications you're developing. To apply for an API key, you need to give Fire Eagle some basic information about your application. Don't worry if you don't have all the information yet, you can always edit these details later. However, your choice of authentication type (web, mobile or desktop) will determine which API methods your application has access to and how your users authorize your application.
|
|
Authenticate relationship between you and the user
In order for your application to access a user's location information in Fire Eagle, the user has to first authorize your application with Fire Eagle. Application authorizations are handled according to the OAuth specification. Your application directs the user to a page on the Fire Eagle site, where they can then decide how much information Fire Eagle can receive from—or provide to—your application. Fire Eagle then directs the authorized user back to your application.
|
|
Make API calls to Fire Eagle
Once the user has given your application permission, you can now call the awesome Fire Eagle APIs. Your application can access or update location on a user's behalf until he changes his mind. Users can change or revoke their permissions for your application at any time at the Fire Eagle site.
Updates to the user's location can be performed by sending Fire Eagle location parameters such as street addresses or locations in the form of text strings, Place IDs (as used on Flickr or Upcoming), long/lat coordinates, bounding boxes etc. The central Fire Eagle service then translates these inputs into a consistent location hierarchy. This heirarchy contains information about the user's location at various levels of granularity. The last-known location for the user at the level of granularity the user has given permission for Fire Eagle to share with your application is returned when you query for the user's location.
|