Junction Networks Web Services API

E911LocationAdd

An ERL is a specific geographic location provided to the Public Safety Answering Point (PSAP) and to which a 911 emergency response team may be dispatched. A PSAP is a call center responsible for answering calls to an emergency telephone number for police, firefighting, and ambulance services.

In a large enterprise, the PBX administrator may break down the campus or enterprise area into several different ERLs. This way, the PSAP is provided with location information which is more precise than simply the main address. For instance, each building on the enterprise campus, or floor or wing in the enterprise building, may be considered its own ERL, and within a given ERL there may be several phones or extensions. In some states, regulations require that enterprises maintain ERLs of specific sizes or identifiable areas (i.e. ERL per 1000 square feet or per floor).

An E911Location record may be "Shared" or "Private". Shared location records may be assigned to zero or more users within an origanization and are typically used for offices where many people are utilizing the same address. Private location records are assigned to zero or one user and are typically used for home offices or remote workers.

An E911Location record is assigned to a UserAddress using the E911LocationAssign API call.

City-State-Zip provisioning is implemented when a location cannot be validated as a "Full" address. If only the city, state, and zip-code pass validation, then the address will be accepted as a CSZ entry. This functionality increases the total number of locations that may be provisioned, which ensures that 911 service can be maintained for the maximum amount of users. However, this functionality should be used sparingly, and a “Full” address should be validated whenever possible.

How to implement CSZ: a) attempt to validate a location with the “CszOnly” field set to “false”, b) if validation fails, prompt the user with the alternative addresses provided, c) if the set of alternatives fails, send a request with the “CszOnly” field set to “true”. The use of CSZ functionality does not automatically guarantee that an address will be validated. The city, state, and zip-code must be valid for the address to be provisioned.

Authentication

Authorization

If the location is a "Shared" location, then we need to be be able to update that organization.
If the location is a "Private" location, then we need update on user to which the location belongs.

Parameters

Result RELAX NG Schema Modules

Result Element Example