Pinit

El servicio **TrueAddress AI** permite procesar direcciones escritas en texto libre para limpiarlas, descomponerlas en componentes estructurados y, de forma opcional, validarlas y geocodificarlas. Utiliza inteligencia artificial para mejorar la precisión en la estandarización de direcciones y facilita su uso en sistemas logísticos y de análisis geoespacial.
**Consideraciones adicionales:**
- El servicio está diseñado principalmente para direcciones en **México y Colombia**. - El parámetro `enable_validation` usa un catálogo interno de **códigos postales**. - La geocodificación puede usar **distintos proveedores** según umbral de confianza. - El campo `score` indica la **confianza del resultado** (entre 0 y 1). - Si `enable_validation` es `true`, la validación se usa internamente pero **no aparece en la respuesta**. - Para soporte o autenticación, **contacta al equipo técnico de Pinit**.


TrueAddress AI

Descripción general

Flujo básico de uso

Endpoint

Respuesta

Estatus de respuesta

Consideraciones adicionales

Preguntas frecuentes

Clusters Inteligentes

Autenticación

POST /clusters

GET /clusters/{uuid}

Recomendaciones para configurar el clustering

Archivos generados

Ejemplo de petición POST /clusters

Route Solver

POST /route-solver-service

Recomendaciones y buenas prácticas

Ejemplos de peticiones POST /route-solver-service

Default

servicios

Production

<p class="slate-p " >El servicio <span style="color:#9900FF"><strong class="slate-bold">TrueAddress AI</strong></span> permite procesar direcciones escritas en texto libre para limpiarlas, descomponerlas en componentes estructurados y, de forma opcional, validarlas y geocodificarlas. Utiliza inteligencia artificial para mejorar la precisión en la estandarización de direcciones y facilita su uso en sistemas logísticos y de análisis geoespacial.</p><p class="slate-p " ></p>

 permite procesar direcciones escritas en texto libre para limpiarlas, descomponerlas en componentes estructurados y, de forma opcional, validarlas y geocodificarlas. Utiliza inteligencia artificial para mejorar la precisión en la estandarización de direcciones y facilita su uso en sistemas logísticos y de análisis geoespacial.

<div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Paso 1: Prepara la dirección</h3><p class="slate-p " >Ingresa la dirección en texto libre tal como la tengas en tu sistema, incluyendo país, estado y ciudad cuando sea posible.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Paso 2: Envía la solicitud</h3><p class="slate-p " >Realiza un <code class="slate-code">POST</code> al endpoint <code class="slate-code">/true-address-ai</code> con los parámetros deseados.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Paso 3: Revisa tu respuesta</h3><p class="slate-p " >Analiza el campo <code class="slate-code">clean_address</code> y, si habilitaste <code class="slate-code">geocoding</code> puedes verificar las coordenadas y el <code class="slate-code">score</code> de precisión.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >4</h6><h3 class="slate-h3 " >Paso 4: Integra tu resultado</h3><p class="slate-p " >Utiliza los datos limpios y/o geocodificados en tus procesos logísticos, de análisis o almacenamiento.</p></div></div></div><p class="slate-p " ></p>

<p class="slate-p " ><strong class="slate-bold">POST</strong> <code class="slate-code">https://services.pinittms.com/true-address-ai</code></p><p class="slate-p " >Este endpoint permite procesar una dirección escrita en texto libre para:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Limpiarla y estandarizarla.</div></li><li class="slate-li " ><div style="position:relative">Validar los componentes administrativos (estado, municipio y colonia).</div></li><li class="slate-li " ><div style="position:relative">Obtener coordenadas geográficas (geocodificación).</div></li></ul><p class="slate-p " >Cada funcionalidad es opcional y puede activarse con los parámetros del cuerpo de la solicitud.</p>

https://services.pinittms.com/true-address-ai

Este endpoint permite procesar una dirección escrita en texto libre para:

Cada funcionalidad es opcional y puede activarse con los parámetros del cuerpo de la solicitud.

address

enable_validation

geocoding

Authorization

Content-Type

Componentes estructurados de la dirección procesada (puede variar según el país).

clean_address

Se incluye sólo si se solicita geocodificación (geocoding: true) y el servicio encuentra coordenadas.

Ejemplo de respuesta

<p class="slate-p " >La respuesta del servicio siempre devuelve un objeto JSON.</p><div class="slate-div"></div><p class="slate-p " ></p>

La respuesta del servicio siempre devuelve un objeto JSON.

<p class="slate-p " >A continuación se detallan los principales códigos HTTP que puede devolver el servicio, junto con ejemplos de las respuestas más comunes.</p><h2 class="slate-h2 " >200 OK</h2><p class="slate-p " >La solicitud se procesó correctamente. Existen dos variantes:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Sin geocodificación: Cuando <code class="slate-code">geocoding: false</code> o no se solicita geocodificación, solo se devuelve la dirección limpia.</div></li></ul><div class="code-block-wrapper"  style="width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line">{
  &quot;clean_address&quot;: {
    &quot;country&quot;: &quot;México&quot;,
    &quot;state&quot;: &quot;Ciudad de México&quot;,
    &quot;county&quot;: &quot;Cuauhtémoc&quot;,
    &quot;city&quot;: &quot;Ciudad de México&quot;,
    &quot;district&quot;: &quot;Centro&quot;,
    &quot;street&quot;: &quot;Tacuba&quot;,
    &quot;houseNumber&quot;: &quot;17&quot;,
    &quot;postalCode&quot;: &quot;06000&quot;,
    &quot;references&quot;: &quot;&quot;
  },
  &quot;geocoding&quot;: false
}</div></code></pre></div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Con geocodificación habilitada: Cuando <code class="slate-code">geocoding: true</code>, la respuesta incluye además las coordenadas y su nivel de confianza (<code class="slate-code">score</code>).</div></li></ul><div class="code-block-wrapper"  style="width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;clean_address&quot;: {
    &quot;country&quot;: &quot;México&quot;,
    &quot;state&quot;: &quot;Ciudad de México&quot;,
    &quot;county&quot;: &quot;Cuauhtémoc&quot;,
    &quot;city&quot;: &quot;Ciudad de México&quot;,
    &quot;district&quot;: &quot;Centro&quot;,
    &quot;street&quot;: &quot;Tacuba&quot;,
    &quot;houseNumber&quot;: &quot;17&quot;,
    &quot;postalCode&quot;: &quot;06000&quot;,
    &quot;references&quot;: &quot;&quot;
  },
  &quot;geocoding&quot;: {
    &quot;latitude&quot;: 19.43568,
    &quot;longitude&quot;: -99.13823,
    &quot;score&quot;: 1
  }
}</div></div></code></pre></div><h2 class="slate-h2 " >400 Bad Request</h2><p class="slate-p " >La solicitud no cumple con los requisitos de formato o parámetros obligatorios.</p><div class="code-block-wrapper"  style="width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;message&quot;: &quot;Bad request&quot;,
  &quot;errors&quot;: [
    {
      &quot;type&quot;: &quot;missing&quot;,
      &quot;field&quot;: &quot;address&quot;,
      &quot;msg&quot;: &quot;Field required&quot;
    }
  ]
}</div></div></code></pre></div><h2 class="slate-h2 " >500 Internal Server Error</h2><p class="slate-p " >Este código indica que se produjo un error inesperado en el servidor al procesar la solicitud. Puede deberse a fallos temporales, problemas de infraestructura o errores internos de la aplicación.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Acción recomendada:</strong> reintentar la llamada después de unos segundos. </div></li><li class="slate-li " ><div style="position:relative">Si el problema persiste, verifica los parámetros enviados y, de ser necesario, contacta al equipo de soporte técnico de Pinit proporcionando el <code class="slate-code">requestId</code> o los detalles de tu solicitud para facilitar la investigación.</div></li></ul><p class="slate-p " ></p>

A continuación se detallan los principales códigos HTTP que puede devolver el servicio, junto con ejemplos de las respuestas más comunes.

La solicitud se procesó correctamente. Existen dos variantes:

La solicitud no cumple con los requisitos de formato o parámetros obligatorios.

Este código indica que se produjo un error inesperado en el servidor al procesar la solicitud. Puede deberse a fallos temporales, problemas de infraestructura o errores internos de la aplicación.

<p class="slate-p " >Es importante saber que:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El servicio está diseñado principalmente para direcciones en <strong class="slate-bold">México y Colombia</strong>. Si tu caso de uso involucra otro país, nuestro equipo puede revisar la viabilidad técnica y trabajar contigo en una solución personalizada. Contáctanos para más información.</div></li><li class="slate-li " ><div style="position:relative">El parámetro <code class="slate-code">enable_validation</code> usa un catálogo interno de <strong class="slate-bold">códigos postales</strong>.</div></li><li class="slate-li " ><div style="position:relative">La geocodificación puede usar <strong class="slate-bold">distintos proveedores</strong> según umbral de confianza.</div></li><li class="slate-li " ><div style="position:relative">El campo <code class="slate-code">score</code> indica la <strong class="slate-bold">confianza del resultado</strong> (entre 0 y 1). </div></li><li class="slate-li " ><div style="position:relative">Si <code class="slate-code">enable_validation</code> es <code class="slate-code">true</code>, la validación se usa internamente pero <strong class="slate-bold">no aparece en la respuesta</strong>. </div></li><li class="slate-li " ><div style="position:relative">Para soporte o autenticación, <strong class="slate-bold">contacta al equipo técnico de Pinit</strong>.</div></li></ul><p class="slate-p " ></p>

<p class="slate-p " >En esta sección encontrarás respuestas a las dudas más comunes sobre el uso de <strong class="slate-bold">TrueAddress AI</strong>.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué tan limpia debe estar la dirección que envío?</strong></h4><p class="slate-p " >No es necesario que esté perfectamente escrita. El modelo está diseñado para trabajar con direcciones en texto libre, incluyendo errores comunes, abreviaciones y formatos mixtos. Sin embargo, se recomienda incluir al menos calle, número y colonia/ciudad para mejores resultados.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué hace exactamente el parámetro </strong><code class="slate-code"><strong class="slate-bold">enable_validation</strong></code><strong class="slate-bold">?</strong></h4><p class="slate-p " >Cuando se activa (<code class="slate-code">true</code>), el servicio utiliza un catálogo interno de códigos postales (solo en México) para validar y corregir de forma más precisa los componentes administrativos: estado, municipio y colonia. Esta validación es <strong class="slate-bold">interna</strong> y no aparece explícitamente en la respuesta, pero mejora la calidad del resultado.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué proveedores se usan para la geocodificación?</strong></h4><p class="slate-p " >El servicio puede usar múltiples APIs externas. Se selecciona automáticamente el proveedor con mejor resultado según un umbral interno.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué representa el campo </strong><code class="slate-code"><strong class="slate-bold">score</strong></code><strong class="slate-bold"> en la respuesta de geocoding?</strong></h4><p class="slate-p " >El campo <code class="slate-code">score</code> es un valor entre <code class="slate-code">0</code> y <code class="slate-code">1</code> que indica el nivel de confianza de la geocodificación. Un score de <code class="slate-code">1.0</code> representa una alta precisión (por ejemplo, número exterior exacto).</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Cómo obtengo mi token de autenticación?</strong></h4><p class="slate-p " >Debes contactar al equipo técnico de Pinit para obtener tus credenciales de acceso. El token es obligatorio y debe incluirse en cada solicitud HTTP en el header <code class="slate-code">Authorization</code>.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué países están soportados?</strong></h4><p class="slate-p " >El servicio está optimizado para direcciones en <strong class="slate-bold">México y Colombia</strong>. Si deseas trabajar con otros países, contáctanos para analizar la viabilidad y configuración necesaria.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué pasa si la dirección no puede geocodificarse?</strong></h4><p class="slate-p " >En ese caso, el campo <code class="slate-code">geocoding</code> será igual a <code class="slate-code">false</code> o nulo. Aún así, recibirás una dirección limpia y estructurada. Puedes revisar el campo <code class="slate-code">score</code> si la geocodificación es baja o inconsistente.</p>

En esta sección encontrarás respuestas a las dudas más comunes sobre el uso de 

¿Qué tan limpia debe estar la dirección que envío?

No es necesario que esté perfectamente escrita. El modelo está diseñado para trabajar con direcciones en texto libre, incluyendo errores comunes, abreviaciones y formatos mixtos. Sin embargo, se recomienda incluir al menos calle, número y colonia/ciudad para mejores resultados.

), el servicio utiliza un catálogo interno de códigos postales (solo en México) para validar y corregir de forma más precisa los componentes administrativos: estado, municipio y colonia. Esta validación es 

 y no aparece explícitamente en la respuesta, pero mejora la calidad del resultado.

¿Qué proveedores se usan para la geocodificación?

El servicio puede usar múltiples APIs externas. Se selecciona automáticamente el proveedor con mejor resultado según un umbral interno.

 que indica el nivel de confianza de la geocodificación. Un score de 

 representa una alta precisión (por ejemplo, número exterior exacto).

¿Cómo obtengo mi token de autenticación?

Debes contactar al equipo técnico de Pinit para obtener tus credenciales de acceso. El token es obligatorio y debe incluirse en cada solicitud HTTP en el header 

El servicio está optimizado para direcciones en 

. Si deseas trabajar con otros países, contáctanos para analizar la viabilidad y configuración necesaria.

¿Qué pasa si la dirección no puede geocodificarse?

 o nulo. Aún así, recibirás una dirección limpia y estructurada. Puedes revisar el campo 

 si la geocodificación es baja o inconsistente.

Sections

Ask an AI

Code with AI