Esri's Geotrigger Service is replacing Geoloqi! Learn More | FAQ

geonote/create

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 Required
    The 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 Optional
    Create a new Geonote on an existing place
  • place_name Optional
    Create a new named place along with the Geonote
  • latitude Optional
    The latitude of the center of the geonote
  • longitude Optional
    The longitude of the center of the geonote
  • radius radius or span_longitude are required
    The radius of the geonote in meters
  • span_longitude radius or span_longitude are required
    The span in degrees of longitude of the Geonote
  • date_from
    The Geonote will be delivered only after this date
  • date_to
    The Geonote will not be delivered after this date
  • delay_minutes
    Send this Geonote after the person has been at this location for this many minutes
  • from_name
    The name of the person who left the Geonote
  • from_email
    The 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"
}