{"id":4381,"date":"2026-11-12T19:25:44","date_gmt":"2026-11-12T19:25:44","guid":{"rendered":"https:\/\/developers.maplink.global\/?p=4381"},"modified":"2026-11-12T20:02:33","modified_gmt":"2026-11-12T20:02:33","slug":"lista-de-parametros","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/lista-de-parametros\/","title":{"rendered":"Lista de par\u00e1metros"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>Formatos de env\u00edo de la direcci\u00f3n<\/li>\n\n\n\n<li>Par\u00e1metros obligatorios<\/li>\n\n\n\n<li>Par\u00e1metros opcionales<\/li>\n\n\n\n<li>Ejemplos de solicitud<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Formatos de env\u00edo de la direcci\u00f3n<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">La direcci\u00f3n puede enviarse de dos formas:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Label<\/strong> \u2013 Texto \u00fanico con los componentes de la direcci\u00f3n separados por comas, en el orden <code>road<\/code>, <code>number<\/code>, <code>district<\/code>, <code>zipcode<\/code>, <code>city<\/code>, <code>state<\/code>;<\/li>\n\n\n\n<li><strong>Estructurado<\/strong> \u2013 Cada componente de la direcci\u00f3n informado en un par\u00e1metro separado.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Los dos formatos pueden enviarse en la misma solicitud. En ese caso, los par\u00e1metros estructurados tienen prioridad y el <code>label<\/code> se ignora:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>Par\u00e1metros presentes en el body<\/th><th>Formato considerado<\/th><\/tr><tr><td>Solo <code>label<\/code><\/td><td>Label<\/td><\/tr><tr><td>Par\u00e1metros estructurados, sin <code>label<\/code><\/td><td>Estructurado<\/td><\/tr><tr><td><code>label<\/code> + par\u00e1metros estructurados<\/td><td>Estructurado (el <code>label<\/code> se ignora)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Tabla con el formato considerado seg\u00fan los par\u00e1metros enviados<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Par\u00e1metros obligatorios<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Los par\u00e1metros obligatorios dependen del formato de env\u00edo de la direcci\u00f3n.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Formato estructurado<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>road<\/code> \u2013 Texto con la calle. Puede contener el n\u00famero y el complemento, que se separan en la respuesta. L\u00edmite de 150 caracteres;<\/li>\n\n\n\n<li><code>zipcode<\/code> \u2013 Texto con el c\u00f3digo postal (CEP) de la direcci\u00f3n. Acepta el CEP con o sin gui\u00f3n (ejemplo: <code>01310-200<\/code> o <code>01310200<\/code>). Despu\u00e9s de quitar el gui\u00f3n, debe tener exactamente 8 d\u00edgitos;<\/li>\n\n\n\n<li><code>city<\/code> \u2013 Texto con el nombre del municipio.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Formato label<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>label<\/code> \u2013 Texto con la direcci\u00f3n completa, con los componentes separados por comas en el orden <code>road, number, district, zipcode, city, state<\/code>. La calle, el CEP y el municipio deben estar completos en el <code>label<\/code>.\n<ul class=\"wp-block-list\">\n<li>Las cinco comas de separaci\u00f3n deben estar presentes, incluso cuando alg\u00fan componente est\u00e9 vac\u00edo. Ejemplo: <code>\"av paulista,1578,,01310200,sao paulo,\"<\/code>;<\/li>\n\n\n\n<li>Si falta alguna coma, se devolver\u00e1 el error <code>Structure error on label field<\/code>. Esta validaci\u00f3n se aplica antes de la validaci\u00f3n del formato del CEP.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Nota:<\/strong> las solicitudes sin <code>road<\/code>, sin <code>zipcode <\/code>o <code>city <\/code>se rechazan con el error 400.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\">Par\u00e1metros opcionales<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>number<\/code> \u2013 Texto con el n\u00famero del inmueble. Puede enviarse vac\u00edo o contener un complemento despu\u00e9s del n\u00famero (ejemplo: <code>\"654 bloco 3\"<\/code>); en ese caso, el texto despu\u00e9s del n\u00famero se devuelve en <code>complement<\/code>. Si no se informa, el n\u00famero se identifica en el <code>road<\/code>;<\/li>\n\n\n\n<li><code>district<\/code> \u2013 Texto con el nombre del barrio;<\/li>\n\n\n\n<li><code>state<\/code> \u2013 Texto con la sigla del estado (UF).<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplos de solicitud<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Ejemplo con el formato label<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"label\": \"r da cantarera 306 box 12,,centro,01024-000,sao paulo,SP\"\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Ejemplo con el formato estructurado<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"road\": \"r da cantarera 306 box 12\",\n  \"number\": \"\",\n  \"zipcode\": \"01024-000\",\n  \"district\": \"centro\",\n  \"city\": \"sao paulo\",\n  \"state\": \"SP\"\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Ejemplo con label y par\u00e1metros estructurados<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">En este caso, solo se consideran los par\u00e1metros estructurados:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"label\": \"r da cantarera 306 box 12,,centro,01024-000,sao paulo,SP\",\n  \"road\": \"r da cantarera 306 box 12\",\n  \"number\": \"\",\n  \"zipcode\": \"01024-000\",\n  \"district\": \"centro\",\n  \"city\": \"sao paulo\",\n  \"state\": \"SP\"\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Formatos de env\u00edo de la direcci\u00f3n La direcci\u00f3n puede enviarse de dos formas: Los dos formatos pueden enviarse en la misma solicitud. En ese caso, los par\u00e1metros estructurados tienen prioridad y el label se ignora: Par\u00e1metros presentes en el body Formato considerado Solo label Label Par\u00e1metros estructurados, sin label Estructurado label + par\u00e1metros estructurados Estructurado [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[176,136],"tags":[],"class_list":["post-4381","post","type-post","status-publish","format-standard","hentry","category-address-analyzer-es","category-sin-categorizar"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4381","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\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=4381"}],"version-history":[{"count":5,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4381\/revisions"}],"predecessor-version":[{"id":4441,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4381\/revisions\/4441"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=4381"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=4381"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=4381"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}