reverse

Batch reverse geocode coordinates

Changed on
post/reverse

Request

  • Base URL
    https://api.geocod.io/v2
  • URL
    https://api.geocod.io/v2/reverse
  • Auth
    API key in query parameter api_key

Query parameters

fieldsstring[]

Comma-separated list of data append fields. See the enum for valid values.

destinations[]string[]

Array of destination locations for distance calculation

distance_mode'driving' | 'straightline'

Distance calculation mode

distance_units'miles' | 'km'

Unit of measurement for distance values

distance_max_resultsinteger

Maximum number of destinations to return per result

distance_max_distancenumber

Maximum distance filter (in specified units)

distance_max_durationinteger

Maximum duration filter in seconds

distance_min_distancenumber

Minimum distance filter (in specified units)

distance_min_durationinteger

Minimum duration filter in seconds

distance_order_by'distance' | 'duration'

Field to sort destinations by

distance_sort_order'asc' | 'desc'

Sort order for destinations

skipGeocodingstring

When set, skips reverse geocoding and applies field appends directly to the coordinates. Requires the fields parameter.

limitinteger

Maximum number of results per coordinate

countrystring

Default country code applied to every query in the batch unless a query provides its own

Request body

string[] required

List of "lat,lng" strings

OR
object required

Coordinates keyed by custom identifier

Response

Successful response

Changes

    • info

      added the enum value au-census to the property items/ of the query request parameter fields

    • info

      added the enum value au-census2021 to the property items/ of the query request parameter fields

    • info

      added the enum value au-demographics to the property items/ of the query request parameter fields

    • info

      added the enum value au-federal-electorate to the property items/ of the query request parameter fields

    • info

      added the enum value au-federal-electorate-next to the property items/ of the query request parameter fields

    • info

      added the enum value au-housing to the property items/ of the query request parameter fields

    • info

      added the enum value au-income to the property items/ of the query request parameter fields

    • info

      added the enum value au-state-electorate to the property items/ of the query request parameter fields

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the enum value gazetteer to the property items/ of the query request parameter fields

    • info

      added the optional property ////// to the response with the status