Reverse Geocoding

El término codificación geográfica generalmente se refiere a traducir una dirección legible por humanos en una ubicación en un mapa. El proceso de hacer lo contrario, traducir una ubicación en el mapa en una dirección legible por humanos, se conoce como codificación geográfica inversa.

Parámetros obligatorios en una solicitud de Reverse Geocoding:

• latlon: los valores de latitud y longitud que especifican la ubicación para la que desea obtener la dirección más cercana legible por humanos.
• key: la clave API de su aplicación. Esta clave identifica su aplicación a los efectos de la gestión de cuotas. Aprenda a obtener la clave API.

Ejemplo de Reverse Geocoding

La siguiente consulta contiene el valor de latitud / longitud para una ubicación en Breña:

https://apis.geodir.co/geocoding/v1/json?latlon=-12.05,-77.05&key=YOUR_KEY

Nota: Asegúrese de que no exista ningún espacio entre los valores de latitud y longitud cuando se pasa en el parámetro latlon.

{
    "status": "OK",
    "results": [
        {
            "result_types": [
                "address"
            ],
            "address_segments": [
                {
                    "name": "721",
                    "name_abbr": "721",
                    "types": [
                        "route_number"
                    ]
                },
                {
                    "name": "Pomabamba",
                    "name_abbr": "Pomabamba",
                    "types": [
                        "route"
                    ]
                },
                {
                    "name": "Jirón",
                    "name_abbr": "Jr",
                    "types": [
                        "route_type"
                    ]
                },
                {
                    "name": "Lima",
                    "name_abbr": "Lima",
                    "types": [
                        "admin_level_1",
                        "political"
                    ]
                },
                {
                    "name": "15",
                    "name_abbr": "15",
                    "types": [
                        "admin_level_1_code",
                        "political"
                    ]
                },
                {
                    "name": "Lima",
                    "name_abbr": "Lima",
                    "types": [
                        "admin_level_2",
                        "political"
                    ]
                },
                {
                    "name": "1501",
                    "name_abbr": "1501",
                    "types": [
                        "admin_level_2_code",
                        "political"
                    ]
                },
                {
                    "name": "Breña",
                    "name_abbr": "Breña",
                    "types": [
                        "admin_level_3",
                        "political"
                    ]
                },
                {
                    "name": "150105",
                    "name_abbr": "150105",
                    "types": [
                        "admin_level_3_code",
                        "political"
                    ]
                },
                {
                    "name": "Chacra Colorada",
                    "name_abbr": "Chacra Colorada",
                    "types": [
                        "sublocality",
                        "political"
                    ]
                },
                {
                    "name": "Perú",
                    "name_abbr": "PE",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "name": "15082",
                    "name_abbr": "15082",
                    "types": [
                        "postal_code"
                    ]
                }
            ],
            "geometry": {
                "coordinates": {
                    "lat": -12.0499011,
                    "lon": -77.049985
                },
                "bbox": [
                    -77.049985,
                    -12.0499011,
                    -77.049985,
                    -12.0499011
                ],
                "geocoding_type": "DOOR"
            },
            "place_id": "ZTI0NjQxOWQtNWZhMC01YzRiLTkwZjktOTIyMjI0OGRhN2Zh",
            "standard_address": "Jirón Pomabamba 721, Breña, Lima, Lima, Perú"
        }
    ]
}

Respuestas de Reverse Geocoding

El formato de la respuesta de codificación geográfica inversa es el mismo que el de la respuesta de Geocoding. Consulte Respuestas de Geocoding. A continuación se muestran los códigos de estado posibles en una respuesta de Reverse Geocoding.

Códigos de Estado de Reverse Geocoding

El campo "status" dentro del objeto de respuesta de Geocoding contiene el estado de la solicitud y puede contener información de depuración para ayudarlo a averiguar por qué la codificación geográfica no funciona. El campo "status" puede contener los siguientes valores:

• "OK" indica que no se produjeron errores; la dirección se analizó correctamente y se devolvió al menos un código geográfico.
• "ZERO_RESULTS" indica que el código geográfico se realizó correctamente pero no arrojó resultados. Esto puede ocurrir si al geocodificador se le pasó un address inexistente.
• "OVER_QUERY_LIMIT" indica que ha superado su cuota.
• "REQUEST_DENIED" indica que su solicitud fue denegada.
• "INVALID_REQUEST" generalmente indica uno de los siguientes:
  • Falta la consulta (address, segments o latlon).
  • Se proporcionó un segments o geocoding_type no válido.
• "UNKNOWN_ERROR" indica que la solicitud no se pudo procesar debido a un error del servidor. La solicitud puede tener éxito si vuelve a intentarlo.

Dirección de un Lugar

Parámetros requeridos:

• place_id: el ID de Place para el que desea obtener la dirección legible por humanos. El ID de Place es un identificador único que se puede utilizar con otras APIs de Geodir. Para obtener más información sobre los IDs de Place, consulte ID de Place.
• key: la clave API de su aplicación. Esta clave identifica su aplicación a los efectos de la gestión de cuotas. Aprenda a obtener su clave API.

Los parámetros opcionales son los mismos que los de Reverse Geocoding.