Geocoder API Developer's Guide

Customizing the Response

The response to a successful request always contains a default set of elements. However, the service offers flexibility in this respect, allowing you to fine-tune the response by elminating information you do not require or adding information that is not among the default elements. You can manage the information in the response through attribute switch parameters:

For example, to add matchCode and parsedRequest, add the following to the request:

&responseattributes=matchCode,parsedRequest

You can also use abbreviated names of the response elements:

&responseattributes=mc,pr

The following example removes mapView so that the response contains only address and mapReference:

&locationattributes=-mapView

To add additionalData to the previous example and to ensure that the response contains address, mapReference and additionalData, use:

&locationattributes=-mapView,additionalData

If all attributes except mapView are required, use the value all and remove unnecessary attributes. The following example causes the whole attribute set except mapView to be included in the response:

&locationattributes=all,-mapView
If you only want to specify a small set of attributes, use the value none followed by the required attributes. The following example shows how ensure that address is the only location attribute in the response.
&locationattributes=none,address

The table below documents the supported attribute switch parameters and their values. (This information is also available under Geocode Resource.)

Table 1. Supported attribute switch parameters
Attribute switch Values
addressattributes

A comma-separated list whose elements are present in the response data.

Enumeration [country, state, county, city, district, subdistrict, street, houseNumber, postalCode, addressLines, additionalData]

Abbreviated forms: [ctr, sta, cty, cit, dis, sdi, str, hnr, pst, aln, add]

Default in response: All except addressLines.

Note: The value names are case-sensitive.
locationattributes

A comma-separated list whose elements are present in the response data.

Enumeration [address, mapReference, mapView, addressDetails, streetDetails, additionalData, adminIds, linkInfo, adminInfo, timeZone, addressNamesBilingual, related.nearByAddress]

Abbreviated forms: [ar, mr, mv, dt, sd, ad, ai, li, in, tz, nb, rn]

The adminIds switch is available with forward geocoding only.

For retrieving Time Zone information the parameter adminInfo has to be added, e.g., locationattributes=adminInfo,timeZone

In reverse geocoding results, adminIds are always present unless turned off through locationattributes=none. locationattributes=-adminIds has no effect on reverse geocoding results.

The related.nearByAddress switch is available with the trackPosition mode of reverse geocoding only.

Default in reverse geocoding response: address, mapView, additionalData, mapReference, adminIds.

Default in forward geocoding response: address, mapView, additionalData.

With mapReference link PVID, side of street, and admin area PVIDs are present in the response data. With adminIds, only admin area PVIDs are present.

Note: The value names are case-sensitive.
responseattributes

A comma-separated list whose elements are present in the response data.

Enumeration [performedSearch, matchQuality, matchType, matchCode, parsedRequest]

Abbreviated forms: [ps, mq, mt, mc, pr]

Default in response: matchQuality, matchType

Note: he value names are case-sensitive.