<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
<base href="https://wiki.asterisk.org/wiki" />
<title>Message Title</title>
<style type="text/css">@media only screen and (max-device-width: 480px) {.mobile-only {
width: auto !important;
height: auto !important;
overflow: visible !important;
line-height: normal !important;
font-size: inherit !important;
mso-hide: all;
}
.desktop-only {
display: none !important;
}
/* iPhone 3GS fix for unwanted 20px right margin */
body { min-width: 100% !important; padding: 0; margin: 0; }
#center-content-table { max-width: none; !important; }
#header-pattern-container { padding: 10px 10px 10px 10px !important; line-height: 20px !important; }
#header-avatar-image-container { padding-right: 8px !important; }
#email-content-container { padding: 0 !important; }
.mobile-expand { border-radius: 0 !important; border-left: 0 !important; border-right: 0 !important; padding-left: 26px !important;}
.mobile-resize-text { font-size: 16px !important; line-height: 22px !important; }
#page-title-pattern-header { font-size: 20px !important; line-height: 28px !important; }
#page-title-pattern-icon-image-container-cell { padding-top: 7px !important; }
#inline-user-pattern { display: block !important; }
#inline-user-pattern-avatar { padding-top: 3px !important; }
.contextual-area-pattern { border-bottom: 1px solid #ccc !important; padding: 15px 10px 0 10px !important;}
.users-involved-pattern-column-table { width: 100% !important; }
.users-involved-pattern-avatar-table-cell { padding: 3px 5px 5px 0 !important; }
.users-involved-pattern-column-container { padding-right: 0 !important; }
.contextual-excerpt-pattern, #users-involved-pattern { border: 0 !important; }
/** Aui Typography upsized for mobile **/
#content-excerpt-pattern-container, #contextual-excerpt-pattern-text-container { font-size: 16px !important; line-height: 22px !important; }
#content-excerpt-pattern-container h1, #contextual-excerpt-pattern-text-container h1 { font-size: 24px !important; line-height: 28px !important; }
#content-excerpt-pattern-container h2, #contextual-excerpt-pattern-text-container h2 { font-size: 20px !important; line-height: 28px !important; }
#content-excerpt-pattern-container h3, #contextual-excerpt-pattern-text-container h3 { font-size: 18px !important; line-height: 24px !important; }
#content-excerpt-pattern-container h4, #contextual-excerpt-pattern-text-container h4 { font-size: 16px !important; line-height: 22px !important; }
#content-excerpt-pattern-container h5, #contextual-excerpt-pattern-text-container h5 { font-size: 14px !important; line-height: 20px !important; }
#content-excerpt-pattern-container h6, #contextual-excerpt-pattern-text-container h6 { font-size: 14px !important; line-height: 20px !important; }
.user-mention { line-height: 18px !important; }
/** Aui Typography end **/
/* Show appropriate footer logo on mobile, display links vertically */
#footer-pattern { padding: 15px 10px !important; }
#footer-pattern-logo-desktop-container { padding: 0 !important; }
#footer-pattern-logo-desktop { width: 0 !important; height: 0 !important; }
#footer-pattern-logo-mobile {
padding-top: 10px !important;
width: 30px !important;
height: 27px !important;
display: inline !important;
}
#footer-pattern-text {
display: block !important;
}
#footer-pattern-links-container { line-height: 0 !important;}
.footer-pattern-links.mobile-resize-text,
.footer-pattern-links.mobile-resize-text,
#footer-pattern-text.mobile-resize-text,
#footer-pattern-links-container.no-footer-links {
font-size: 14px !important;
line-height: 20px !important;
}
.footer-link { display: block !important; }
#footer-pattern-links-container table { display: inline-block !important; float: none !important; }
#footer-pattern-links-container, #footer-pattern-text { text-align: center !important; }
#footer-pattern-links { padding-bottom: 5px !important; }
/** Team Calendar overrides, these should be removed when notifications are updated in Team Calendars. For now CSS
overrides are being used because the structure of the content can't change without rereleasing the plugin */
.mail-calendar-container .day-header + table tr td:first-child {
vertical-align: top !important;
padding-top: 5px !important;
}}
@media (min-width: 900px) {#center-content-table { width: 900px; }}
@media all {#outlook a {padding:0;} /* Force Outlook to provide a "view in browser" menu link. */
/* Prevent Webkit and Windows Mobile platforms from changing default font sizes.*/
body{-webkit-text-size-adjust:100%; -ms-text-size-adjust:100%;}
.ExternalClass {width:100%;} /* Force Hotmail to display emails at full width */
#background-table {margin:0; padding:0; width:100% !important; }
/* Needed to override highlighting on date and time links in iOS */
.grey a {color: #707070; text-decoration: none; }/* These styles are appended to the head element of a notification in order to prevent Apple Mail and similar
clients from underlining the due dates with a blue hyperlink */
/* a lozenge outside an inline task should always be #333, lozenges inside an inline task should be
colored according to their upcoming due dates, a completed task date lozenge or deleted task date
lozenge should always be #707070 */
.date-time-lozenge a {color: #333333; text-decoration: none; }
.inline-task-text-container .date-time-lozenge.date-upcoming a {color: #DF6F00; text-decoration: none; }
.inline-task-text-container .date-time-lozenge.date-past a {color: #D04437; text-decoration: none; }
.inline-task-text-container.content-deleted-color .date-time-lozenge a,
.inline-task-text-container.checked .date-time-lozenge a {
color: #707070; text-decoration: none;
}}
</style>
</head>
<body>
<table id="background-table" cellpadding="0" cellspacing="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; background-color: #f5f5f5">
<tbody>
<tr>
<td id="header-pattern-container" style="padding: 0px; border-collapse: collapse; padding: 10px 20px">
<table id="header-pattern" cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td id="header-avatar-image-container" valign="top" style="padding: 0px; border-collapse: collapse; vertical-align: top; width: 32px; padding-right: 9px"><a href="https://wiki.asterisk.org/wiki/display/~gjoseph?src=email" style="color: #3b73af; text-decoration: none"><img id="header-avatar-image" class="image_fix" src="cid:avatar_56b2a47747d2721d6dcf26979b4b605a" height="32" width="32" border="0" style="border-radius: 3px; vertical-align: top" /></a></td>
<td id="header-text-container" valign="middle" style="padding: 0px; border-collapse: collapse; vertical-align: middle; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px">George Joseph <strong>edited</strong> a page</td>
</tr>
</tbody>
</table> </td>
</tr>
<!-- End Header pattern -->
<tr>
<td id="email-content-container" style="padding: 0px; border-collapse: collapse; padding: 0 20px">
<table id="email-content-table" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; border-spacing: 0; border-collapse: separate">
<tbody>
<tr>
<td class="email-content-rounded-top mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; padding: 0 15px 0 16px; height: 15px; background-color: #fff; border-left: 1px solid #ccc; border-top: 1px solid #ccc; border-right: 1px solid #ccc; border-bottom: 0; border-top-right-radius: 5px; border-top-left-radius: 5px"> </td>
</tr>
<tr>
<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff">
<table id="page-title-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td id="page-title-pattern-icon-image-container" valign="top" style="padding: 0px; border-collapse: collapse; width: 16px; vertical-align: top">
<table cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td id="page-title-pattern-icon-image-container-cell" style="padding: 0px; border-collapse: collapse; width: 16px; padding: 9px 8px 0px 0px; mso-text-raise: 5px; mso-line-height-rule: exactly"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?src=email" title="page icon" style="vertical-align: top;; color: #3b73af; text-decoration: none"><img style="vertical-align: top; display: block;" src="cid:page-icon" alt="page icon" title="page icon" height="16" width="16" border="0" /></a></td>
</tr>
</tbody>
</table> </td>
<td style="vertical-align: top;; padding: 0px; border-collapse: collapse; padding-right: 5px; font-size: 20px; line-height: 30px; mso-line-height-rule: exactly" id="page-title-pattern-header-container"><span id="page-title-pattern-header" style="font-family: Arial, sans-serif; padding: 0; font-size: 20px; line-height: 30px; mso-text-raise: 2px; mso-line-height-rule: exactly; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?src=email" title="Asterisk Geolocation Implementation" style="color: #3b73af; text-decoration: none">Asterisk Geolocation Implementation</a></span></td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff">
<table class="content-excerpt-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px">
<tbody>
<tr>
<td class="content-excerpt-pattern-container mobile-resize-text " style="padding: 0px; border-collapse: collapse; padding: 0 0 0 24px"> <h4 id="AsteriskGeolocationImplementation-Parameters.1" style="margin: 10px 0 0 0; margin-top: 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0; margin-top: 0"> <span class="diff-html-added" id="added-diff-26" style="font-size: 100%; background-color: #ddfade;">Parameters</span> </h4>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">type</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: Object type. Must be "profile"</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Required: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">type=profile</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_reference</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-38" style="background-color: #d6f0ff;">Specifies the id of a Location object to use.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-27" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-40" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-28" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: </span><span class="diff-html-changed" id="changed-diff-41" style="background-color: #d6f0ff;">no</span> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-29" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_reference=mylocation</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">pidf_element</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-42" style="background-color: #d6f0ff;">For Civic Address and GML location formats, this parameter specifies the PIDF element that will carry the location description on outgoing SIP requests. Must be one of "tuple", "device" or "person".</span> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-26" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The default is "device".</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: device</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">pidf_element = tuple</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-43" style="background-color: #d6f0ff;">allow_routing_use</span></strong> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-31" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-44" style="background-color: #d6f0ff;">This value controls the value of the </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">Geolocation-Routing</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;"> header sent on SIP requests, Must be "yes" or "no". </span> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-28" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The default is "no".</span> <br />
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-45" style="background-color: #d6f0ff;">See </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" style="background-color: #d6f0ff;">RFC6442</span></a><span class="diff-html-changed" style="background-color: #d6f0ff;"> for more information.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-32" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-47" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-33" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: </span><span class="diff-html-changed" id="changed-diff-48" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-34" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: </span><span class="diff-html-changed" id="changed-diff-49" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-35" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">allow_routing_use = yes</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">profile_precedence</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-50" style="background-color: #d6f0ff;">Specifies which of the available profiles (configured or incoming) takes precedence. </span> </li>
</ul> <br class="atl-forced-newline" />
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-51" style="background-color: #d6f0ff;">NOTE: On an incoming call leg/channel, the "incoming" profile is the one received by the channel driver from the calling party in the SIP INVITE and the "configured" profile is the one attached to the calling party's pjsip endpoint. On an outgoing call segment/channel, the "incoming" profile is the one received by the channel driver from the Asterisk core/dialplan and the "configured" profile one is the one attached to the called party's pjsip endpoint.</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-36" style="font-size: 100%; background-color: #ddfade;">Valid values:</span>
<ul style="margin: 10px 0 0 0">
<li> <code style="font-family: monospace"><span class="diff-html-changed" id="changed-diff-53" style="background-color: #d6f0ff;">prefer_incoming</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;">: Use the incoming profile if it exists and has location information, otherwise use the configured profile if it has location information. If neither profile has location information, nothing is </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-31" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">sent</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-37" style="font-size: 100%; background-color: #ddfade;">passed on</span><span class="diff-html-changed" id="changed-diff-54" style="background-color: #d6f0ff;">.</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-32" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">force</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-38" style="font-size: 100%; background-color: #ddfade;">prefer</span><span class="diff-html-changed" id="changed-diff-55" style="background-color: #d6f0ff;">_</span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-33" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">incoming</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-39" style="font-size: 100%; background-color: #ddfade;">config</span></code><span class="diff-html-changed" id="changed-diff-56" style="background-color: #d6f0ff;">: </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-34" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Discard any </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-40" style="font-size: 100%; background-color: #ddfade;">Use the </span><span class="diff-html-changed" id="changed-diff-57" style="background-color: #d6f0ff;">configured profile </span><span class="diff-html-added" id="added-diff-41" style="font-size: 100%; background-color: #ddfade;">if it exists </span><span class="diff-html-changed" id="changed-diff-58" style="background-color: #d6f0ff;">and </span><span class="diff-html-added" id="added-diff-42" style="font-size: 100%; background-color: #ddfade;">has location information, otherwise </span><span class="diff-html-changed" id="changed-diff-59" style="background-color: #d6f0ff;">use the incoming profile if it </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-35" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">exists and it </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-60" style="background-color: #d6f0ff;">has location information. If </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-36" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">the incoming profile doesn't exist or has no </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-43" style="font-size: 100%; background-color: #ddfade;">neither profile has </span><span class="diff-html-changed" id="changed-diff-61" style="background-color: #d6f0ff;">location information, nothing is </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-37" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">sent</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-44" style="font-size: 100%; background-color: #ddfade;">passed on</span><span class="diff-html-changed" id="changed-diff-62" style="background-color: #d6f0ff;">.</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-38" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">prefer</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-45" style="font-size: 100%; background-color: #ddfade;">discard</span><span class="diff-html-changed" id="changed-diff-63" style="background-color: #d6f0ff;">_</span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-39" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">config</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-46" style="font-size: 100%; background-color: #ddfade;">incoming</span></code><span class="diff-html-changed" id="changed-diff-64" style="background-color: #d6f0ff;">: </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-40" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Use </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-47" style="font-size: 100%; background-color: #ddfade;">Discard </span><span class="diff-html-changed" id="changed-diff-65" style="background-color: #d6f0ff;">the </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-41" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">configured </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-48" style="font-size: 100%; background-color: #ddfade;">incoming </span><span class="diff-html-changed" id="changed-diff-66" style="background-color: #d6f0ff;">profile </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-42" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">if it exists </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-67" style="background-color: #d6f0ff;">and </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-43" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">has location information, otherwise </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-68" style="background-color: #d6f0ff;">use the </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-44" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">incoming </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-49" style="font-size: 100%; background-color: #ddfade;">configured </span><span class="diff-html-changed" id="changed-diff-69" style="background-color: #d6f0ff;">profile if it </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-45" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">exists and </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-70" style="background-color: #d6f0ff;">has location information. If </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-46" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">neither profile has location information</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-50" style="font-size: 100%; background-color: #ddfade;">it doesn't</span><span class="diff-html-changed" id="changed-diff-71" style="background-color: #d6f0ff;">, nothing is </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-47" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">sent</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-51" style="font-size: 100%; background-color: #ddfade;">passed on</span><span class="diff-html-changed" id="changed-diff-72" style="background-color: #d6f0ff;">.</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-48" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">force</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-52" style="font-size: 100%; background-color: #ddfade;">discard</span><span class="diff-html-changed" id="changed-diff-73" style="background-color: #d6f0ff;">_config</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;">: Discard </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-49" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">any incoming </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-53" style="font-size: 100%; background-color: #ddfade;">the configured </span><span class="diff-html-changed" id="changed-diff-74" style="background-color: #d6f0ff;">profile and use the </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-50" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">configured </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-54" style="font-size: 100%; background-color: #ddfade;">incoming </span><span class="diff-html-changed" id="changed-diff-75" style="background-color: #d6f0ff;">profile if it </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-51" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">exists and it </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-76" style="background-color: #d6f0ff;">has location information. If </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-52" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">the configured profile </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-55" style="font-size: 100%; background-color: #ddfade;">it </span><span class="diff-html-changed" id="changed-diff-77" style="background-color: #d6f0ff;">doesn't</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-53" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">exist or has no location information</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-changed" id="changed-diff-78" style="background-color: #d6f0ff;">, nothing is </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-54" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">sent</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-56" style="font-size: 100%; background-color: #ddfade;">passed on</span><span class="diff-html-changed" id="changed-diff-79" style="background-color: #d6f0ff;">.</span> </li>
</ul> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-57" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: discard_incoming</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">profile_precedence = prefer_incoming</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">usage_rules</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-80" style="background-color: #d6f0ff;">For Civic Address and GML location formats, this parameter specifies the contents of the </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">usage-rules</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;"> PIDF-LO element. </span><span class="diff-html-added" id="added-diff-58" style="font-size: 100%; background-color: #ddfade;">See </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">RFC4119</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> for the exact definition of this parameter.</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-59" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: yes</span>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-82" style="background-color: #d6f0ff;">retransmission-allowed</span></strong><span class="diff-html-changed" id="changed-diff-83" style="background-color: #d6f0ff;">: Must be "yes" or "no".</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-56" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The default is "no".</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li></li>
<li> <strong><span class="diff-html-changed" id="changed-diff-85" style="background-color: #d6f0ff;">retention-expires</span></strong><span class="diff-html-changed" id="changed-diff-86" style="background-color: #d6f0ff;">: An ISO-format timestamp after which the recipient MUST discard and location information associated with this request. The default is 24 hours after the request was sent. You can use dialplan functions to create a timestamp yourself if needed.</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-57" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">For example, to set the timestamp to 1 hour after the request is sent, use:</span> <br />
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li></li>
</ul> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: retransmission-allowed=no, retention-expires=<current time + 24 hours></span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">usage_rules = retransmission-allowed=yes,</span><span class="diff-html-changed" id="changed-diff-87" style="background-color: #d6f0ff;">retention-expires="${STRFTIME($</span><a href="/wiki/display/AST/Asterisk+Geolocation+Implementation" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" style="background-color: #d6f0ff;">Asterisk Geolocation Implementation</span></a><span class="diff-html-changed" style="background-color: #d6f0ff;">,UTC,%FT%TZ)}"</span></code> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-58" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">See </span> <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">RFC4119</span></a> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> for the exact definition of this parameter.</span>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-89" style="background-color: #d6f0ff;">location_info_refinement</span></strong> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-61" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-90" style="background-color: #d6f0ff;">This parameter can be used to refine referenced location by adding these sub-parameters to the </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">location_info</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;"> parameter of the referenced location object. For example, you could have Civic Address referenced object describe a building, then have this profile refine it by adding floor, room, etc. Another profile could then also reference the same location object and refine it by adding a different floor, room, etc.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-62" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-92" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-63" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: </span><span class="diff-html-changed" id="changed-diff-93" style="background-color: #d6f0ff;">yes</span> </li>
<li> <span class="diff-html-added" id="added-diff-64" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: </span><span class="diff-html-changed" id="changed-diff-94" style="background-color: #d6f0ff;">yes </span><span class="diff-html-added" id="added-diff-65" style="font-size: 100%; background-color: #ddfade;">(any that can appear in a location's location_info parameter)</span> </li>
<li> <span class="diff-html-added" id="added-diff-66" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> Add a room to the civicAddress specified by location_reference.</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_reference = myCivicAddress = ROOM=23A4</span></code> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_info_refinement = ROOM=23A4</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_variables</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-96" style="background-color: #d6f0ff;">Any parameter than can use channel variables can also use the arbitrary variables defined in this parameter. For example </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">location_variables = MYVAR1=something, MYVAR2="something else"</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;"> would allow you to use </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">${MYVAR1</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;">} and </span><code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;">${MYVAR2</span></code><span class="diff-html-changed" style="background-color: #d6f0ff;">} in any other parameter that can accept channel variables</span><span class="diff-html-added" id="added-diff-67" style="font-size: 100%; background-color: #ddfade;">.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-68" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-98" style="background-color: #d6f0ff;">no</span> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-69" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: yes (one or more name=value pairs)</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_variables = MYVAR1=something, MYVAR2="something else"</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">notes</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-99" style="background-color: #d6f0ff;">The specifications allow a free-form "note-well" element to be added to the location description. Any text entered here will be present on all outgoing Civic Address and GML requests.</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-70" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">notes = "anything you want"</span></code> </li>
</ul> </li>
</ul> <h4 id="AsteriskGeolocationImplementation-AdditionalParameters" style="margin: 10px 0 0 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Additional Parameters</span> </h4> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">In addition to the profile-specific parameters defined above, any location-object parameters can be specified as well. This is a convenient shortcut if you have a 1<>1 relationship between profile and location.</span> </p> <h4 id="AsteriskGeolocationImplementation-Built-inProfiles" style="margin: 10px 0 0 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Built-in Profiles</span> </h4> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">In addition to the profiles you define in geolocation.conf, 4 built-in profiles are also available They're named after their profile_precedence setting:</span> </p>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><prefer_incoming></span></strong> </li>
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><prefer_config></span></strong> </li>
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><discard_incoming></span></strong> </li>
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><discard_config></span></strong> </li>
</ul> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">The rest of the profile parameters are set to their defaults.</span> </p> <h1 id="AsteriskGeolocationImplementation-chan_pjsipConfiguration" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">chan_pjsip Configuration</h1> <p style="margin: 10px 0 0 0">Two new parameters have been added to pjsip endpoints:</p> <span class="diff-html-removed" id="removed-diff-63" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Parameter</span> <h2 id="AsteriskGeolocationImplementation-Parameters.2" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-added" id="added-diff-71" style="font-size: 100%; background-color: #ddfade;">Parameters</span> </h2>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-102" style="background-color: #d6f0ff;">geoloc_incoming_call_profile</span></strong> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-72" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-103" style="background-color: #d6f0ff;">Should be set to the name of a geolocation profile to use for calls coming into Asterisk from this remote endpoint. If not set, no geolocation processing will occur and any location descriptions present on the incoming request will be silently dropped. </span><span class="diff-html-added" id="added-diff-73" style="font-size: 100%; background-color: #ddfade;">Any of the 4 built-in profiles can be used.</span> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-105" style="background-color: #d6f0ff;">geoloc_outgoing_call_profile</span></strong> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-74" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-106" style="background-color: #d6f0ff;">Should be set to the name of a geolocation profile to use for calls Asterisk sends to this remote endpoint. If not set, no geolocation processing will occur and any location descriptions coming from the associated incoming channel or the dialplan will be silently dropped and not conveyed to the endpoint. </span><span class="diff-html-added" id="added-diff-75" style="font-size: 100%; background-color: #ddfade;">Any of the 4 built-in profiles can be used.</span> </li>
</ul> <h1 id="AsteriskGeolocationImplementation-DialplanApplicationsandFunctions" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" id="removed-diff-67" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Dialplan Applications and Functions</span> </h1> <p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Two new dialplan applications and one dialplan function have </span><span class="diff-html-added" id="added-diff-76" style="font-size: 100%; background-color: #ddfade;">Example:</span> </p>
<table class="diff-macro diff-block-target diff-block-context" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/section.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Section</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse">
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">border</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">false</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Uses Sub</span> <br class="atl-forced-newline" /> <h4 id="AsteriskGeolocationImplementation-Parameters" style="margin: 10px 0 0 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0"> <span class="diff-html-changed" id="changed-diff-2" style="background-color: #d6f0ff;">Parameters</span> </h4> <span class="diff-html-removed" id="removed-diff-5" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">?</span> <h4 id="AsteriskGeolocationImplementation-Parameters" style="margin: 10px 0 0 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0"></h4>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" id="added-diff-6" style="font-size: 100%; background-color: #ddfade;">type</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: Object type. </span><span class="diff-html-changed" id="changed-diff-4" style="background-color: #d6f0ff;">Must be "location"</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-7" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-6" style="background-color: #d6f0ff;">yes</span> </li>
<li> <span class="diff-html-added" id="added-diff-8" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: </span><span class="diff-html-changed" id="changed-diff-7" style="background-color: #d6f0ff;">no</span> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-9" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">type=location</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">format</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: Must be one of </span><span class="diff-html-changed" id="changed-diff-8" style="background-color: #d6f0ff;">"civicAddress", "GML" or "URI" to indicate how the location is expressed.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-10" style="font-size: 100%; background-color: #ddfade;">Required: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">format=civicAddress</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">method</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-10" style="background-color: #d6f0ff;">If provided, it MUST be one of "GPS", "A-GPS", "Manual", "DHCP", "Triangulation", "Cell", "802.11"</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-11" style="font-size: 100%; background-color: #ddfade;">Required: </span><span class="diff-html-changed" id="changed-diff-12" style="background-color: #d6f0ff;">no</span> </li>
<li> <span class="diff-html-added" id="added-diff-12" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: </span><span class="diff-html-changed" id="changed-diff-13" style="background-color: #d6f0ff;">no</span> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-13" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">method=Manual</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_source</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-14" style="background-color: #d6f0ff;">If provided, it MUST be a fully qualified domain name. IP addresses are specifically not allowed. </span> </li>
</ul> <br />
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-15" style="background-color: #d6f0ff;">See </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" style="background-color: #d6f0ff;">RFC8787</span></a><span class="diff-html-changed" style="background-color: #d6f0ff;"> for the exact definition of this parameter.</span>
<ul style="margin: 10px 0 0 0"></ul> </li>
</ul> <p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The sub-parameters of location_info are dependent on the location's format:</span> </p> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">URI: A single </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">URI</span></code><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> sub-parameter with the URI.</span> <br /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> Example: {{</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-14" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_source=some.domain.net</span></code> </li>
</ul> </li>
</ul>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_info</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: Sub-parameters that describe the location. Dependent on the format selected.</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Required: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Sub-parameters: yes</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Examples:</span>
<ul style="margin: 10px 0 0 0">
<li> <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">URI</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> format: (see the </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">URI</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> page for more info)</span> <br /> <code style="font-family: monospace"><span class="diff-html-changed" id="changed-diff-17" style="background-color: #d6f0ff;">location_info = URI=</span><a class="external-link" href="http://some.example.com" rel="nofollow" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" style="background-color: #d6f0ff;">http://some.example.com</span></a></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-removed" id="removed-diff-14" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">}}</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li></li>
<li> <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" id="added-diff-15" style="font-size: 100%; background-color: #ddfade;">civicAddress</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> format: ( </span><span class="diff-html-changed" id="changed-diff-19" style="background-color: #d6f0ff;">See the </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-removed" id="removed-diff-15" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">URI</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" id="added-diff-16" style="font-size: 100%; background-color: #ddfade;">civicAddress</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><span class="diff-html-changed" id="changed-diff-20" style="background-color: #d6f0ff;">page for more info</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-16" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">.</span> <p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">civicAddress: A set of sub-parameters that describe the location.</span> <br /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> Example:</span> </p> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">location_info = </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-17" style="font-size: 100%; background-color: #ddfade;">)</span> <br /> <code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location_info = </span><span class="diff-html-changed" id="changed-diff-21" style="background-color: #d6f0ff;">country=US, A1="New </span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-17" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-22" style="background-color: #d6f0ff;">York", A3="New </span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-18" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-changed" style="background-color: #d6f0ff;"> </span><span class="diff-html-changed" id="changed-diff-23" style="background-color: #d6f0ff;">York"</span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-19" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> location_info = house_number=1633,PRD=W,street=46th location_info = street_suffix = Street,postal_code=10222 See the </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Civic Address</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <code style="font-family: monospace"><span class="diff-html-added" id="added-diff-18" style="font-size: 100%; background-color: #ddfade;">, ...</span></code> </li>
<li> <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">GML</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> format: (See the </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">GML</span></a><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><span class="diff-html-changed" id="changed-diff-24" style="background-color: #d6f0ff;">page for more info</span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" id="removed-diff-20" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">.GML: A set of sub-parameters that describe the location.</span> <br /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> Example: location</span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-19" style="font-size: 100%; background-color: #ddfade;">)</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">location</span><span class="diff-html-changed" id="changed-diff-25" style="background-color: #d6f0ff;">_info = shape=Circle, pos="39.12345 -105.98766", radius=100</span></code> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-removed" id="removed-diff-21" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">See the </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">GML</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> page for more info.</span>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-added" id="added-diff-20" style="font-size: 100%; background-color: #ddfade;">confidence</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">: </span><span class="diff-html-changed" id="changed-diff-27" style="background-color: #d6f0ff;">This is a rarely used field in the specification that would indicate the confidence in the location specified. See </span><a href="https://www.rfc-editor.org/rfc/rfc7459" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" style="background-color: #d6f0ff;">RFC7459</span></a><span class="diff-html-changed" style="background-color: #d6f0ff;"> for exact details.</span>
<ul style="margin: 10px 0 0 0">
<li> <span class="diff-html-added" id="added-diff-21" style="font-size: 100%; background-color: #ddfade;">Required: no</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Uses channel variables: no</span> </li>
<li> <span class="diff-html-changed" id="changed-diff-29" style="background-color: #d6f0ff;">Sub-parameters: </span><span class="diff-html-added" id="added-diff-22" style="font-size: 100%; background-color: #ddfade;">yes</span>
<ul style="margin: 10px 0 0 0">
<li> <strong><span class="diff-html-changed" id="changed-diff-31" style="background-color: #d6f0ff;">pdf</span></strong><span class="diff-html-changed" id="changed-diff-32" style="background-color: #d6f0ff;">: One of: "unknown", "normal", "rectangular".</span> </li>
<li> <strong><span class="diff-html-changed" id="changed-diff-33" style="background-color: #d6f0ff;">value</span></strong><span class="diff-html-changed" id="changed-diff-34" style="background-color: #d6f0ff;">: </span> </li>
</ul> </li>
</ul> </li>
</ul> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-removed" id="removed-diff-22" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">A percentage </span>
<ul style="margin: 10px 0 0 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li>
<ul style="margin: 10px 0 0 0; margin-top: 0">
<li> <span class="diff-html-added" id="added-diff-23" style="font-size: 100%; background-color: #ddfade;">0-100 percent </span><span class="diff-html-changed" id="changed-diff-35" style="background-color: #d6f0ff;">indicating the confidence </span><span class="diff-html-added" id="added-diff-24" style="font-size: 100%; background-color: #ddfade;">level</span><span class="diff-html-changed" id="changed-diff-36" style="background-color: #d6f0ff;">.</span> </li>
</ul> </li>
<li> <span class="diff-html-added" id="added-diff-25" style="font-size: 100%; background-color: #ddfade;">Default: none</span> </li>
<li> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example:</span> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> {{confidence = pdf=normal, confidence=95</span> </li>
</ul> </li>
</ul> <h4 id="AsteriskGeolocationImplementation-Example" style="margin: 10px 0 0 0; font-size: 14px; line-height: 20px; margin: 20px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Example</span> </h4>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/column.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Column</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse">
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">width</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">70%</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <h1 id="AsteriskGeolocationImplementation-Introduction" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0"> <span class="diff-html-changed" id="changed-diff-0" style="background-color: #d6f0ff;">Introduction</span> </h1> <p style="margin: 10px 0 0 0">The Geolocation capabilities are implemented in Asterisk with the res_geolocation and res_pjsip_geolocation modules and the geolocation.conf configuration file. There are also dialplan functions which allow you to manipulate location information as it's passed through the dialplan.</p> <h1 id="AsteriskGeolocationImplementation-LocationInformationFlow" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Location Information Flow</h1> <p style="margin: 10px 0 0 0">Location information can be supplied to Asterisk from several sources during the call flow...</p>
<ul style="margin: 10px 0 0 0">
<li>Sent by a caller in a SIP INVITE message.</li>
<li>Provided by a geolocation profile attached to the caller's endpoint.</li>
<li>Provided by the dialplan via the Geolocation apps and functions.</li>
<li>Provided by a geolocation profile attached to the callee's endpoint.</li>
</ul> <p style="margin: 10px 0 0 0">These sources aren't mutually exclusive and may, in fact, provide conflicting information or present the same information in multiple formats. Given that, there's no way for Asterisk to merge information nor is there a way for Asterisk to automatically determine which source should take precedence. However, you can use the geolocation profiles and the dialplan functions to tell Asterisk what to do with the location information received from the previous step in the call flow.</p> <h1 id="AsteriskGeolocationImplementation-CoreConfiguration" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Core Configuration</h1> <p style="margin: 10px 0 0 0">The bulk of the geolocation support is implemented in the res_geolocation module and configured in the geolocation.conf file. The file contains two main objects, Location and Profile.</p> <h2 id="AsteriskGeolocationImplementation-CommonBehavior" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Common Behavior</h2> <h3 id="AsteriskGeolocationImplementation-Sub-parameters" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0; margin-top: 10px">Sub-parameters</h3> <p style="margin: 10px 0 0 0">Some of the parameters in each object are actually lists of comma-separated name-value "sub-parameters". For example, the <code style="font-family: monospace">location_info</code> parameter in the Location object contains a list of sub-parameters that are specific to the location type. <span class="diff-html-added" id="added-diff-0" style="font-size: 100%; background-color: #ddfade;">For instance, a GML Circle might look like this:</span> </p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">location_info = shape=Circle, pos="39.12345 -105.98766", radius=100
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">Spaces around the equals signs and commas are ignored so you must double quote sub-parameter values with spaces or commas in them.</p> <p style="margin: 10px 0 0 0">For readability, parameters that use sub-parameters can be split over more than one line. For example:</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">location_info = country=US,A1="New York"
location_info = <span class="diff-html-removed" id="removed-diff-0" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">house_number</span><span class="diff-html-added" id="added-diff-1" style="font-size: 100%; background-color: #ddfade;">HNO</span>=1633,PRD=W,<span class="diff-html-removed" id="removed-diff-1" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">street</span><span class="diff-html-added" id="added-diff-2" style="font-size: 100%; background-color: #ddfade;">RD</span>=46th
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">would be equivalent to:</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">location_info = country=US,A1="New York",<span class="diff-html-removed" id="removed-diff-2" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">house_number</span><span class="diff-html-added" id="added-diff-3" style="font-size: 100%; background-color: #ddfade;">HNO</span>=1633,PRD=W,<span class="diff-html-removed" id="removed-diff-3" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">street</span><span class="diff-html-added" id="added-diff-4" style="font-size: 100%; background-color: #ddfade;">RD</span>=46th
</pre> </td>
</tr>
</tbody>
</table> <h3 id="AsteriskGeolocationImplementation-Variablesubstitution" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">Variable substitution</h3> <p style="margin: 10px 0 0 0">Some of the parameters can contain references to channel variables and dialplan functions. For example, you might have a URI location object that contains a reference to the <code style="font-family: monospace">EXTEN</code> channel variable:</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">location_info = URI=http://some.example.com?key=${EXTEN}
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">When a call is processed that uses this location object, <code style="font-family: monospace">${EXTEN</code>} would be replaced with the channel's extension and would result in a URI such as <code style="font-family: monospace"><a class="external-link" href="http://some.example.com?key=1000" rel="nofollow" style="color: #3b73af; text-decoration: none">http://some.example.com?key=1000</a></code>. You'd set up your web server to return a location document based on the value of "key".</p> <p style="margin: 10px 0 0 0">You can also use dialplan functions such as <code style="font-family: monospace">CURL</code> and <code style="font-family: monospace">ODBC_SQL</code> to supply values just as you would in extensions.conf.</p> <h2 id="AsteriskGeolocationImplementation-ConfigurationObjects" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-added" id="added-diff-5" style="font-size: 100%; background-color: #ddfade;">Configuration Objects</span> </h2> <h3 id="AsteriskGeolocationImplementation-Location" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0; margin-top: 10px"> <span class="diff-html-changed" id="changed-diff-1" style="background-color: #d6f0ff;">Location</span> </h3> <p style="margin: 10px 0 0 0">The Location object defines a discrete location or defines a template that can be used to define a discrete location on a per-call basis.</p> </td>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-4" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Parameter</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Required?</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Uses Channel</span> <br class="atl-forced-newline" /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Variables?</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-6" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Usage</span> </p> </th>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">type</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-7" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">format</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-8" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-9" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">method</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-10" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">location_source</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-11" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-13" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">location_info</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
</tr>
</tbody>
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">confidence</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
</tr>
</tbody>
</table>
<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">[mylocation]
type = location
format = civicAddress
method = Manual
location_info = country=US, A1="New York", A3="New York",
location_info = HNO=1633, PRD=W, RD=46th, STS=Street, PC=10222
</span>
</pre> </td>
</tr>
</tbody>
</table> <h3 id="AsteriskGeolocationImplementation-Profile" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0"> <span class="diff-html-changed" id="changed-diff-37" style="background-color: #d6f0ff;">Profile</span> </h3> <p style="margin: 10px 0 0 0">The Profile object defines how a location is used and is referenced by channel drivers.</p> </td>
</tr>
<tr>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-23" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Parameter</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Required?</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Uses Channel</span> <br class="atl-forced-newline" /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Variables?</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Uses Sub</span> <br class="atl-forced-newline" /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Parameters?</span> </p> </th>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Usage</span> </p> </th>
</tr>
<tr>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">type</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Must be "profile"</span> </p> </td>
</tr>
<tr>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">location_reference</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-24" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">pidf_element</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-25" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-29" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">profile_precedence</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-55" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">usage_rules</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-60" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">location_variables</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-61" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">notes</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-62" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">no</span> </p> </td>
<th class="confluenceTh" style="background-color: transparent; text-align: left; font-weight: normal;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" id="removed-diff-64" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Usage</span> </p> </th>
</tr>
</tbody>
</table>
<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">[myendpoint]
type = endpoint
...
geoloc_incoming_call_profile = <discard_incoming>
geoloc_outgoing_call_profile = myendpoint_profile
</span>
</pre> </td>
</tr>
</tbody>
</table> <h1 id="AsteriskGeolocationImplementation-DialplanFunction" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Dialplan Function</span> </h1> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">A new dialplan function has </span>been added to allow a dialplan author to manipulate geolocation information.</p> <h2 id="AsteriskGeolocationImplementation-GeolocProfileCreate" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" id="removed-diff-68" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">GeolocProfileCreate</span> </h2> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">This application creates a new Geolocation profile on the channel in addition to any others that may already exist. It tasks a profile name and an index as its arguments. Callers must use the </span> <h2 id="AsteriskGeolocationImplementation-GEOLOC_PROFILE" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-changed" id="changed-diff-108" style="background-color: #d6f0ff;">GEOLOC_PROFILE</span> </h2> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> <span class="diff-html-removed" id="removed-diff-69" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">function to set its actual location description.</span> <h2 id="AsteriskGeolocationImplementation-GEOLOC_PROFILE" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"></h2> <h2 id="AsteriskGeolocationImplementation-GeolocProfileDelete" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" id="removed-diff-70" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">GeolocProfileDelete</span> </h2> <p style="margin: 10px 0 0 0">This <span class="diff-html-removed" id="removed-diff-71" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">application deletes the existing Geolocation profile at the specified index from the channel's list of profiles.</span> </p> <h2 id="AsteriskGeolocationImplementation-GEOLOC_PROFILE" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">GEOLOC_PROFILE</span> </h2> <p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">This </span>function can get or set any of the fields in a specific profile. The available fields are those in <em>both</em> the Location and Profile configuration objects. <span class="diff-html-added" id="added-diff-77" style="font-size: 100%; background-color: #ddfade;">See the fuinction help for more information.</span> </p> <h1 id="AsteriskGeolocationImplementation-ExampleCallFlows" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Example Call Flows</h1> <h2 id="AsteriskGeolocationImplementation-SimpleExample1" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 10px">Simple Example 1</h2> <p style="margin: 10px 0 0 0">Alice and Bob work in the same building so in geolocation.conf, we can define a location that describes the building and profiles for Bob and Alice that add floor and room. We're assuming here that Bob's and Alice's phones don't send any location information themselves.</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">[building1]
type = location
format = civicAddress
location_info = country=US, A1="New York", A3="New York",
location_info = HNO=1633, PRD=W, RD=46th, STS=Street, PC=10222
method = Manual
[alice]
type = profile
location_reference = building1
location_refinement = FLR=4, ROOM=4B20
[bob]
type = profile
location_reference = building1
location_refinement = FLR=32, ROOM=32A6
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">In pjsip.conf, we can now associate those profiles to endpoints.</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">[bob]
type = endpoint
geoloc_incoming_call_profile = bob
[alice]
type = endpoint
geoloc_incoming_call_profile = alice
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">You'll notice that neither bob nor alice set <code style="font-family: monospace">geoloc_outgoing_call_profile</code> because we never want to send location information <em>to</em> them.</p> <p style="margin: 10px 0 0 0">Now when Alice makes a call, Asterisk will construct an effective profile (including any defaults and variable substitutions) that looks like this...</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">format = civicAddress
location_info = country=US, A1="New York", A3="New York",
location_info = HNO=1633, RD=46th, STS=Street, PC=10222, FLR=4, ROOM=4B20
method = Manual
usage_rules = retransmission-allowed=no
usage_rules = retention-expires="${STRFTIME($[${EPOCH}+86400],UTC,%FT%TZ)}"
allow_routing = no
pidf_element = device
</pre> </td>
</tr>
</tbody>
</table> <p style="margin: 10px 0 0 0">Bob's effective profile would be exactly the same except for <code style="font-family: monospace">FLR</code> and <code style="font-family: monospace">ROOM</code> </p> <p style="margin: 10px 0 0 0">This effective profile will then be forwarded to the dialplan. The dialplan application can then use GEOLOC_PROFILE to make changes before the effective profile is forwarded to the outgoing channel. It can also use GeolocProfileDelete to just delete the effective profile and pass nothing.</p>
<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/column.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Column</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse">
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">width</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">30%</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
<tbody>
<tr>
<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">Table of Contents:</p>
<table class="diff-macro bodyless" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/toc.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Table of Contents</th>
</tr>
</thead>
</table> <p style="margin: 10px 0 0 0">Geolocation:</p>
<table class="diff-macro bodyless" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<thead>
<tr>
<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/pagetree.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Page Tree</th>
</tr>
</thead>
<tbody>
<tr>
<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse">
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">root</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Geolocation</td>
</tr>
<tr>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">expandCollapseAll</td>
<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table> <p class="diff-block-target" style="margin: 10px 0 0 0"> <span class="diff-html-removed" id="removed-diff-72" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> </p> <p class="diff-context-placeholder" style="margin: 10px 0 0 0">...</p> </td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td class="email-content-main mobile-expand action-padding last-row-padding" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff; padding-bottom: 10px; padding-bottom: 10px">
<table id="actions-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px">
<tbody>
<tr>
<td id="actions-pattern-container" valign="middle" style="padding: 0px; border-collapse: collapse; padding: 15px 0 0 24px; vertical-align: middle">
<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?src=email" title="View page Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="View page Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aview-page-email-adg-footer-item%3Aicon" alt="View page Icon" style="vertical-align: middle" /></a></td>
<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?src=email" title="View page" style="color: #3b73af; text-decoration: none">View page</a></td>
<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td>
</tr>
</tbody>
</table>
<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Add comment Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aadd-comment-to-content-email-adg-footer-item%3Aicon" alt="Add comment Icon" style="vertical-align: middle" /></a></td>
<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Geolocation+Implementation?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment" style="color: #3b73af; text-decoration: none">Add comment</a></td>
<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td>
</tr>
</tbody>
</table>
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=49153340&src=email" title="Like Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Like Icon" src="cid:com.atlassian.confluence.plugins.confluence-like%3Aview-email-adg-content-item%3Aicon" alt="Like Icon" style="vertical-align: middle" /></a></td>
<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=49153340&src=email" title="Like" style="color: #3b73af; text-decoration: none">Like</a></td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td class="email-content-rounded-bottom mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; height: 5px; line-height: 5px; padding: 0 15px 0 16px; background-color: #fff; border-bottom-right-radius: 5px; border-bottom-left-radius: 5px; border-top: 0; border-left: 1px solid #ccc; border-bottom: 1px solid #ccc; border-right: 1px solid #ccc; mso-line-height-rule: exactly"> </td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td id="footer-pattern" style="padding: 0px; border-collapse: collapse; padding: 12px 20px">
<table id="footer-pattern-container" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333">
<tbody>
<tr>
<td id="footer-pattern-links-container" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px">
<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px">
<tbody>
<tr>
<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST&src=email" title="" style="color: #3b73af; text-decoration: none">Stop watching space</a></td>
<td class="footer-pattern-links-bull" style="padding: 0px; border-collapse: collapse; padding: 0 5px; color: #999">•</td>
</tr>
</tbody>
</table>
<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px">
<tbody>
<tr>
<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action?src=email" title="" style="color: #3b73af; text-decoration: none">Manage notifications</a></td>
</tr>
</tbody>
</table> </td>
</tr>
<tr>
<td id="footer-pattern-text" class="mobile-resize-text" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px; display: none">This message was sent by Atlassian Confluence 5.6.6</td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table>
<table id="sealed-section" border="0" cellpadding="0" cellspacing="0" width="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; display: none">
<tbody>
<tr>
<td style="padding: 0px; border-collapse: collapse; border: 0; font-size: 0px; line-height: 0; mso-line-height-rule: exactly"></td>
</tr>
</tbody>
</table>
</body>
</html>