Skip to Content
GeocodingReferenceReview reasons

Review reasons

For: developers and implementers.

When a site goes to needs_review, resolutionNote says why. The API notes are in English and are cut at 255 characters. The To review list shows them translated. In these tables, X, CC and N are values of the case.

If a site carries no point at all, the note is the one for the missing source, even if the country is also missing. If a source gives a point, the note is the one from the district check.

The declared district

NoteCauseWhat to do
country is required to check the districtNo country, or it is not a valid ISO codeSend country
country CC has no district boundariesThe country has no boundaries loaded (today only CL and PE)See Certify a new country
district is requiredNo districtCode or districtSend one of the two
district code X not found in CCThe code does not exist in that countryCheck the code
district X not found in CCThe name does not exist in that countryCheck the name or send the code
district X is ambiguous in CC; send its codeThe name repeats in the countrySend districtCode
district code is too long / district name is too longMore than 16 / 255 characters
district X has no boundary to check againstThe district has no polygon in the dataPlacing it by hand does not work: the check also fails. Reject it or send another district

The point sources

NoteCause
no geofence, plus code or coordinatesNo point source and no usable address
an address needs a district with a boundary to be geocodedThere is an address, but the district was not found or has no polygon
plus code X is not validInvalid Plus Code and no later source responded
a short plus code needs a district with a boundaryShort Plus Code with no district declared. If a district was declared but could not be used, the note is the district’s
latitude and longitude go togetherOnly one of the two
coordinates out of rangeOut of range, not finite, or 0, 0

The point check

NoteCause
the point is in X (code), not in Y (code)The point falls more than 500 m from the declared district
the point is outside CC, not in Y (code)The point falls outside the country
could not check geofences for the pointThe search for the geofence that contains the point failed
the GPS database is not configuredThe geofence could not be created

The provider

Notes that start with geocoding: mean that the provider was not called, or that the call failed.

NoteCauseWho fixes it
geocoding: the organization has no geocoding planThe quotas apply and the organization has no subscriptionPlatform owner: Platform › Geocoding › Organizations
geocoding: the organization used its N geocoding resolutions for this monthQuota used up with Send to reviewPlatform owner, or wait for the next month (UTC)
geocoding: this organization has no geocoding connection; a platform owner adds it in Settings › ConnectionsThe organization does not have the geocoding connectionPlatform owner: the organization’s Connections
geocoding: this organization's geocoding connection is not managed by the platformThe organization has its own geocoding connectionPlatform owner: replace it with the managed one
geocoding: this organization's geocoding connection cannot be readError reading the connectionSupport
geocoding: the platform has no geocoding providerThe platform has no providerPlatform owner: Connections, Platform scope
geocoding: unknown geocoding provider Xprovider is not mapbox or googlePlatform owner
geocoding: the geocoding connection's credential has no tokenThe credential has no tokenPlatform owner: Credentials
geocoding: the geocoding connection's costPerRequestUsd is not a numberCost written wrong in the connectionPlatform owner
geocoding: the geocoding connection must use https://api.mapbox.comThe connection URL is not the provider’sPlatform owner
geocoding: Mapbox answered HTTP 401 (or another code)The provider rejected the callPlatform owner: check the token
geocoding: Google answered REQUEST_DENIED (or another status), geocoding: Google answered HTTP 403Google rejected the callPlatform owner
geocoding: The geocoding provider did not answer: …Timeout or network errorRetry later
geocoding: interruptedThe call was interruptedRetry
geocoding: no organization to geocode forInternal call without an organizationSupport
geocoding results cannot be stored with this provider configurationGoogle, or Mapbox without permanent modePlatform owner: use Mapbox with permanent mode
mapbox found nothing, not an addressThe provider returned no resultsPlace it by hand
mapbox found only street, not an addressThe best result is a street (or place, postcode, …)Place it by hand, or correct the address and send a point
mapbox found only a coarser place, not an addressThe result has no typePlace it by hand

With Google, the note starts with google instead of mapbox. Every call the provider answered is charged, even if the place needs review.

Rejection

A location in rejected has in resolutionNote the note written by the person who rejected it.

Last updated on