{"id":3455,"date":"2023-12-22T18:27:00","date_gmt":"2023-12-22T18:27:00","guid":{"rendered":"https:\/\/developers.maplink.global\/?p=3455"},"modified":"2025-08-01T12:37:33","modified_gmt":"2025-08-01T12:37:33","slug":"estructura-de-respuesta-geocode-api","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/estructura-de-respuesta-geocode-api\/","title":{"rendered":"Estructura de respuesta \u2013 Geocode API"},"content":{"rendered":"\n<p>Para todos los <em>endpoints<\/em>, <a href=\"https:\/\/developers.maplink.global\/es\/geocode-api\/\" data-type=\"post\" data-id=\"3134\">Geocode<\/a>,\u00a0<a href=\"https:\/\/developers.maplink.global\/es\/suggestions-api\/\" data-type=\"post\" data-id=\"3154\">Suggestions<\/a>,\u00a0<a href=\"https:\/\/developers.maplink.global\/es\/reverse-geocode-api\/\" data-type=\"post\" data-id=\"3149\">Reverse<\/a>\u00a0y\u00a0<a href=\"https:\/\/developers.maplink.global\/es\/multi-geocode-api\/\" data-type=\"post\" data-id=\"2316\">Multi Geocode<\/a>, el formato de respuesta seguir\u00e1 la estructura a continuaci\u00f3n:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>found<\/code>&nbsp;\u2013 N\u00famero de registros devueltos;<\/li>\n\n\n\n<li><code>results<\/code>&nbsp;\u2013 Array de objetos con todos los resultados encontrados:\n<ul class=\"wp-block-list\">\n<li><code>id<\/code>&nbsp;\u2013 Identificador de la direcci\u00f3n proporcionada en la solicitud;<\/li>\n\n\n\n<li><code>address<\/code>&nbsp;\u2013 Objeto con informaci\u00f3n de direcci\u00f3n:\n<ul class=\"wp-block-list\">\n<li><code>road<\/code>&nbsp;\u2013 Nombre de la carretera;<\/li>\n\n\n\n<li><code>number<\/code>&nbsp;\u2013 N\u00famero de direcci\u00f3n en formato de&nbsp;<em>string<\/em>;<\/li>\n\n\n\n<li><code>district<\/code>&nbsp;\u2013 Bairro;<\/li>\n\n\n\n<li><code>zipCode<\/code>&nbsp;\u2013 C\u00f3digo postal;<\/li>\n\n\n\n<li><code>city<\/code>&nbsp;\u2013 Ciudad;<\/li>\n\n\n\n<li><code>state<\/code>&nbsp;\u2013 Objeto con datos del estado:\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>&nbsp;\u2013 Nombre del estado;<\/li>\n\n\n\n<li><code>code<\/code>&nbsp;\u2013 Acr\u00f3nimo del estado;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>mainLocation<\/code>&nbsp;\u2013 Objeto con las coordenadas geogr\u00e1ficas del punto:\n<ul class=\"wp-block-list\">\n<li><code>lat<\/code>&nbsp;\u2013 Latitud;<\/li>\n\n\n\n<li><code>lon<\/code>&nbsp;\u2013 Longitud;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>numberAsInteger<\/code>&nbsp;\u2013 N\u00famero de direcci\u00f3n, pero devuelto como un n\u00famero entero en lugar de una&nbsp;<em>string<\/em>;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>type<\/code>&nbsp;\u2013 Indica el tipo de datos devueltos. Los valores posibles son:&nbsp;<code>ROAD<\/code>,&nbsp;<code>CITY<\/code>&nbsp;y&nbsp;<code>STATE<\/code>;<\/li>\n\n\n\n<li><code>precision<\/code>&nbsp;\u2013 Indica el grado de confianza de los datos devueltos. Los valores posibles son:\n<ul class=\"wp-block-list\">\n<li><code>NUMBER_EXACT<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al punto exacto solicitado.;<\/li>\n\n\n\n<li><code>NUMBER_HIGH_PRECISION<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al punto solicitado, pero no disponemos de la ubicaci\u00f3n exacta y que las coordenadas fueron interpoladas, con un margen de hasta 20 metros.;<\/li>\n\n\n\n<li><code>NUMBER_MEDIUM_PRECISION<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al punto solicitado, pero no disponemos de la ubicaci\u00f3n exacta y que las coordenadas fueron interpoladas, con un margen de hasta 100 metros;<\/li>\n\n\n\n<li><code>NUMBER_LOW_PRECISION<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al punto solicitado, pero no disponemos de la ubicaci\u00f3n exacta y que las coordenadas fueron interpoladas, con un margen de hasta 1000 metros;<\/li>\n\n\n\n<li><code>ROAD_CENTROID<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al centroide de la calle solicitada;<\/li>\n\n\n\n<li><code>CITY_CENTROID<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al centroide de la ciudad;<\/li>\n\n\n\n<li><code>STATE_CENTROID<\/code>&nbsp;\u2013 Indica que las coordenadas devueltas se refieren al centroide del estado.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>score<\/code>&nbsp;\u2013 Puntuaci\u00f3n num\u00e9rica que representa el grado de correspondencia textual entre la direcci\u00f3n proporcionada en la solicitud y la direcci\u00f3n devuelta por el proceso de geocodificaci\u00f3n;<\/li>\n\n\n\n<li><code>label<\/code>&nbsp;\u2013 Direcci\u00f3n completa encontrada utilizada en el proceso de geocodificaci\u00f3n.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Ejemplo de 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\": \"6684353bf0662a1541ff635d\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"number\": \"579\",\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.566287789653508,\n                    \"lon\": -46.6537028592172\n                },\n                \"numberAsInteger\": 579\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404000, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 98.81773828023887,\n            \"precision\": \"NUMBER_MEDIUM_PRECISION\"\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\": 92.9419580012093,\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\": 92.9419580012093,\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\": 92.9419580012093,\n            \"precision\": \"ROAD_CENTROID\"\n        },\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\": 92.78814049548771,\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\": 92.78814049548771,\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\": 91.48049238291864,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684344df0662a1541f5baee\",\n            \"address\": {\n                \"road\": \"RUA HAITI\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404010\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.571433,\n                    \"lon\": -46.6607828\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"RUA HAITI, 01404010, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 84.24055564325018,\n            \"precision\": \"ROAD_CENTROID\"\n        },\n        {\n            \"id\": \"6684342ef0662a1541f41a70\",\n            \"address\": {\n                \"road\": \"ALAMEDA LORENA\",\n                \"number\": \"579\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01424000\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56994038386821,\n                    \"lon\": -46.65933806789288\n                },\n                \"numberAsInteger\": 579\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA LORENA, 01424000, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 84.15016434701576,\n            \"precision\": \"NUMBER_MEDIUM_PRECISION\"\n        },\n        {\n            \"id\": \"66843453f0662a1541f60988\",\n            \"address\": {\n                \"road\": \"ALAMEDA CASA BRANCA\",\n                \"number\": \"579\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01408000\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.565856915927288,\n                    \"lon\": -46.659742464053295\n                },\n                \"numberAsInteger\": 579\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CASA BRANCA, 01408000, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 84.01280084636662,\n            \"precision\": \"NUMBER_MEDIUM_PRECISION\"\n        }\n    ],\n    \"found\": 10\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Para todos los endpoints, Geocode,\u00a0Suggestions,\u00a0Reverse\u00a0y\u00a0Multi Geocode, el formato de respuesta seguir\u00e1 la estructura a continuaci\u00f3n: Ejemplo de respuesta completa:<\/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-3455","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\/3455","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=3455"}],"version-history":[{"count":3,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/3455\/revisions"}],"predecessor-version":[{"id":3460,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/3455\/revisions\/3460"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=3455"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=3455"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=3455"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}