Fandom

Resighting Wiki

LocatorSighting Object

71pages on
this wiki
Add New Page
Comments0 Share

The LocatorSighting object represents a Sighting submitted to a Locator, i.e. it is the relationship between a Sighting object and a Locator object.

Though a Sighting and a Locator are mandatory for the relationship, the sighting and locator attributes are in fact optional. This is because, for example, when listing Locators that a Sighting has been submitted-to using the ListSightingLocators method, we don't return the sighting attribute as we would be returning the same Sighting object for each submission, which would be a waste of bandwidth. So to put it another way, the sighting and locator attributes are omitted (on a method-by-method basis) if they can be implied.

AttributesEdit

Name Type Mandatory Description
locator Locator No

The Locator that this Sighting has been submitted to.

This attribute is populated or not depending upon which API method is being used. It is populated for the following API methods: CreateLocatorSightingListSightingLocators and RemoveLocatorSighting.

publish_date DateTime Yes

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

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

sighting Sighting No

The Sighting that is submitted to the Locator.

This attribute is populated or not depending upon which API method is being used. It is populated for the following API methods: CreateLocatorSightingListLocatorSightings and RemoveLocatorSighting.

submitted_date DateTime Yes

The date/time the Sighting was submitted to the Locator.

submitter User Yes

The user who submitted the Sighting to the Locator.

update_date DateTime Yes

The date/time the submission record was last updated.

ExampleEdit

{
    "submitted_date": "2012-03-25T21:53:15.731441Z",
    "submitter": {
        "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_date": "2012-03-25T21:53:15.731580Z",
    "update_date": "2012-03-25T21:53:15.732293Z",
    "locator": {
        "update_date": "2012-03-25T21:52:07.622710Z",
        "create_date": "2012-03-25T21:52:07.622376Z",
        "description": "Things to do in La Rochelle, Poitou-Charentes, France.",
        "locator_id": 129001,
        "closed": false,
        "name": "La Rochelle"
    },
    "sighting": {
        "update_date": "2012-03-17T10:45:14.862818Z",
        "description": "La Rochelle from the Saint-Nicolas tower",
        "speed": 0.0,
        "altitude": {
            "altitude": 34.270229,
            "altitude_accuracy": 70.281001000000003
        },
        "tz_offset": 60,
        "evidence": {
            "evidence_width": 600,
            "evidence_height": 450,
            "evidence_exif_tags": {
                "MimeType": "0",
                "ImageLength": "1536",
                "Orientation": "1",
                "ColorSpace": "1",
                "ImageWidth": "2048",
                "ColorProfile": "False"
            },
            "evidence_serving_url": "http://lh3.ggpht.com/k_h8-Xtz3uNtA0zpSonhTbmoMCEyj_gn6iGg1LlnTytNvpJOVCeO_s3XJXn9L-77FEnYgICBSI_HZTeNsw"
        },
        "publish_date": "2012-03-17T10:45:14.306122Z",
        "location": {
            "latitude": 46.155838000000003,
            "longitude": -1.153405,
            "accuracy": 47.421633999999997
        },
        "address": {
            "status": "ok",
            "country": "France",
            "locality": "La Rochelle",
            "street_address": "20 Quai Duperré, 17000 La Rochelle, France",
            "place": "Le Vieux Port"
        },
        "date": "2012-03-17T10:45:14.306030Z",
        "hold": false,
        "sighting_id": 474001,
        "heading": 353.65411399999999,
        "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.