Core Geolocation Support
Location
cffdffff
Must be of type 'location'.
Location specification type
The location_info
parameter must contain a comma separated list of IANA codes
or synonyms describing the civicAddress of this location.
The IANA codes and synonyms can be obtained by executing
the CLI command geoloc show civicAddr_mapping.
The
location_info parameter must contain a comma
separated list valid GML elements describing this location.
The
location_info parameter must contain a single
URI parameter which contains an external URI describing this location.
Location information
The contents of this parameter are specific to the
location format.
location_info = country=US,A1="New York",city_district=Manhattan,
A3="New York", house_number=1633, street=46th, street_suffix = Street,
postal_code=10222,floor=20,room=20A2
location_info = Shape=Sphere, pos3d="39.12345 -105.98766 1920", radius=200
location_info = URI=https:/something.com?exten=${EXTEN}
Fully qualified host name
This parameter isn't required but if provided, RFC8787 says it MUST be a fully
qualified host name. IP addresses are specifically NOT allowed. The value will be placed
in a loc-src parameter appended to the URI in the
Geolocation header.
Location determination method
This is a rarely used field in the specification that would
indicate the method used to determine the location. Its usage and values should be
pre-negotiated with any recipients.
Profile
cffdffff
Must be of type 'profile'.
PIDF-LO element to place this profile in
Based on RFC5491 (see below) the recommended and default element
is device.
[https://www.rfc-editor.org/rfc/rfc5491.html#section-3.4]
Reference to a location object
Reference to a location object
Reference to a location object
location specification type
xxxx
Notes to be added to the outgoing PIDF-LO document
The specification of this parameter will cause a
<note-well> element to be added to the
outgoing PIDF-LO document. Its usage should be pre-negotiated with
any recipients.
Determine which profile on a channel should be used
Use the incoming profile if it exists and has location information, otherwise use the
configured profile if it exists and has location information. If neither profile has location
information, nothing is sent.
Use the configured profile if it exists and has location information, otherwise use the
incoming profile if it exists and has location information. If neither profile has location
information, nothing is sent.
Discard any incoming profile and use the configured profile if it exists and
it has location information. If the configured profile doesn't exist or has no
location information, nothing is sent.
Discard any configured profile and use the incoming profile if it exists and
it has location information. If the incoming profile doesn't exist or has no
location information, nothing is sent.
Get or Set a field in a geolocation profile
The profile field to operate on.
The index of the profile to operate on. Not required for the special fields.
Create a new, empty Geolocation Profile on a channel
The id of the new profile.
The position at which to insert the new eprofile.
Existing profiles will be moved forward to make room.
Leave empty to append to the end of the list.
This application adds a new, empty Geolocation Profile to a channel.
The following variable is set:
The number of profiles on the channel after the new one is created
Delete a Geolocation Profile from a channel
The position of the profile to be deleted
Existing profiles will be moved back.
This application deletes a Geolocation Profile from a channel.
The following variable is set:
The number of profiles left on the channel after the delete.