GeoLocation

Ties objects to a specific geographic location on Earth via Google's geocode system. Geo Locations are accessed via /api/geolocation.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in GeoLocationProperties.

Relationships

See "Relationships" in Introduction for how to use them.

conventions

The list of Conventions using this location.

groups

The list of Groups using this location.

libraries

The list of Librarys using this location.

Services

The services used to fetch and manipulate geo locations.

Search Geo Locations

This will search across all conventions. To search on a single convention see "Relationships" in Convention.

 GET /api/geolocation
Optional Params
query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "Madison, WI",
          ...
        },
        ...
    ]
 }

Create Geo Location

 POST /api/geolocation
Required Params
name

Will use the name of the city, state or city, country provided to look up the location in Google.

Optional Params
formatted_address

If provided, we'll use the address to look up the location rather than the name.

Returns the same as a normal read.

Read Geo Location

 GET /api/geolocation/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "Madison, WI",
   ...
 }

Update Geo Location

 PUT /api/geolocation/xxx

Returns the same as a normal read.

Delete Geo Location

 DELETE /api/geolocation/xxx

Returns:

 {
   "success" : 1
 }