Geocoding Options

The following table lists the options that control how a location's coordinates are determined.

Note: As the EGM Module transitions its administrative tasks to a web-based Management Console, labels for the options may use different wording than what you see in Enterprise Designer. There is no difference in behavior.
Table 1. Geocoding Options for Norway

Parameter

Description

GeocodeLevel

Specifies how precisely you want to geocode addresses. One of the following:

StreetAddress
The geocoder attempts to geocode addresses to a street address, but some matches may end up at a less precise location such as a postal code centroid, intersection, or shape path.
PostalCentroid
If postal code data is available, the geocoder attempts to geocode addresses to the most precise postal code it finds. The advantage of postal code centroid matching is the speed of the operation. The disadvantage of postal code matching is that the geocoder only examines the PostalCode field. If you use street address precision, the geocoder looks at both the street name and the PostalCode field and attempts to return street-level coordinates and optionally fall back to postal code coordinates.
GeographicCentroid
The geocoder attempts to geocode addresses to the geographic centroid of a city or state.

Interpolation

Y
Yes, perform address point interpolation.
N
No, do not perform address point interpolation.

FallbackToGeographic

Specifies whether to attempt to determine a geographic region centroid when an address-level geocode cannot be determined.

Y
Yes, determine a geographic centroid when an address-level centroid cannot be determined. Default.
N
No, do not determine a geographic centroid when an address-level centroid cannot be determined.

FallbackToPostal

FallbackToPostal

Specifies whether to attempt to determine a postal code centroid when an address-level geocode cannot be determined.

Y
Yes, determine a postal code centroid when an address-level centroid cannot be determined. Default.
N
No, do not determine a postal code centroid when an address-level centroid cannot be determined.

OffsetFromStreet

Indicates the offset distance from the street segments to use in street-level geocoding. The distance is specified in the units you specify in the OffsetUnits option.

The default value varies by country. For most countries, the default is 7 meters.

The offset distance is used in street-level geocoding to prevent the geocode from being in the middle of a street. It compensates for the fact that street-level geocoding returns a latitude and longitude point in the center of the street where the address is located. Since the building represented by an address is not on the street itself, you do not want the geocode for an address to be a point on the street. Instead, you want the geocode to represent the location of the building which sits next to the street. For example, an offset of 40 feet means that the geocode will represent a point 40 feet back from the center of the street. The distance is calculated perpendicular to the portion of the street segment for the address. Offset is also used to prevent addresses across the street from each other from being given the same point. The diagram below shows an offset point in relation to the original point.

Street coordinates are accurate to 1/10,000 of a degree and interpolated points are accurate to the millionths of a degree.

OffsetFromCorner

Specifies the distance to offset the street end points in street-level matching. The distance is specified in the units you specify in the OffsetUnits option.This value is used to prevent addresses at street corners from being given the same geocode as the intersection.

Note: Offset is not supported for the United Kingdom (GBR) or Japan (JPN).

The default value varies by country:

  • 12 meters—Australia (AUS), Austria (AUT), Germany (DEU)
  • 7 meters—For other supported countries, the default offset is 7 meters.

The following diagram compares the end points of a street to offset end points.

OffsetUnits

Specifies the unit of measurement for the street offset and corner offset options. One of the following:

  • Feet
  • Miles
  • Meters
  • Kilometers

The default is Meters.

CoordinateSystem

A coordinate system is a reference system for the unique location of a point in space. Cartesian (planar) and Geodetic (geographical) coordinates are examples of reference systems based on Euclidean geometry. Spectrum™ Technology Platform supports systems recognized by the European Petroleum Survey Group (EPSG).

Each country supports different coordinate systems. Depending on the country, you have one or more of the following options:

EPSG:4326
Also known as the WGS84 coordinate system.
EPSG:27200
Also known as the NZGD49 coordinate system.

IncludeInputs

Specifies whether to return the formatted input street address and each input address element in a separate field. This feature can help you understand how the input address was parsed and identify specific input elements that could not be geocoded. For example, a returned HouseNumber.Input could contain an invalid house number in your input address.
You can specify parsed input returns for a specific country. For example, a REST API example for Canada is:
Option.CAN.IncludeInputs=Y
Note: Data vintage must be 2014 Q4 or newer to get Parsed Address Input returns. Also note that Parsed Address Input elements are not returned for every country.
Parsed Address Input elements are returned in separately labeled fields names with a .Input extension. For example:
  • FormattedInputStreet.Input
  • City.Input
  • Country.Input
  • HouseNumber.Input
  • Locality.Input
  • PostalCode.Base.Input
  • StreetName.Input
  • StreetSuffix.Input

    Other labeled fields are possible depending on the input address, country, and data source.

    Note: Parsed Address Input elements are not returned for every country. Also, because Geocode Address World geocodes to the geographic or postal level only (not street address), this does not return Parsed Address Input

    For many countries, if part of the input address could not be recognized as a specific address element, this content is returned in UnparsedWords.Input.

    For intersection addresses, the first entered street is returned in StreetName.Input and the second entered street name is returned in IntersectionIdStreet2.Input.