GeoTree Screen

Last Updated: Wed Mar 22 2023

The GeoTree is configured in Setup / Usage Rating / Rate Types / GeoTree


The GeoTree is a structured tree comprised of nodes which can represent locations (e.g. Everywhere/South America/Brazil) or another location specific entity such as a carrier/service area (e.g. Everywhere/North America/Canada/Zone 1). At each node patterns can be configured. When the GeoTree is used by the rating engine the usage record's destination value (terminating number, IP address, etc.) is matched against the patterns defined in the tree in order to map the usage to a location. When a pattern match occurs the rate that is applied is determined by checking the 'Location' value on the rates that exist in a rate plan. If a rate with a matching location cannot be found a usage exception will occur.

The GeoTree can be as granular as you require it to be and map to whatever scheme you require. For instance, the tree could be organized by:

  • Patterns within a state/province

  • Zones or groups of locations

  • Top level rates (one price for an entire country/region instead of having to define each individual pattern)

  • Regions or types of operators (allowing you to specify a different rate based on which operator's network the user is on)

Locations defined in the GeoTree can also be used to create location groups. Location groups are comprised of multiple GeoTree locations which rates can be applied to (for example a single location group could include multiple countries).


No back-end configuration or custom code is required to create or modify the GeoTree. The data in the GeoTree can be imported as needed.

Note: The GeoTree will not be used for rating unless the usage class matching the usage being rated is setup to use the GeoTree (i.e. the class's 'Rater' field is set to 'GeoTree').

The GeoTree Panel

The GeoTree panel on the left of this screen allows you to expand and select nodes in the tree so that you can view or edit node configuration details.

GeoTree List

The list on the left of the screen shows the nodes that are currently configured in the GeoTree. When you select a node in the list you will be able to edit node and pattern details in the Edit Pattern panel to the right. These settings are explained in more detail below.

The Edit Pattern Panel

The information in this panel reflects the currently selected node in the GeoTree list. From here you can view, add, edit or delete patterns and nodes in the tree.

Patterns tab

This tab will show any patterns currently configured on the node. When the rating engine processes usage it will compare the destination value of the mediated usage record against the patterns in the GeoTree (provided the tree is configured to be the rater for the class of usage in question). A matched pattern will result in the system looking for a rate configured for the location where the pattern resides (e.g. if the pattern found was under the 'Everywhere/France/Paris' node there needs to be a usage rate in the rate plan with a 'Location' value of 'Everywhere/France/Paris' in order to rate the usage). If the usage record destination value doesn't match any pattern in the GeoTree, a usage exception will occur.

Patterns added/edited here can by any alphanumeric value. For IP addresses slash notation is supported (e.g. For more information on adding and editing patterns see the guides provided below.

Nodes tab

This tab displays the nodes that exist beneath the current node you are viewing. From here you can create, edit and delete sub-nodes beneath the currently selected node. See the guides below for details on how to add/edit/delete nodes in the GeoTree.


Adding GeoTree Nodes

  1. Select the node you wish to add the new node beneath on the left under the GeoTree heading

  2. Load the Nodes tab

  3. Click the + New button

  4. On the model that loads give the node a Name that is appropriate for its location in the tree (e.g. ‘Europe’)

  5. Click Add to add the new node

  6. Repeat the three steps above to add additional sub-nodes at the current node location if desired

  7. When you have finished adding sub-nodes to the current node click Save to create the nodes

Adding and Editing GeoTree Patterns

  1. Locate and select the node on the left under the GeoTree heading or use the Filter text box to narrow down the list

  2. Ensure the Patterns tab is selected

  3. Existing patterns configured on the node will be displayed (if any)

  4. To add a new pattern, click on the + New button. On the model that loads enter the pattern (Name) and Country the pattern relates to then select Add

  5. To edit an existing pattern, click on the (emoji) button and modify the pattern (Name) and Country as desired, then select Update

  6. Click Save to commit your changes

Deleting GeoTree Nodes

  1. Select the node above the node you wish to delete on the left under the GeoTree heading

  2. Load the Nodes tab

  3. Next to the node you wish to delete click on the (emoji) button

  4. Click on the (emoji) button which appears and the node will be tagged for deletion

  5. Repeat the two steps above to mark additional nodes for deletion if desired

  6. When you are finished click Save to commit your changes