Contents |
URL
https://api.geoloqi.com/1/geonote/create
Description
Create a new Geonote given a latitude, longitude and radius. Internally, this creates a new place and an associated message trigger.
Supported Request Methods
POST
Scope
geonote
Parameters
- text RequiredThe text of the geonote to send. Newlines will be removed, and the message should be shorter than 140 characters to fit in an SMS. If it is longer, a short version will be sent in SMS and the full message will be emailed.
- place_id OptionalCreate a new Geonote on an existing place
- place_name OptionalCreate a new named place along with the Geonote
- latitude OptionalThe latitude of the center of the geonote
- longitude OptionalThe longitude of the center of the geonote
- radius radius or span_longitude are requiredThe radius of the geonote in meters
- span_longitude radius or span_longitude are requiredThe span in degrees of longitude of the Geonote
- date_fromThe Geonote will be delivered only after this date
- date_toThe Geonote will not be delivered after this date
- delay_minutesSend this Geonote after the person has been at this location for this many minutes
- from_nameThe name of the person who left the Geonote
- from_emailThe email address of the person who left the Geonote. An email confirmation will be sent if the permissions allow it
Notes
- If neither place_id nor place_name are set, the Geonote will be created but no place will be added.
- If place_name is specified, a new named place will be created with the Geonote.
- If place_id is specified, the Geonote will be attached to the existing place.
- You will get an error if both place_name and place_id are specified.
Example Requests and Responses
{ "text":"Don't forget the milk!", "latitude":45.5037078163837, "longitude":-122.622699737549, "radius":467, "place_name":"Grocery Store" } HTTP/1.1 200 OK { "result":"ok", "place_id":"1rM" }
{ "text":"Don't forget the milk!", "latitude":45.5037078163837, "longitude":-122.622699737549, "span_longitude":0.0012 } HTTP/1.1 200 OK { "result":"ok", "radius":159 }
{ "text":"Don't forget the milk!", "place_id":"4Tn" } HTTP/1.1 200 OK { "result":"ok" }