Feedback (experimental)

Challenge

PTV Logistics is striving to deliver the best experience to its customers. A simple and effective measure is to enable customers to easily provide feedback about geocoding results obtained. This page describes how a customer can easily report which result of a returned list is the best match in her opinion. This collaborative effort will help monitor and improve the quality of geocoding results.

Identifying Results

The returned list of results contains, for each item, a unique feedback-id. A feedback-id can be used to identify and report an item or result that is the best match for you. For example, if you geocode the address Pariser Platz 5-6, 10117 Berlin, Deutschland you will obtain the following list of results.

{
    "locations": [
        {
            "referencePosition": {
                "latitude": 52.51694869995117,
                "longitude": 13.379170417785645
            },
            "roadAccessPosition": {},
            "address": {},
            "formattedAddress": "Pariser Platz 5, 10117 Berlin",
            "feedbackId": "16dcc2f6-d275-4162-b570-6fcae3ef4f37",
            "locationType": "EXACT_ADDRESS",
            "quality": {
                "totalScore": 99
            }
        },
        {
            "referencePosition": {
                "latitude": 52.516910552978516,
                "longitude": 13.378459930419922
            },
            "roadAccessPosition": {},
            "address": {},
            "formattedAddress": "Pariser Platz 6, 10117 Berlin",
            "feedbackId": "9632af34-1c96-4141-bebe-a97f7f219365",
            "locationType": "EXACT_ADDRESS",
            "quality": {
                "totalScore": 99
            }
        }
    ],
    "noMatchFeedbackId": "3c373f54-1da0-49d4-b803-1ec76d9177cc"
}

Feedback-Id 16dcc2f6-d275-4162-b570-6fcae3ef4f37 identifies the first result as the best match.
Feedback-Id 9632af34-1c96-4141-bebe-a97f7f219365 identifies the second result as the best match.
'noMatch'-Feedback-Id 3c373f54-1da0-49d4-b803-1ec76d9177cc identifies or conveys that none of the two results returned is a good match.

How to give feedback?

After identifying the best match, giving feedback is as simple as passing the corresponding feedback-id to the feedback endpoint. Otherwise, if none of the results in the list is a good match, passing the corresponding 'noMatch'-feedback-id would suffice.

Try it out in the feedback code sample.

Costs

Of course, the use of feedback endpoint is free.

Caveats

This feature is still experimental, and it is available for results or response provided by the following endpoints.