FANDOM


The Sighting object holds all the details of a Sighting. Note that the original_sighting attribute is never populated on Sighting objects returned by list methods.

AttributesEdit

Name Type Mandatory Description

sighting_id

Long Yes

The id of the Sighting.

This id is not unique, but is unique per user, hence the unique id for a Sighting is the user who created the Sighting (for example their user Id) and this id.

description String(200) Yes

The description of the Sighting.

date DateTime Yes

The date/time that the Sighting was created.

tz_offset

Integer Yes

The number of minutes that the user’s timezone was offset from UTC when they created the Sighting.

Valid values are from -720 (UTC-12:00) to 840 (UTC+14:00).

publish_date DateTime Yes

This is used to order lists and allows held items to appear at the top of lists when they are released.

It is the Sighting date/time unless the Sighting was originally on-hold, in which case it is the Sighting date/time until the Sighting is released, at which point it is updated to the system date/time.

location Location Yes

The latitude and longitude of the Sighting.

altitude Altitude No

The altitude of the Sighting if known.

heading Float No

The heading of the user when the Sighting was made if known.

speed Float No

The speed of the user when the Sighting was made if known.

hold Boolean Yes

Whether the Sighting is on hold.

user User Yes

Details of the user who made the Sighting.

address Address Yes

The reverse-geocoded address of the Sighting. This is populated automatically by Resighting but it can take some time (potentially hours but usually more quickly). Check the sub-attribute status to see whether the reverse-geocoding has happened.

evidence Evidence No

Details of the evidence image for this Sighting, if there is one.

update_date DateTime Yes

The date/time the Sighting was last updated.

original_sighting SightingRef No

If the Sighting is a resighting then the key of the original Sighting is given here. Note that this attribute is NEVER populated on Sighting objects returned by list methods.

publish_to_facebook Boolean No Whether the Sighting will be or was published to Facebook. This attribute is only returned if the owner of the Sighting and the owner of the access token are the same user.
tweet_sighting Boolean No Whether the Sighting will be or was tweeted. This attribute is only returned if the owner of the Sighting and the owner of the access token are the same user.

ExampleEdit

{
    "update_date": "2012-03-15T09:17:45.034183Z",
    "description": "Mus\u00e9e Gustave Moreau",
    "speed": 0.0,
    "heading": 6.40000009537,
    "altitude": {
        "altitude": -47.66351318359375,
        "altitude_accuracy": 70.281001375799718
    },
    "original_sighting": {
        "sighting_id": 118001,
        "user_id": "0be20e2cdf934f71b03512c5a8629fa9"
    },
    "tz_offset": 60,
    "evidence": {
        "evidence_width": 448,
        "evidence_height": 600,
        "evidence_exif_tags": {
            "YResolution": "72",
            "ResolutionUnit": "2",
            "Make": "Apple",
            "Flash": "0",
            "DateTime": "2012:01:29 21:42:52",
            "MeteringMode": "5",
            "XResolution": "72",
            "MimeType": "0",
            "ColorProfile": "True",
            "ExposureProgram": "2",
            "ShutterSpeedValue": "3.9112",
            "ColorSpace": "1",
            "DateTimeDigitized": "2012:01:29 15:40:17",
            "ApertureValue": "2.9708536",
            "ImageWidth": "1935",
            "SensingMethod": "2",
            "FNumber": "2.8",
            "DateTimeOriginal": "1327851617",
            "FocalLength": "3.8499999",
            "ISOSpeedRatings": "500",
            "Model": "iPhone 4",
            "Software": "QuickTime 7.6.6",
            "ExposureTime": "0.06666667",
            "ImageLength": "2592",
            "Orientation": "1",
            "HostComputer": "Mac OS X 10.6.8",
            "DateCreated": "2012:01:29 15:40:17",
            "YCbCrPositioning": "1"
        },
        "evidence_serving_url": "http://lh4.ggpht.com/MOs4c4UFgupWK2zDDVeWWLjgQ7jlpiRzNq63a-ZrrtBZJ8OfnBboEmxBUz_Je9x8DtBSyrBOicWEM6RRqeY"
    },
    "publish_date": "2012-01-29T14:53:21.836801Z",
    "location": {
        "latitude": 48.877905599999998,
        "longitude": 2.3342728500000001,
        "accuracy": 47.421633549763428
    },
    "address": {
        "status": "ok",
        "country": "France",
        "locality": "Paris",
        "street_address": "164 rue de Rivoli, 75001 Paris, France",
        "place": "The Louvre"
    },
    "date": "2012-01-29T14:53:21.836644Z",
    "hold": false,
    "sighting_id": 439005,
    "user": {
        "update_date": "2012-03-07T11:23:56.888240Z",
        "user_id": "bf10ad015e7b4ceea9279c1b9e8889a5",
        "name": "Matt",
        "joined_date": "2010-03-19T15:53:04.337350Z",
        "avatar": {
            "avatar_height": 450,
            "avatar_width": 600,
            "avatar_serving_url": "http://lh6.ggpht.com/jEItPe0EtKFcIIeeqq_Pp8AaLHdZzp9ACT2MPurxf5I6Eln3pjpOnaAm4rR0WAEEStk9HUUIygezuYVboFxF"
        },
        "username": "matt"
    },
    "publish_to_facebook": false,
    "tweet_sighting": false
}

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.