{"id":3154,"date":"2023-12-22T18:07:02","date_gmt":"2023-12-22T18:07:02","guid":{"rendered":"https:\/\/developers.maplink.global\/?p=3154"},"modified":"2025-08-01T12:59:09","modified_gmt":"2025-08-01T12:59:09","slug":"suggestions-api","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/suggestions-api\/","title":{"rendered":"Suggestions API"},"content":{"rendered":"\n<p>El prop\u00f3sito de este tercer endpoint, Suggestions, es <strong>devolver coordenadas geogr\u00e1ficas desde una direcci\u00f3n proporcionada en la propia URL.<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"#parametros\">Lista de par\u00e1metros<\/a><\/li>\n\n\n\n<li><a href=\"#exemplo1\" data-type=\"internal\" data-id=\"#exemplo1\">Ejemplo 1 &#8211; B\u00fasqueda de sugerencias basadas en texto libre<\/a><\/li>\n\n\n\n<li><a href=\"#response\" data-type=\"internal\" data-id=\"#response\">Respuesta<\/a><\/li>\n<\/ul>\n\n\n\n<p>Para realizar una solicitud a Suggestions API es necesario enviar la solicitud mediante el m\u00e9todo GET al siguiente endpoint:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/geocode\/v1\/suggestions\">https:\/\/api.maplink.global\/geocode\/v2\/suggestions<\/a> &#8211; <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\">GET<\/mark><\/strong><\/li>\n<\/ul>\n\n\n\n<p>Todos los par\u00e1metros para obtener las coordenadas geogr\u00e1ficas y sugerencias de direcciones se enviar\u00e1n en la propia URL.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Nota:&nbsp;<\/strong>Actualmente regresa solo a direcciones ubicadas en Brasil.<\/p>\n<\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<p><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>La Suggestions API se actualiz\u00f3 a la versi\u00f3n 2. El endpoint&nbsp;<a href=\"https:\/\/api.maplink.global\/geocode\/v1\/suggestions\">https:\/\/api.maplink.global\/geocode\/v1\/suggestions<\/a>&nbsp;continuar\u00e1 funcionando, pero se recomienda utilizar el nuevo endpoint&nbsp; para obtener una mayor precisi\u00f3n de los resultados y porque las nuevas funciones ser\u00e1n exclusivas de la nueva versi\u00f3n.<\/p>\n<\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"parametros\"><strong>Lista de par\u00e1metros<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e2metro obrigat\u00f3rio<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>q<\/code> &#8211; Introduzca la direcci\u00f3n, o parte de ella.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e1metros opcionales<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>center<\/code> &#8211; Coordenadas de referencia para los resultados de la b\u00fasqueda. Formato: <code>center=-23.552088765,-46.6341653162<\/code>;<\/li>\n\n\n\n<li><code>radius<\/code> &#8211; Especifica el radio de b\u00fasqueda, en metros, desde el punto central definido en el centro. Si no se informa, el valor por defecto es 500.000 metros (500 km);<\/li>\n\n\n\n<li><code>limit<\/code>&nbsp;&#8211; Limita el n\u00famero de resultados devueltos. Por ejemplo:&nbsp;<a href=\"https:\/\/api.maplink.global\/geocode\/v2\/geocode?limit=1\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.maplink.global\/geocode\/v2\/suggestions?limit=1<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"exemplo1\"><strong>Ejemplo 1 &#8211; B\u00fasqueda de sugerencias basadas en texto libre<\/strong><\/h2>\n\n\n\n<p>En este ejemplo, queremos recibir sugerencias para el texto <code>\"Alameda Campinas, 01404100, Jardim Paulista\"<\/code>. La solicitud est\u00e1 a continuaci\u00f3n:<\/p>\n\n\n\n<p><a href=\"https:\/\/api.maplink.global\/geocode\/v2\/suggestions?q=Alameda%20Campinas,%2001404100,%20Jardim%20Paulista\">https:\/\/api.maplink.global\/geocode\/v2\/suggestions?q=Alameda%20Campinas,%2001404100,%20Jardim%20Paulista<\/a><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><\/p>\n<cite><strong>Nota:<\/strong> Se recomienda describir la direcci\u00f3n con mayor cantidad de informaci\u00f3n, ordenando los elementos m\u00e1s importantes (Calle, N\u00famero, C\u00f3digo Postal, Barrio, Ciudad, Estado) y sin abreviaturas para mayor asertividad de los resultados.<\/cite><\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"response\">Respuesta<\/h2>\n\n\n\n<p>La descripci\u00f3n de cada campo presente en la respuesta se puede encontrar en el siguiente enlace:&nbsp;<a href=\"https:\/\/developers.maplink.global\/es\/estructura-de-respuesta-geocode-api\/\">Estructura de respuesta \u2013 Geocode API<\/a>.<\/p>\n\n\n\n<p>La respuesta completa se puede ver a continuaci\u00f3n:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n    \"results\": [\n        {\n            \"id\": \"6684353bf0662a1541ff6385\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404100\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56631144908,\n                    \"lon\": -46.65360036597\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404100, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 85.4569607121604,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff635d\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404000\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.5663551335,\n                    \"lon\": -46.65364273168\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404000, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 67.52274411065238,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff63a2\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404200\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56714829171,\n                    \"lon\": -46.65440337412\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404200, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 67.52274411065238,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff63a3\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS 150\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404900\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56343039334,\n                    \"lon\": -46.6507807755\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS 150, 01404900, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 63.99465714182172,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff637b\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404001\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56880844109,\n                    \"lon\": -46.65604091167\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404001, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 62.53203434603555,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff637c\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404003\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.5727482959,\n                    \"lon\": -46.65984093151\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404003, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 62.34913451331003,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff63b9\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404002\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.57150846699,\n                    \"lon\": -46.65863824537\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404002, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 62.34913451331003,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"66842f7b6969121fb9f0de4e\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"12947480\",\n                \"city\": \"ATIBAIA\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.141018593,\n                    \"lon\": -46.557696254\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 12947480, JARDIM PAULISTA, ATIBAIA, SP\",\n            \"score\": 60.303185326712466,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684353bf0662a1541ff635b\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS, 463\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404902\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56559742572,\n                    \"lon\": -46.6529043066\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 463, 01404902, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 58.19247901439667,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684343ef0662a1541f5003c\",\n            \"address\": {\n                \"road\": \"ALAMEDA SARUTAI\u00c1\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01403010\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.5689407,\n                    \"lon\": -46.6549067\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA SARUTAI\u00c1, 01403010, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 55.375542129789075,\n            \"precision\": \"ROAD_CENTROID\"\n        }\n    ],\n    \"found\": 10\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>El prop\u00f3sito de este tercer endpoint, Suggestions, es devolver coordenadas geogr\u00e1ficas desde una direcci\u00f3n proporcionada en la propia URL. Para realizar una solicitud a Suggestions API es necesario enviar la solicitud mediante el m\u00e9todo GET al siguiente endpoint:&nbsp; Todos los par\u00e1metros para obtener las coordenadas geogr\u00e1ficas y sugerencias de direcciones se enviar\u00e1n en la propia [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[155],"tags":[],"class_list":["post-3154","post","type-post","status-publish","format-standard","hentry","category-geocode-es"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/3154","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=3154"}],"version-history":[{"count":8,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/3154\/revisions"}],"predecessor-version":[{"id":3474,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/3154\/revisions\/3474"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=3154"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=3154"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=3154"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}