Finding Street Intersections
The geocodeIntersections operation searches for the intersections between two or more streets. The response contains the coordinates of the intersections.
The following l isting shows the general structure of the operation in the WSDL file of the MapTP Geocoder 5.1 Service:
...
<message name="geocodeIntersectionsRequest">
<part name="RequestHeader" type="tns:RequestHeader"/>
<part name="GeocodeIntersectionsRequest" type="tns:GeocodeIntersectionsRequest"/>
</message>
<message name="geocodeIntersectionsResponse">
<part name="GeocodeIntersectionsResponse " type="tns:GeocodeIntersectionsResponse"/>
</message>
</operation>
...
</portType>
...
Request
GeocodeIntersectionsRequest contains the parameters of a geocodeIntersections operation.

| Field |
Description |
| Intersections |
The Intersections array contains all found intersections of type Intersection. |
| Properties |
Not used. |

| Field |
Description |
| Addresses |
An Intersection contains an array of Address elements used for specifying the streets to be taken into account in the intersection search.
Note: Not all fields of an address are necessary to identify the street. Usually, only the following fields are used:
- Street- defines the name of the street
- City - defines the city where the street is.
- Country – defines a country where the city is.
- County
- ZIP
|
| Properties |
Not used. |
Response
The GeocodeIntersectionsResponse element contains the response of a geocodeIntersections request in the Intersections array.

| Field |
Description |
| Intersections |
The Intersections array contains the point of intersection between the two given streets. |
| Properties |
Not used |

| Field |
Description |
| IntersectionPoints |
The IntersectionPoints array contains an array of coordinates for each found intersection. Each found intersection can then be identified by its coordinates. |
| Bounds |
The Bounds element contains the coordinates of two corners that describe a bounding box containing all found intersections. |
| GeocodedAddresses |
The GeocodedAddresses array contains a GeocodedAddress element for each address that was specified in the request. |
| Properties |
Not used. |
The GeocodedAddresses array contains a GeocodedAddress element for each address that was specified in the request.

A GeocodedAddress element contains the following information:
- If an ID is passed for the input address in the request, the ID field contains this ID. Otherwise, this field is empty.
- The HouseNo, Street, ZIP, etc. fields contain the input address data. Only those fields are returned that have been provided in the request.
- The Alternatives array contains the geocoding results. If more than one address was found for the given address data, multiple geocoding results are provided in the Alternatives array. Note that the maximum number of returned geocoding results can be defined in the request with MaxNoOfAlternatives. A geocoding result is contained in a GeocodeAddress.Alternative element. The structure of a GeocodeAddress.Alternative element is shown in the following figure:

Fields of a GeocodeAddress.Alternative element:
| Field |
Description
|
ID
|
A unique identifier of the request. If an ID is passed in the request, it is returned in the response. Otherwise, this field is empty.
|
| HouseNo |
The house number of the geocoding result (if available). |
| Street |
The street of the geocoding result. |
ZIP
|
The ZIP code of the geocoding result. |
City
|
The city of the geocoding result. |
District
|
The district.
|
County
|
The county.
|
State
|
The state.
|
Country
|
The country of the geocoding result.
|
Quality
|
The quality of the result. The following quality levels are defined:
- Exact: The result matches the input address exactly. Even the house numbers of the input address and the result are identical.
- Street: The result matches the input address on street level.
- ZIP: The result matches the input address on ZIP code level.
- District: The result matches the input address on city district level.
- City: The result matches the input address on city level.
- Mismatch: The result does not match the input address.
|
Similarity
|
The similarity between the result and the given input address in a scale from "0.00" (mismatch) to "1.00" (direct hit). Besides the Quality element, this field provides information on the accuracy of the result. |
Coordinate
|
The latitude and longitude of the result. |
Examples
An example request is provided here.
|