Suggestions API
El propósito de este tercer endpoint, Suggestions, es devolver coordenadas geográficas desde una dirección proporcionada en la propia URL.
Para realizar una solicitud a Suggestions API es necesario enviar la solicitud mediante el método GET al siguiente endpoint:
Todos los parámetros para obtener las coordenadas geográficas y sugerencias de direcciones se enviarán en la propia URL.
Nota: Actualmente regresa solo a direcciones ubicadas en Brasil.
La Suggestions API se actualizó a la versión 2. El endpoint https://api.maplink.global/geocode/v1/suggestions continuará funcionando, pero se recomienda utilizar el nuevo endpoint para obtener una mayor precisión de los resultados y porque las nuevas funciones serán exclusivas de la nueva versión.
Lista de parámetros
Parâmetro obrigatório
q
– Introduzca la dirección, o parte de ella.
Parámetros opcionales
center
– Coordenadas de referencia para los resultados de la búsqueda. Formato:center=-23.552088765,-46.6341653162
;radius
– Especifica el radio de búsqueda, en metros, desde el punto central definido en el centro. Si no se informa, el valor por defecto es 500.000 metros (500 km);limit
– Limita el número de resultados devueltos. Por ejemplo: https://api.maplink.global/geocode/v2/suggestions?limit=1
Ejemplo 1 – Búsqueda de sugerencias basadas en texto libre
En este ejemplo, queremos recibir sugerencias para el texto "Alameda Campinas, 01404100, Jardim Paulista"
. La solicitud está a continuación:
Nota: Se recomienda describir la dirección con mayor cantidad de información, ordenando los elementos más importantes (Calle, Número, Código Postal, Barrio, Ciudad, Estado) y sin abreviaturas para mayor asertividad de los resultados.
Respuesta
La descripción de cada campo presente en la respuesta se puede encontrar en el siguiente enlace: Estructura de respuesta – Geocode API.
La respuesta completa se puede ver a continuación:
{ "results": [ { "id": "6684353bf0662a1541ff6385", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404100", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.56631144908, "lon": -46.65360036597 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404100, JARDIM PAULISTA, SÃO PAULO, SP", "score": 85.4569607121604, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff635d", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404000", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.5663551335, "lon": -46.65364273168 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404000, JARDIM PAULISTA, SÃO PAULO, SP", "score": 67.52274411065238, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff63a2", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404200", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.56714829171, "lon": -46.65440337412 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404200, JARDIM PAULISTA, SÃO PAULO, SP", "score": 67.52274411065238, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff63a3", "address": { "road": "ALAMEDA CAMPINAS 150", "district": "JARDIM PAULISTA", "zipCode": "01404900", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.56343039334, "lon": -46.6507807755 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS 150, 01404900, JARDIM PAULISTA, SÃO PAULO, SP", "score": 63.99465714182172, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff637b", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404001", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.56880844109, "lon": -46.65604091167 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404001, JARDIM PAULISTA, SÃO PAULO, SP", "score": 62.53203434603555, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff637c", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404003", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.5727482959, "lon": -46.65984093151 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404003, JARDIM PAULISTA, SÃO PAULO, SP", "score": 62.34913451331003, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff63b9", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "01404002", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.57150846699, "lon": -46.65863824537 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 01404002, JARDIM PAULISTA, SÃO PAULO, SP", "score": 62.34913451331003, "precision": "ROAD_CENTROID" }, { "id": "66842f7b6969121fb9f0de4e", "address": { "road": "ALAMEDA CAMPINAS", "district": "JARDIM PAULISTA", "zipCode": "12947480", "city": "ATIBAIA", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.141018593, "lon": -46.557696254 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 12947480, JARDIM PAULISTA, ATIBAIA, SP", "score": 60.303185326712466, "precision": "ROAD_CENTROID" }, { "id": "6684353bf0662a1541ff635b", "address": { "road": "ALAMEDA CAMPINAS, 463", "district": "JARDIM PAULISTA", "zipCode": "01404902", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.56559742572, "lon": -46.6529043066 } }, "type": "ROAD", "label": "ALAMEDA CAMPINAS, 463, 01404902, JARDIM PAULISTA, SÃO PAULO, SP", "score": 58.19247901439667, "precision": "ROAD_CENTROID" }, { "id": "6684343ef0662a1541f5003c", "address": { "road": "ALAMEDA SARUTAIÁ", "district": "JARDIM PAULISTA", "zipCode": "01403010", "city": "SÃO PAULO", "state": { "name": "SÃO PAULO", "code": "SP" }, "mainLocation": { "lat": -23.5689407, "lon": -46.6549067 } }, "type": "ROAD", "label": "ALAMEDA SARUTAIÁ, 01403010, JARDIM PAULISTA, SÃO PAULO, SP", "score": 55.375542129789075, "precision": "ROAD_CENTROID" } ], "found": 10 }