Primeros pasos Geocoder API

La Geocoder API es un servicio que proporciona geocodificación convencional.

La geocodificación es el proceso que convierte direcciones (como "Prolongación Arenales 456, San Isidro, Lima") en coordenadas geográficas (como latitud -12.104418229714243 y longitud -77.03260748514282) que puedes usar para disponer marcadores en un mapa o posicionar el mapa.


Ejemplo de Solicitud y respuesta

Se puede acceder a través de HTTP, A continuación, se muestran ejemplos de las solicitudes y sus respuestas

Solicitud y respuesta de geocodificación (búsqueda de latitud y longitud)

En el siguiente ejemplo se solicita la latitud y longitud de “Joaquin Madrid N° 200” con ubigeo “150130”.
Para poder ubicar un listado de ubigeos se puede consultar listado de ubigeos

https://api.geodir.co/geocoder/geocoding/v1/geodir.address/simple?address=Joaquin Madrid N° 200&ubigeo=150130&token=YOUR_TOKEN

Se puede probar esto ingresando la URL en tu navegador web (reemplazando YOUR_TOKEN por tu clave real).

Se obtendrá una respuesta similar a esta:

Consulta la guía del desarrollador para obtener más información sobre la creación de url para la geocodificacion, los parámetros y la forma de la respuesta.
A continuación, se muestra un ejemplo de respuesta en formato JSON.

                                                            
    {
      "attribution": "http://geocoder.geodir.co/geocoder/home",
      "status": "OK",
      "version": "1.0",
      "address": [
        {
          "id": "geocoder.id_1",
          "status": "OK",
          "bbox": [
            -76.999574933,
            -12.1070467399999,
            -76.999574933,
            -12.1070467399999
          ],
          "type": "FeatureCollection",
          "geocoding": {
            "timestamp": 1510871998201,
            "query": {
              "text": "Av. Joaquin Madrid N° 200",
              "tokens": [
                "Av.","Joaquin","Madrid","N°","200"
              ],
              "size": 5,
              "lat": 0,
              "lon": 0
            }
          },
          "results": [
            {
              "id": 1,
              "id_str": "1",
              "geometry": {
                "type": "Point",
                "coordinates": [
                  -76.999574933,
                  -12.1070467399999
                ]
              },
              "center": [
                -76.999574933,
                -12.1070467399999
              ],
              "bbox": [
                -76.99967493300001,
                -12.1071467399999,
                -76.999474933,
                -12.1069467399999
              ],
              "type": "Feature",
              "nivelGeo": "NIVEL_PUERTA",
              "properties": {
                "region": "Peru",
                "label": "AV JOAQUIN MADRID N° 200",
                "direccion": "Av. Joaquin Madrid N° 200",
                "wayType": "AV",
                "way": "JOAQUIN MADRID",
                "block": 2,
                "number": 200,
                "nucleoType": null,
                "nucleo": null,
                "manzana": null
              }
            }
          ]
        }
      ],
      "comment": "El proceso demoro: 31 milliseconds  (0 seconds ) en procesar"
    }
                                                            
                                                        


Autenticación, cuotas

Para usar Geocoder API, primero debes registrarte y solicitar token.
Haz click en el botón y realiza el siguiente proceso:

OBTENER TOKEN

1. Registrate

2. Verificar el token generado

Cuotas

Consulte la pagina para revisar los límites de uso (asociar a la página de geocoder con la lista de precios) para obtener información sobre las cuotas para Geocoder API.