Geocoding Options
The following table lists the options that control how a location's coordinates are determined.
Parameter |
Description |
---|---|
Option.GeocodeLevel |
Specifies how precisely you want to geocode addresses. One of the following:
|
Option.Interpolation |
Specifies whether to perform address point interpolation. This option only works if you have a point database installed. This option is available for selected countries only. Address point interpolation uses point data to refine geocode results. By default, the geocoding process estimates the location of an address based on the street numbers at either end of street segment. For example, if a street segment runs from 100 Main St. to 200 Main St., then a request for 150 Main St. will return a location in the middle of the segment. With interpolation, the geocoder finds the position of 180 Main St. in the point data, and it is about two-thirds of the way down the street. Using this information, the geocoder can estimate the position of 150 Main St. based on 100 and 180 Main St. In this case, the geocoder estimates the location of the address slightly away from the center of the segment.
|
Option.FallbackToGeographic |
Specifies whether to attempt to determine a geographic region centroid when an address-level geocode cannot be determined.
|
Option.FallbackToPostal |
|
Option.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: |
Option.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:
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:
|