Empty CalculationMethodEnum in Geocoding Response

Question

Empty CalculationMethodEnum in Geocoding Response

François Victor 0

According to the documentation at

https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding?view=rest-maps-2025-01-01&tabs=HTTP#calculationmethodenum

CalculationMethodEnum should be one of "Interpolation", "InterpolationOffset", "Parcel" or "Rooftop".

For address "41, Kraeizgaass (Et. RC) L - 9807 Hosingen" however I keep getting

"calculationMethod": "",

in the JSON response, using API version 2025-01-01.

Manas Mohanty 13,255 Moderator

Hi François Victor

CalculationMethodEnum value would be blank if none of the supported values are used to define the location.

So, it means it is neither a road, parcel office, roof top

But I am getting below output with command

https://atlas.microsoft.com/geocode?api-version=2025-01-01&addressLine=41%2C%20Kraeizgaass%20(Et.%20RC)%20L%20-%209807%20Hosingen&subscription-key=

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [6.0912031, 50.0156803]
      },
      "bbox": [6.08318870080724, 50.0118175824293, 6.09921749919276, 50.0195430175707],
      "properties": {
        "type": "Address",
        "confidence": "High",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ],
            "geometry": {
              "type": "Point",
              "coordinates": [6.0912031, 50.0156803]
            }
          },
          {
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ],
            "geometry": {
              "type": "Point",
              "coordinates": [6.0912253, 50.0157105]
            }
          }
        ],
        "address": {
          "addressLine": "41 Kraeizgaass",
          "streetName": "Kraeizgaass",
          "streetNumber": "41",
          "postalCode": "L-9807",
          "locality": "Hosingen",
          "formattedAddress": "41, Kraeizgaass, L-9807 Hosingen, Luxembourg",
          "countryRegion": {
            "name": "Luxembourg",
            "ISO": "LU"
          },
          "adminDistricts": [
            {
              "shortName": "Diekirch"
            },
            {
              "shortName": "Clervaux"
            }
          ]
        }
      }
    }
  ]
}

Please share your command to validate.

François Victor 0

Hi Monas,

my query is:

https://atlas.microsoft.com/geocode?api-version=2025-01-01&query=41%2C%20Kraeizgaass%20(Et.%20RC)%20L%20-%209807%20%20Hosingen&subscription-key=

and the full response is:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    6.090418815612793,
                    50.014434814453125
                ]
            },
            "properties": {
                "type": "Postcode1",
                "confidence": "Medium",
                "geocodePoints": [
                    {
                        "calculationMethod": "",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                6.090418815612793,
                                50.014434814453125
                            ]
                        }
                    }
                ],
                "address": {
                    "postalCode": "L-9807",
                    "locality": "Hosingen",
                    "countryRegion": {
                        "name": "Luxembourg",
                        "ISO": "LU"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "Diekirch"
                        },
                        {
                            "shortName": "Clervaux"
                        }
                    ],
                    "formattedAddress": "L-9807, Luxembourg"
                }
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    1.4278960227966309,
                    47.61689376831055
                ]
            },
            "bbox": [
                0.5805431008338928,
                47.18635177612305,
                2.247746706008911,
                48.13322067260742
            ],
            "properties": {
                "type": "AdminDivision2",
                "confidence": "Low",
                "geocodePoints": [
                    {
                        "calculationMethod": "",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                1.4278960227966309,
                                47.61689376831055
                            ]
                        }
                    }
                ],
                "address": {
                    "countryRegion": {
                        "name": "France",
                        "ISO": "FR"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "Centre-Val de Loire"
                        },
                        {
                            "shortName": "Loir-et-Cher"
                        }
                    ],
                    "formattedAddress": "Loir-et-Cher"
                }
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    16.03192710876465,
                    38.23890686035156
                ]
            },
            "bbox": [
                15.629860877990723,
                37.9157600402832,
                16.58292579650879,
                38.573387145996094
            ],
            "properties": {
                "type": "AdminDivision2",
                "confidence": "Low",
                "geocodePoints": [
                    {
                        "calculationMethod": "",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                16.03192710876465,
                                38.23890686035156
                            ]
                        }
                    }
                ],
                "address": {
                    "countryRegion": {
                        "name": "Italy",
                        "ISO": "IT"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "Cal."
                        },
                        {
                            "shortName": "RC"
                        }
                    ],
                    "formattedAddress": "Reggio di Calabria"
                }
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    38.65211868286133,
                    10.211669921875
                ]
            },
            "bbox": [
                32.99757385253906,
                3.3974380493164062,
                47.982391357421875,
                14.89434814453125
            ],
            "properties": {
                "type": "CountryRegion",
                "confidence": "Low",
                "geocodePoints": [
                    {
                        "calculationMethod": "",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                38.65211868286133,
                                10.211669921875
                            ]
                        }
                    }
                ],
                "address": {
                    "countryRegion": {
                        "name": "Ethiopia",
                        "ISO": "ET"
                    },
                    "formattedAddress": "Ethiopia"
                }
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    103.88338470458984,
                    20.72819709777832
                ]
            },
            "bbox": [
                103.65779876708984,
                20.548721313476562,
                104.10128784179688,
                20.91318702697754
            ],
            "properties": {
                "type": "AdminDivision2",
                "confidence": "Low",
                "geocodePoints": [
                    {
                        "calculationMethod": "",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                103.88338470458984,
                                20.72819709777832
                            ]
                        }
                    }
                ],
                "address": {
                    "countryRegion": {
                        "name": "Laos",
                        "ISO": "LA"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "HP"
                        },
                        {
                            "shortName": "Muang Et"
                        }
                    ],
                    "formattedAddress": "Muang Et"
                }
            }
        }
    ]
}

When using the addressLine parameter instead of the query parameter:

https://atlas.microsoft.com/geocode?api-version=2025-01-01&addressLine=41%2C%20Kraeizgaass%20(Et.%20RC)%20L%20-%209807%20%20Hosingen&subscription-key=

the response has no results:

{
    "type": "FeatureCollection",
    "features": []
}

The empty enum value is not documented and not as straight forward to implement. It would have been nicer to have a documented enum of value "Other" or "Unknown" or similar.

1 answer

Your answer

Manas Mohanty 13,255 Reputation points Moderator

2025-10-27T18:09:11.4166667+00:00

Hi François Victor

CalculationMethodEnum value would be blank if none of the supported values are used to define the location.

So, it means it is neither a road, parcel office, roof top

But I am getting below output with command

https://atlas.microsoft.com/geocode?api-version=2025-01-01&addressLine=41%2C%20Kraeizgaass%20(Et.%20RC)%20L%20-%209807%20Hosingen&subscription-key=

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "Point", "coordinates": [6.0912031, 50.0156803] }, "bbox": [6.08318870080724, 50.0118175824293, 6.09921749919276, 50.0195430175707], "properties": { "type": "Address", "confidence": "High", "matchCodes": [ "Good" ], "geocodePoints": [ { "calculationMethod": "Rooftop", "usageTypes": [ "Display" ], "geometry": { "type": "Point", "coordinates": [6.0912031, 50.0156803] } }, { "calculationMethod": "Rooftop", "usageTypes": [ "Route" ], "geometry": { "type": "Point", "coordinates": [6.0912253, 50.0157105] } } ], "address": { "addressLine": "41 Kraeizgaass", "streetName": "Kraeizgaass", "streetNumber": "41", "postalCode": "L-9807", "locality": "Hosingen", "formattedAddress": "41, Kraeizgaass, L-9807 Hosingen, Luxembourg", "countryRegion": { "name": "Luxembourg", "ISO": "LU" }, "adminDistricts": [ { "shortName": "Diekirch" }, { "shortName": "Clervaux" } ] } } } ] }

Please share your command to validate.

Answer 1

IoTGirl 3,831 Microsoft Employee Moderator

You are not using "Address Line" as documented and it found nothing that matched so an empty collection should be expected. It, addressLine, should not have the postal code or city. There are other fields for those. "Address Line" is part of a structured call not a query call and you are putting too much into the address line so nothing will match.

See the structure here: GET https://atlas.microsoft.com/geocode?api-version=2025-01-01&top={top}&query={query}&addressLine={addressLine}&countryRegion={countryRegion}&bbox={bbox}&view={view}&coordinates={coordinates}&adminDistrict={adminDistrict}&adminDistrict2={adminDistrict2}&adminDistrict3={adminDistrict3}&locality={locality}&postalCode={postalCode}

So you should review https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding?view=rest-maps-2025-01-01&tabs=HTTP#uri-parameters

You would use parameters like "addressLine=41%20Kraeizgaass&countryRegion=Luxembourg&postalCode=L-9807&locality=Hosingen" to narrow the search results to the regions within the address.

François Victor 0 Reputation points

2025-11-03T08:29:22.2066667+00:00

I do not have structured address data, that's why I use the "query" parameter resulting in an undocumented return of an empty calculation method for this specific address. When I tried the example query given by Manas Mohanty, using the addressLine parameter, my result was an empty collection while for him a valid address with non-empty calculation method seems to have been found.
IoTGirl 3,831 Reputation points Microsoft Employee Moderator

2025-11-25T20:23:55.09+00:00

My point was this result is expected as you are not providing an address line but rather a query string with all parts of the address included, therefore there is no match and no method that could be used to match as it is unmatchable as an "Address Line". As documented, in order to leverage this parameter, you would need to parse your data beforehand.

Share via

Empty CalculationMethodEnum in Geocoding Response

1 answer

Your answer