{"id":2316,"date":"2023-12-22T18:25:35","date_gmt":"2023-12-22T18:25:35","guid":{"rendered":"https:\/\/developers.maplink.global\/multi-geocode-api\/"},"modified":"2025-08-01T13:57:58","modified_gmt":"2025-08-01T13:57:58","slug":"multi-geocode-api","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/multi-geocode-api\/","title":{"rendered":"Multi Geocode API"},"content":{"rendered":"\n<p>El objetivo de este \u00faltimo endpoint es <strong>devolver las coordenadas geogr\u00e1ficas de varias direcciones, ya sean completas o parciales<\/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\">Ejemplo 1 &#8211; B\u00fasqueda de las coordenadas de dos o m\u00e1s direcciones en la misma solicitud<\/a><\/li>\n\n\n\n<li><a href=\"#response\">Respuesta<\/a><\/li>\n<\/ul>\n\n\n\n<p>Para realizar la solicitud a Multi Geocode es necesario enviar la solicitud utilizando el m\u00e9todo <strong>POST <\/strong>al siguiente endpoint:  <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/geocode\/v2\/multi-geocode\">https:\/\/api.maplink.global\/geocode\/v2\/multi-geocode<\/a> &#8211; <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-luminous-vivid-amber-color\">POST <\/mark><\/strong><\/li>\n<\/ul>\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\u00e1metros obligatorios<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>id<\/code>  &#8211; Texto con el identificador de la direcci\u00f3n buscada.<\/li>\n<\/ul>\n\n\n\n<p>Debe introducirse al menos uno de los siguientes par\u00e1metros. No es necesario informar a todo el mundo. No obstante, cuanta m\u00e1s informaci\u00f3n facilite, m\u00e1s preciso ser\u00e1 el resultado.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>road<\/code>  &#8211; Nombre de la calle o parte de ella;<\/li>\n\n\n\n<li><code>number<\/code>  &#8211; N\u00famero de la calle. NO introduzca los datos del complemento.<\/li>\n\n\n\n<li><code>city<\/code>  &#8211; Nombre de la ciudad;<\/li>\n\n\n\n<li><code>state<\/code>  &#8211; Estado;<\/li>\n\n\n\n<li><code>country<\/code>  &#8211; Pa\u00eds;<\/li>\n\n\n\n<li><code>district<\/code>  &#8211; Nombre del barrio;<\/li>\n\n\n\n<li><code>zipcode<\/code> &#8211; C\u00f3digo postal.<\/li>\n\n\n\n<li><code>label<\/code>&nbsp;\u2013 Direcci\u00f3n completa. Se recomienda armar el texto en el orden&nbsp;<strong>\u00abNombre de la calle, n\u00famero, c\u00f3digo postal, barrio, ciudad, estado\u00bb<\/strong>.<\/li>\n<\/ul>\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<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Nota<\/strong>: Hay un l\u00edmite de 200 puntos por enviar una misma solicitud.<\/p>\n<\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e2metros opcionais<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>mainLocation<\/code>&nbsp;\u2013 Objeto con dos par\u00e1metros para limitar el \u00e1rea de b\u00fasqueda de direcciones:\n<ul class=\"wp-block-list\">\n<li><code>center<\/code>&nbsp;\u2013 Objeto con coordenadas de referencia para resultados de b\u00fasqueda. Las coordenadas se pueden ingresar en los siguientes formatos:\n<ul class=\"wp-block-list\">\n<li>Objeto con las propiedades&nbsp;<code>lat<\/code>&nbsp;y&nbsp;<code>lon<\/code>&nbsp;que representan latitud y longitud respectivamente. Ejemplo:&nbsp;<code>{\"lat\":-23.0852,&nbsp;\"lon\": -46.98020}<\/code><\/li>\n\n\n\n<li>Array con latitud y longitud. Ejemplo:&nbsp;<code>[-23.0852,&nbsp; -46.98020]<\/code><\/li>\n\n\n\n<li>Coordenadas codificadas como&nbsp;<em>geohash<\/em>. Ejemplo:<strong>&nbsp;<\/strong><code>\"6tr6df675\"<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>radius<\/code>&nbsp;\u2013 Radio de b\u00fasqueda, en metros, desde el punto central definido en&nbsp;<code>center<\/code>. Si no se informa, el valor por defecto es 500.000 metros (500 km).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"exemplo1\"><strong>Ejemplo 1 &#8211; B\u00fasqueda de las coordenadas de dos o m\u00e1s direcciones en la misma solicitud<\/strong><\/h2>\n\n\n\n<p>En este ejemplo vamos a buscar dos direcciones diferentes en la misma petici\u00f3n. Para ello, debemos identificar cada direcci\u00f3n con el par\u00e1metro <code>id<\/code>.  <\/p>\n\n\n\n<p>El primero ser\u00e1 <code>\"Address1\"<\/code> y el segundo <code>\"Address2\"<\/code>. La solicitud completa puede verse 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    {\n        \"id\": \"Address1\",\n        \"road\": \"Leopoldo Hess\",\n        \"number\": 75,\n        \"district\": \"S\u00e3o Jo\u00e3o\",\n        \"zipcode\": \"88304-260\",\n        \"city\": \"Itajai\",\n        \"state\": \"SC\"\n    },\n    {\n        \"id\": \"Address2\",\n        \"road\": \"Alameda Campinas\",\n        \"number\": 579,\n        \"zipcode\": \"01419-001\",\n        \"city\": \"S\u00e3o Paulo\",\n        \"state\": \"SP\"\n    }\n]<\/pre>\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>A continuaci\u00f3n encontrar\u00e1 la respuesta completa:<\/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\": \"Address1\",\n            \"address\": {\n                \"road\": \"RUA LEOPOLDO HESS\",\n                \"number\": \"75\",\n                \"district\": \"S\u00c3O JO\u00c3O\",\n                \"zipCode\": \"88304260\",\n                \"city\": \"ITAJA\u00cd\",\n                \"state\": {\n                    \"name\": \"SANTA CATARINA\",\n                    \"code\": \"SC\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -26.903004,\n                    \"lon\": -48.680296\n                },\n                \"numberAsInteger\": 75\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"RUA LEOPOLDO HESS, 88304260, S\u00c3O JO\u00c3O, ITAJA\u00cd, SC\",\n            \"score\": 96.79654045442564,\n            \"precision\": \"NUMBER_EXACT\"\n        },\n        {\n            \"id\": \"Address2\",\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\": 96.91391938959099,\n            \"precision\": \"ROAD_CENTROID\"\n        }\n    ],\n    \"found\": 2\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>El objetivo de este \u00faltimo endpoint es devolver las coordenadas geogr\u00e1ficas de varias direcciones, ya sean completas o parciales. Para realizar la solicitud a Multi Geocode es necesario enviar la solicitud utilizando el m\u00e9todo POST al siguiente endpoint: Lista de par\u00e1metros Par\u00e1metros obligatorios Debe introducirse al menos uno de los siguientes par\u00e1metros. No es necesario [&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-2316","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\/2316","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=2316"}],"version-history":[{"count":17,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2316\/revisions"}],"predecessor-version":[{"id":3482,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2316\/revisions\/3482"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=2316"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=2316"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=2316"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}