What is geocodeQuality?
Geocoding is the process of converting addresses (like a street address) into geographic coordinates (latitude and longitude), which can be used to place markers on a map, or position the map.
When Locations in ServiceTrade are geocoded we store a geocodeQuality integer value indicating how precise the latitude and longitude are, which we then return via the API.
Understanding geocodeQuality Integer Values
ServiceTrade geocodeQuality is determined by Google Maps Platform.
Below is a list of definitions for the geocodeQuality values that we return via the API.
'ROOFTOP' => 99
Rooftop indicates that the returned result is a precise geocode for which we have location information accurate down to street address precision.
'RANGE_INTERPOLATED' => 90
Range interpolated indicates that the returned result reflects an approximation (usually on a road) interpolated between two precise points (such as intersections). Interpolated results are generally returned when rooftop geocodes are unavailable for a street address.
'GEOMETRIC_CENTER' => 89
Geometric indicates that the returned result is the geometric center of a result such as a polyline (for example, a street) or polygon (region).
'APPROXIMATE' => 50
Approximate indicates that the returned result is approximate.
'110' indicates user inserted data.
Any user in our system can move the pin for an address's geolocation and it affects all users.
See the example below on the map section of the location page of a location that could not be geocoded.