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

Parámetros de entrada – POST /clusters

Ejemplo de petición – POST /clusters

Respuesta – POST /clusters

Default

servicios

Production

<p class="slate-p " >El servicio <span style="color:#9900FF"><strong class="slate-bold">Clusters Inteligentes</strong></span> permite agrupar un conjunto de puntos geográficos (latitud/longitud) en clusters optimizados para operaciones logísticas. Utiliza algoritmos de <em class="slate-italic">machine learning</em> para analizar la distribución espacial de los datos, aplicar filtros opcionales que eliminan outliers y generar agrupaciones que cumplen con restricciones operativas definidas por el usuario.</p><h2 class="slate-h2 " >Objetivo</h2><p class="slate-p " >Su objetivo es facilitar la segmentación geográfica de grandes volúmenes de puntos para mejorar la planificación logística, simplificar el análisis operativo y reducir la complejidad de implementación.</p><h2 class="slate-h2 " >Casos de uso</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Preparar insumos para sistemas de ruteo y optimización de entregas.</div></li><li class="slate-li " ><div style="position:relative">Identificar zonas de alta concentración de puntos para análisis operativo o comercial.</div></li><li class="slate-li " ><div style="position:relative">Generar visualizaciones geográficas (CSV, KMZ) para herramientas GIS o reportes ejecutivos.</div></li></ul><p class="slate-p " ></p>

 permite agrupar un conjunto de puntos geográficos (latitud/longitud) en clusters optimizados para operaciones logísticas. Utiliza algoritmos de 

 para analizar la distribución espacial de los datos, aplicar filtros opcionales que eliminan outliers y generar agrupaciones que cumplen con restricciones operativas definidas por el usuario.

Su objetivo es facilitar la segmentación geográfica de grandes volúmenes de puntos para mejorar la planificación logística, simplificar el análisis operativo y reducir la complejidad de implementación.

<p class="slate-p " >Este servicio requiere autenticación mediante <strong class="slate-bold">Bearer Token</strong> en todas las solicitudes. El token es proporcionado por el <strong class="slate-bold">equipo de soporte de Pinit</strong> y debe incluirse en el encabezado <code class="slate-code">Authorization</code> de cada petición HTTP.</p><h3 class="slate-h3 " >Ecabezado requerido</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">HTTP</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-http keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">Authorization: Bearer &lt;token&gt;</div></div></code></pre></div><h3 class="slate-h3 " >Consideraciones</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El token es único por cliente y debe mantenerse confidencial. </div></li><li class="slate-li " ><div style="position:relative">Un token inválido, expirado o ausente resultará en una respuesta <code class="slate-code">401 Unauthorized</code>.</div></li></ul><p class="slate-p " ></p>

Este servicio requiere autenticación mediante 

 en todas las solicitudes. El token es proporcionado por el 

<p class="slate-p " ><strong class="slate-bold">POST</strong> <code class="slate-code">https://services.pinittms.com/clusters</code></p><p class="slate-p " >Registra un nuevo proceso de clustering de puntos geográficos. Este endpoint recibe un listado de coordenadas (latitud y longitud) y parámetros de configuración para generar clusters optimizados para logística.</p><p class="slate-p " >El procesamiento se ejecuta de forma asíncrona y la respuesta incluye un identificador único (<code class="slate-code">id</code>) de tipo UUID, que puede utilizarse para consultar el estado y los resultados del proceso mediante <code class="slate-code">GET /clusters/{uuid}</code>.</p>

Registra un nuevo proceso de clustering de puntos geográficos. Este endpoint recibe un listado de coordenadas (latitud y longitud) y parámetros de configuración para generar clusters optimizados para logística.

El procesamiento se ejecuta de forma asíncrona y la respuesta incluye un identificador único (

) de tipo UUID, que puede utilizarse para consultar el estado y los resultados del proceso mediante 

CSV válido, con encabezado "latitude,longitude" o "id,latitude,longitude". Latitud entre -90 y 90, longitud entre -180 y 180. Mínimo 100 puntos de datos.

points

remove_outliers

Requerido si remove_outliers es true. Define qué tan estrictamente se eliminan los puntos alejados del grupo principal:
* strict – Elimina puntos que se desvían incluso ligeramente en latitud o longitud. Recomendado cuando se requiere limpieza agresiva.
* moderate (recomendado) – Elimina solo los puntos claramente fuera del rango habitual, conservando variaciones normales.
* relaxed – Elimina únicamente los puntos muy aislados, considerando su distancia total respecto al centro del conjunto.

outlier_filter_level

Indica si se debe aplicar una restricción sobre el número mínimo de paquetes por cluster.

min_packages_per_cluster_enabled

Valor mínimo de paquetes por cluster. Requerido si min_packages_per_cluster_enabled es true.

min_packages_per_cluster

Límite máximo de % de paquetes en un mismo cluster.

max_cluster_percentage

Authorization

Content-Type

<p class="slate-p " >Los parámetros del cuerpo de la solicitud son:</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">points</strong></code> <em class="slate-italic">(string, requerido)</em> </p><p class="slate-p " >Listado de coordenadas en formato CSV válido.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Debe incluir encabezado <code class="slate-code">&quot;latitude,longitude&quot;</code> o <code class="slate-code">&quot;id,latitude,longitude&quot;</code>.</div></li><li class="slate-li " ><div style="position:relative">Rango válido: latitud entre -90 y 90, longitud entre -180 y 180.</div></li><li class="slate-li " ><div style="position:relative">Debe contener al menos <strong class="slate-bold">100 puntos de datos.</strong></div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">remove_outliers</strong></code> <em class="slate-italic">(boolean, requerido)</em> </p><p class="slate-p " >Indica si se deben eliminar puntos atípicos (outliers) antes de generar los clusters.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Valores permitidos: <code class="slate-code">true</code> o <code class="slate-code">false</code>.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">outlier_filter_level</strong></code> <em class="slate-italic">(string, condicional)</em> </p><p class="slate-p " >Nivel de sensibilidad en la detección de outliers.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Requerido <strong class="slate-bold">solo si</strong> <code class="slate-code">remove_outliers = true</code>. </div></li><li class="slate-li " ><div style="position:relative">Valores permitidos: <code class="slate-code">&quot;strict&quot;</code>, <code class="slate-code">&quot;moderate&quot;</code>, <code class="slate-code">&quot;relaxed&quot;</code>. </div></li><li class="slate-li " ><div style="position:relative">Significafo de cada nivel:</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">strict</code>: Elimina puntos que se desvían aunque sea ligeramente del patrón general. Recomendado si se desea limpieza agresiva de datos.
 <em class="slate-italic">(Ejemplo: puntos que están un poco más al norte o al este que el resto podrían ser excluidos).</em></div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">moderate</code>: Solo elimina puntos claramente fuera del rango habitual. Es útil para conservar variaciones normales y eliminar errores evidentes.
 <em class="slate-italic">(Ejemplo: solo se excluyen puntos realmente fuera de la zona de trabajo).</em></div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">relaxed</code>: Considera la distancia global de cada punto respecto al centro del conjunto, eliminando únicamente aquellos que están muy aislados.
 <em class="slate-italic">(Ejemplo: se eliminan solo los puntos realmente fuera de toda área operativa, como si estuvieran en otra ciudad).</em></div></li></ul></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">min_packages_per_cluster_enabled</strong></code> <em class="slate-italic">(boolean, requerido)</em> </p><p class="slate-p " >Indica si se debe aplicar una restricción sobre el tamaño mínimo de los clusters.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Valores permitidos: <code class="slate-code">true</code> o <code class="slate-code">false</code>.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">min_packages_per_cluster</strong></code> <em class="slate-italic">(integer, condicional)</em> </p><p class="slate-p " >Tamaño mínimo permitido para cada cluster.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Requerido <strong class="slate-bold">solo si </strong><code class="slate-code">min_packages_per_cluster_enabled = true</code>. </div></li><li class="slate-li " ><div style="position:relative">Valor mínimo: <code class="slate-code">0</code>. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Debe ser congruente con</strong> <code class="slate-code">max_cluster_percentage</code> para asegurar que sea posible cumplir ambas restricciones al mismo tiempo.</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><code class="slate-code"><strong class="slate-bold">max_cluster_percentage</strong></code> <em class="slate-italic">(integer, requerido)</em> </p><p class="slate-p " >Límite máximo del porcentaje de puntos que puede contener un solo cluster.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Valores permitidos: <code class="slate-code">0</code>a <code class="slate-code">100</code>. </div></li><li class="slate-li " ><div style="position:relative">Un valor bajo promueve una distribución más equilibrada entre clusters. </div></li><li class="slate-li " ><div style="position:relative">Un valor alto permite concentrar más puntos en un mismo cluster.</div></li></ul><p class="slate-p " ></p>

Los parámetros del cuerpo de la solicitud son:

Listado de coordenadas en formato CSV válido.

Indica si se deben eliminar puntos atípicos (outliers) antes de generar los clusters.

Nivel de sensibilidad en la detección de outliers.

Indica si se debe aplicar una restricción sobre el tamaño mínimo de los clusters.

Tamaño mínimo permitido para cada cluster.

Límite máximo del porcentaje de puntos que puede contener un solo cluster.

<p class="slate-p " >En el siguiente ejemplo se envía un archivo CSV con <strong class="slate-bold">644 coordenadas geográficas</strong>, distribuidas en distintas regiones. El objetivo es generar <strong class="slate-bold">clusters balanceados</strong> para uso logístico, aplicando filtros para eliminar puntos atípicos y controlar el tamaño relativo de cada agrupación.</p><p class="slate-p " >📍 <em class="slate-italic">En la imagen se muestra la distribución espacial de los puntos utilizados.</em></p><div style="text-align:center"><img src="https://d24lr4zqs1tgqh.cloudfront.net/18aae711-02fc-4fc7-95de-56e76d648259.png" style="
              width:586px;
	            height:312px;
	            aspect-ratio:586 / 312"
         /></div><p class="slate-p " >📄 <em class="slate-italic">En la caja de abajo se incluye una muestra del contenido del archivo CSV enviado.</em></p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</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">latitude,longitude
19.43374,-99.13902
22.10534,-103.25224
19.43374,-99.13902
25.8098,-109.01839
22.11374,-103.27151
19.43374,-99.13902
22.10441,-103.2522
19.43374,-99.13902
22.75368,-102.5862
22.75652,-102.47849
21.72784202,-102.2976438
21.84976711,-102.2987625
23.32077,-103.01271
22.7322,-102.52715
21.84661,-102.31397
21.89928366,-102.3009471
21.90502,-102.3051
21.85986,-102.25589
21.93899,-102.32333
21.92513962,-102.239772
21.82519587,-102.2790002
22.94855,-102.70253
22.82699,-102.61298
21.87299,-102.27934
21.85652,-102.24266
22.28154548,-102.0678792
22.75298,-102.47887
21.87293,-102.32988
21.95983,-102.29991
21.87967,-102.22528
23.18051,-102.86365
21.82712,-102.26661
23.16325,-102.83462
21.83886628,-102.246204
21.95542,-102.27885
22.76536,-102.58351
21.81802803,-102.1939795
22.43688,-102.24979
21.99392847,-101.893714
21.8696,-102.23889
21.81091,-102.27244
22.05767,-101.9277
21.84019746,-102.2948448
21.87204,-102.31285
21.90204,-102.41527
22.77115,-102.5746
21.93156,-102.2804
21.87357,-102.23425
21.94031,-102.25758
23.19573,-102.85534
21.88887,-102.24105
21.8783741,-102.2382485
21.85251,-102.32289
21.89554,-102.29608
22.22962,-102.25073
21.90803,-102.25132
21.91540047,-102.2653138
21.93577427,-102.266736
21.88101,-102.23035
23.23145,-102.84447
21.9281,-102.25934
21.78428852,-102.2451277
21.8783741,-102.2382485
21.82191776,-102.2647307
22.76862,-102.57448
23.16968,-102.84712
21.67385,-102.29117
21.88948,-102.27019
21.8390928,-102.3030701
21.95641,-102.33669
21.82519587,-102.2790002
21.82321,-102.27552
21.86527,-102.30704
22.77391,-102.57186
22.65446,-103.00603
21.87161,-102.27425
21.95413,-102.31639
21.93021,-102.31366
22.95342,-102.71085
21.87465,-102.28385
21.90893814,-102.2382976
22.75427,-102.60442
21.91767,-102.30709
21.88393,-102.31555
21.96259,-102.30011
21.83886628,-102.246204
21.88068663,-102.2712709
21.85463,-102.2769
22.06483,-102.26442
22.6575,-103.00144
21.85891,-102.33177
21.92945769,-102.3028687
21.67596288,-102.3014376
21.83913,-102.31894
22.95961,-102.70586
21.86248,-102.25257
21.88331798,-102.314712
21.95158662,-102.3074395
21.89928366,-102.3009471
21.84293,-102.24818
21.97017441,-102.2982768
21.95158662,-102.3074395
21.90643,-102.28954
21.91981,-102.33539
21.8342069,-102.3172722
21.91494,-102.25787
23.19891,-102.88112
22.7554,-102.53748
21.84846,-102.25923
21.92092045,-102.3392969
21.86395,-102.30191
21.99392847,-101.893714
21.95158662,-102.3074395
22.73296,-102.511
21.95297,-102.31109
21.8783741,-102.2382485
21.88031,-102.28138
21.92377,-102.33483
21.93643,-102.30538
21.82191776,-102.2647307
22.22992174,-102.3208294
21.90742,-102.27828
22.76867,-102.61146
21.8908,-102.26436
21.86352,-102.30779
21.90976709,-102.3134162
21.85125,-102.31329
23.17853,-102.87272
21.93528,-102.30458
21.82304,-102.27614
21.91931,-102.30875
21.96503797,-102.2603314
21.8458,-102.25731
21.88799,-102.24237
21.86324,-102.27996
21.8783741,-102.2382485
22.94934,-102.7099
21.90976709,-102.3134162
21.85584,-102.26031
21.88477,-102.2293
21.89509,-102.26795
23.16821,-102.88264
21.92909765,-102.2145437
21.89329,-102.25788
21.84999,-102.3152
21.87390673,-102.2876037
21.90163439,-102.2605424
21.91595,-102.26071
21.85958,-102.26476
21.92092045,-102.3392969
21.93577427,-102.266736
21.91741,-102.25992
21.87634,-102.31225
22.70036,-102.73831
21.91540047,-102.2653138
21.86396,-102.33991
21.90965,-102.24371
23.19924,-102.85382
21.85354,-102.25485
21.88291,-102.3055
21.84341,-102.30538
21.82191776,-102.2647307
22.63792,-102.9894
21.89322,-102.25638
22.13317,-102.20481
22.75474,-102.47687
22.73068,-102.51323
22.0629,-102.26282
21.90532392,-102.2816575
22.74531,-102.52125
22.14768,-102.27729
21.88322,-102.31697
21.92524,-102.33473
21.89486174,-102.2569628
22.95961,-102.70586
21.89049,-102.30842
22.74882,-102.61749
21.85995,-102.24874
21.88386022,-102.2933833
21.95223,-102.31298
23.17936,-102.88932
21.89004,-102.26144
21.95786,-102.3128
21.91282,-102.2361
21.85317,-102.28424
21.88451,-102.23219
21.85932,-102.31283
21.87377,-102.31112
21.92513962,-102.239772
21.93209,-102.25287
21.87586,-102.29005
21.8390928,-102.3030701
22.06747,-102.265
21.93475,-102.28655
21.85958,-102.2648
21.9942,-102.29281
21.85642,-102.318
22.75825,-102.54465
21.88262,-102.26437
21.84869,-102.31919
21.83886628,-102.246204
21.69993972,-102.3161075
21.89356,-102.24639
21.83886628,-102.246204
21.85975,-102.25551
21.95158662,-102.3074395
21.88357,-102.23785
22.77236,-102.51419
21.86785,-102.25323
21.86493,-102.22902
22.75824,-102.49667
21.8231,-102.27603
21.87238,-102.31361
21.86851,-102.2505
21.93412,-102.25425
21.90081,-102.30382
22.75826,-102.53518
21.88091,-102.28171
21.93916,-102.25577
22.75456,-102.47818
21.83886628,-102.246204
21.96032,-102.31071
21.91244,-102.25398
21.89995,-102.3064
21.95542,-102.30989
21.91349,-102.28059
21.84987,-102.24245
21.89928366,-102.3009471
21.98315,-102.29057
23.18994,-102.87583
21.90335,-102.29817
21.95158662,-102.3074395
21.92702,-102.30165
21.89612,-102.2577
21.89858,-102.32026
22.76086,-102.54014
21.85093,-102.26258
21.9592,-102.3375
21.92072,-102.24477
23.16745,-102.83936
21.86496,-102.29836
21.89885,-102.25846
21.83688,-102.31968
21.93577427,-102.266736
21.89247,-102.29528
21.89125747,-102.2982436
22.0929,-102.07172
21.8899816,-102.3124954
23.22539,-102.84143
21.93577427,-102.266736
21.89862,-102.27174
21.9237,-102.33138
21.94453,-102.3507
21.85973,-102.26926
21.90893814,-102.2382976
21.90755,-102.29702
21.89771,-102.2977
22.76693,-102.5926
21.83315,-102.29792
21.85377,-102.30937
22.76483,-102.5023
21.95186,-102.33498
21.94455,-102.34177
21.89731,-102.32007
22.22548,-102.32578
21.92408018,-102.0021814
21.9118,-102.27805
21.87603,-102.28847
21.91509,-102.27836
22.75304,-102.66296
21.87651,-102.2516
21.84939,-102.29867
21.89774,-102.26315
21.89353308,-102.3422819
21.86206,-102.25676
21.88386022,-102.2933833
22.72847,-102.517
22.03537763,-102.2799705
21.93316,-102.261
22.00005,-102.19768
21.82191776,-102.2647307
21.93728844,-102.3029133
23.32331,-103.0129
21.84003677,-102.3506877
21.78146,-102.46474
21.82529,-102.27456
21.8957,-102.23914
21.87309,-102.27052
21.89486174,-102.2569628
21.88867,-102.24784
21.75092555,-102.3154954
21.82795,-102.26486
21.83886628,-102.246204
21.91244,-102.25398
22.78029,-102.58202
21.92414,-102.32488
21.89003,-102.25658
21.89779,-102.32042
22.1443992,-102.2701144
21.96583,-102.33042
21.89502,-102.24272
23.19388,-102.85266
21.85363,-102.25709
23.34388,-102.9912
21.88909,-102.31236
21.89626717,-102.2902932
23.1929,-102.8655
21.88237,-102.29719
21.84325,-102.26329
21.90314,-102.24648
21.84147,-102.31618
21.83886628,-102.246204
22.32234,-102.2909
21.8475,-102.29444
21.86557,-102.23613
21.82191776,-102.2647307
21.86511,-102.25281
21.93528,-102.30458
21.93021,-102.31366
21.88393,-102.31555
21.89353308,-102.3422819
21.86413,-102.25639
21.92175855,-102.3063974
21.88105,-102.26517
22.64602,-102.99298
21.94218,-102.3249
22.75782,-102.47765
21.92821,-102.30435
21.83293,-102.25196
21.87278,-102.26508
22.63282,-102.99233
21.88386022,-102.2933833
21.85642,-102.318
21.89418,-101.99488
21.99392847,-101.893714
21.8957,-102.32341
21.918,-101.95898
21.82759,-102.28692
21.8298,-102.26393
23.16995,-102.87316
22.04922092,-102.2524859
21.67387,-102.29382
21.85217,-102.2717
22.78242,-102.4217
23.17568,-102.88133
21.87983,-102.28462
21.89819,-102.24865
21.93899,-102.32333
21.9013,-102.24501
22.68639,-102.23951
21.93313,-102.32599
21.83886628,-102.246204
23.18455,-102.89663
21.84516,-102.32225
21.81239698,-102.3042127
21.85958,-102.26392
21.92175855,-102.3063974
21.92442,-102.32319
21.83886628,-102.246204
21.97284,-102.35255
21.84003677,-102.3506877
21.95719,-102.3166
21.86576,-102.25313
21.85958,-102.26405
22.93994,-102.71341
21.90628,-102.25077
21.84954,-102.30271
21.8783741,-102.2382485
21.86333211,-102.2741287
21.96845,-102.35788
22.75778,-102.59817
22.22786,-102.32347
21.84996,-102.29971
21.85995,-102.2488
21.87774,-102.67564
21.9013,-102.25577
21.92354,-102.33729
21.85132,-102.30326
21.92947,-102.28327
21.84747,-102.35483
22.13817,-102.20662
21.93653,-102.25828
22.7554,-102.53748
23.18124,-102.868
21.95782,-102.31477
21.87603,-102.28847
22.64505,-103.00203
21.92012,-102.30176
21.89486174,-102.2569628
21.8602,-102.26627
21.91414,-102.23451
21.91684,-102.29958
21.88475,-102.22938
21.93256,-102.31024
21.87612,-102.24626
21.85499,-102.28068
21.88695,-102.27423
21.89559,-102.28829
21.89027,-102.25713
21.96259,-102.30011
21.89835,-102.32142
23.05551,-102.68606
21.90744,-102.29947
22.77308,-102.57171
21.85729,-102.3407
21.90836,-102.28
23.17209,-102.84932
21.87786,-102.24333
21.91078,-102.30531
21.89275,-102.29556
21.84685,-102.24723
22.75174,-102.52795
21.85975,-102.25551
21.85706,-102.26099
21.85277,-102.31211
21.97017441,-102.2982768
22.22186,-102.32768
21.8626,-102.34225
21.89769,-102.32173
21.90123,-102.25604
22.75388,-102.52354
21.8783741,-102.2382485
23.1829,-102.89377
22.65047,-102.97627
22.76193,-102.50261
21.83886628,-102.246204
21.8783741,-102.2382485
22.7552,-102.52697
22.7839,-102.56707
22.22992174,-102.3208294
21.85664,-102.27429
21.85457,-102.2962
21.87243,-102.29113
21.87524648,-102.3137989
22.02472,-102.30579
21.91455,-102.23523
21.92513962,-102.239772
22.73802,-102.51437
21.88204,-102.29741
21.87471,-102.31917
21.82629,-102.26571
23.1787,-102.86352
23.3659,-103.0758
23.16769,-102.87482
21.90395,-102.30367
21.86226,-102.25771
21.90323,-102.2788
22.02276,-102.27343
21.96268,-102.30066
21.84475,-102.31074
21.91684,-102.29958
21.89506,-102.25768
21.84698,-102.71641
23.16315,-102.83477
21.95058,-102.31371
21.90532392,-102.2816575
21.85008,-102.24396
22.77571,-102.56972
21.95158662,-102.3074395
22.7908,-102.63197
23.19408,-102.89465
21.67596288,-102.3014376
21.92787,-102.25585
22.73946,-102.51581
22.26673,-102.03327
21.86330856,-102.2628965
21.93577427,-102.266736
21.88268,-102.3277
22.75804,-102.48209
21.91769,-102.30903
22.64505,-103.00203
21.88589,-102.26035
21.85672,-102.27813
23.17802,-102.86403
21.88077,-102.22705
23.16899,-102.83993
21.88386022,-102.2933833
21.86201,-102.31079
21.8961,-102.2976
21.8390928,-102.3030701
21.87129,-102.26375
21.85284,-102.34586
21.8842,-102.2314
21.91365,-102.3125
21.83258,-102.28407
21.96089,-102.30036
21.93403,-102.25431
22.95652,-102.72387
22.22981,-102.32334
22.73952,-102.51574
22.23529107,-102.3320726
21.84558444,-102.7042695
21.95158662,-102.3074395
22.76027,-102.53928
22.7655,-102.56934
21.90093,-102.25722
21.92749,-102.24537
21.84003677,-102.3506877
21.8808,-102.27662
21.85327,-102.29553
21.91724,-102.28661
21.94001,-102.24586
21.85953,-102.34035
22.76263,-102.50446
21.8196,-102.26898
22.23648,-102.09173
21.91783,-102.33427
21.87078,-102.25883
21.89096,-102.2515
23.16968,-102.84712
21.92772,-102.26441
22.76086,-102.54014
21.88645,-102.30242
21.93552,-102.32382
22.81967,-102.22617
21.87228,-102.26087
22.75786,-102.52439
21.93577427,-102.266736
21.8342069,-102.3172722
21.88463,-102.26313
21.85383,-102.31324
21.96813,-102.3535
21.96316,-102.30099
22.7556,-102.49899
21.95537676,-102.2233645
21.85355,-102.3345
21.85188,-102.2722
21.91477122,-102.3004881
21.86982291,-102.2771493
22.74722,-102.58457
21.85075,-102.24842
21.92936,-102.25811
22.76108,-102.54234
21.87425,-102.29212
21.86734,-102.2749
21.84003677,-102.3506877
22.22271,-102.32991
21.96528902,-102.3330171
21.90893814,-102.2382976
21.90956,-102.25892
21.8783741,-102.2382485
22.93403,-102.70351
23.22885,-102.8384
21.84261,-102.26032
21.93577427,-102.266736
22.76375,-102.5668
22.76164,-102.50372
21.72784202,-102.2976438
21.88216,-102.30908
21.85975,-102.25551
21.72784202,-102.2976438
22.75507,-102.49885
21.95324,-102.34542
23.19978,-102.85549
21.90532392,-102.2816575
22.77239,-102.58525
21.9409,-102.24354
21.84003677,-102.3506877
21.83886628,-102.246204
21.83886628,-102.246204
21.89928366,-102.3009471
22.65501,-102.99416
22.26355,-102.03167
22.75598,-102.49418
21.89926,-102.31295
21.8783741,-102.2382485
21.96704,-102.29077
21.84388,-102.25166
21.84484,-102.28963
22.75895,-102.56354
21.84007,-102.30077
21.87368,-102.33283
21.83987,-102.32119
21.8777,-102.27804
21.85869,-102.3117
21.86901,-102.27819
21.92406,-102.33738
21.89353308,-102.3422819
22.95009,-102.7034
21.8757,-102.24512
21.87535,-102.31715
21.85872,-102.27533
23.16851,-102.85349
22.65004,-102.98421
21.83886628,-102.246204
21.97606954,-102.3307443
23.17802,-102.86403
23.15917,-102.87034
21.91540047,-102.2653138
21.97468576,-102.3623676
21.92421005,-102.3543742
21.86038666,-102.2871665
21.95158662,-102.3074395
21.82191776,-102.2647307
23.18906,-102.87007
21.90956,-102.25892
23.22591,-102.83567
22.75875,-102.56873
21.95847,-102.31664
21.83777,-102.25126
21.89928366,-102.3009471
21.93577427,-102.266736
21.84676,-102.30812
21.88872,-102.29136
21.89582,-102.31026
21.90169,-102.28921
21.93021,-102.31366
21.85125,-102.31329
21.9276,-102.32124
21.88094,-102.22617
22.7554,-102.53748
21.89353308,-102.3422819
22.77102,-102.4859
21.86876,-102.31299
21.89486,-102.32012
23.17008,-102.8694
21.87826953,-102.2826954
21.85105,-102.29849
22.76344,-102.58451
21.97094,-102.35043
21.87292,-102.32988
22.95094,-102.69622
22.21788832,-102.3451984
22.75822,-102.52218
21.82232,-102.27472
22.66174,-102.99695
21.89096,-102.2515
21.89199,-102.50651
21.82644,-102.26567
21.8532,-102.31384
21.85464,-102.72079
22.77236,-102.51419
21.8783741,-102.2382485
21.86208,-102.25535
22.75766,-102.51928
21.84431,-102.33046
21.87727,-102.27208
21.85559,-102.28004
21.85125,-102.31329
21.8739,-102.26635
21.82191776,-102.2647307
21.913,-102.28226
21.8273,-102.2667
21.8783741,-102.2382485 </textarea><code class="language-plainText keep-markup drop-tokens"></code></pre></div><p class="slate-p " >Parámetros aplicados en este ejemplo:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">points</code>: <code class="slate-code">latitude,longitude\n19.43374,-99.13902\n22.10534,-103.25224\n19.43374,-99.13902\n25.8098,-109.01839\n22.11374,-103.27151…</code>
Contiene el listado de 644 coordenadas en formato CSV con encabezado &quot;latitude,longitude&quot;. Estos puntos representan ubicaciones geográficas de interés.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">remove_outliers</code>: <code class="slate-code">true</code>
Se activó la detección y eliminación de outliers para excluir puntos que se encuentren significativamente alejados de los grupos principales, evitando que interfieran en la formación de clusters.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">outlier_filter_level</code>: <code class="slate-code">&quot;moderate&quot;</code>
Se eligió un nivel de sensibilidad intermedio para eliminar solo los puntos que están claramente alejados del resto.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">min_packages_per_cluster_enabled</code>: <code class="slate-code">true</code>
Se activó la restricción de tamaño mínimo por cluster para asegurar que cada agrupación sea lo suficientemente grande, según los criterios operativos de la empresa.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">min_packages_per_cluster</code>: <code class="slate-code">40</code>
Cada cluster debe contener al menos 40 puntos, lo que evita la generación de agrupaciones pequeñas que podrían ser ineficientes para la operación.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">max_cluster_percentage</code>: <code class="slate-code">30</code>
Se limitó el porcentaje máximo de puntos por cluster al 30% del total (en este caso, aproximadamente 193 puntos como máximo por cluster). Esto fomenta una distribución más equilibrada entre todas las agrupaciones.</div></li></ul><p class="slate-p " ></p>

En el siguiente ejemplo se envía un archivo CSV con 

, distribuidas en distintas regiones. El objetivo es generar 

 para uso logístico, aplicando filtros para eliminar puntos atípicos y controlar el tamaño relativo de cada agrupación.

En la imagen se muestra la distribución espacial de los puntos utilizados.

En la caja de abajo se incluye una muestra del contenido del archivo CSV enviado.

Identificador único del proceso de clustering. Se utiliza para consultar su estado.

Estado actual del proceso. Valores posibles: loaded, processing, completed, failed.

status

Configuración utilizada para el clustering. Repite los valores enviados en la petición.

configuration

Enlace al archivo CSV con los puntos originales. Disponible desde el inicio.

points_file_url

Enlace al archivo KMZ para visualización. Se completa cuando el proceso finaliza (status = completed).

kmz_file_url

Enlace al archivo CSV con datos de clusters. Disponible al finalizar el proceso.

clusters_file_url

Enlace al archivo con puntos asignados a clusters y centroides. Disponible al finalizar el proceso.

points_processed_file_url

Fecha y hora de creación del proceso (formato ISO 8601).

created_at

Última fecha y hora de actualización del proceso.

updated_at

Ejemplo de respuesta

<p class="slate-p " >Cuando la solicitud se procesa correctamente, el servicio responde con un código <code class="slate-code">200 OK</code> y un objeto JSON que contiene el identificador único del proceso (<code class="slate-code">id</code>), su estado inicial (<code class="slate-code">loaded</code>), la configuración aplicada y los enlaces a los archivos generados. Algunos archivos estarán disponibles de inmediato, mientras que otros se completarán una vez finalizado el procesamiento.</p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Cuando la solicitud se procesa correctamente, el servicio responde con un código 

 y un objeto JSON que contiene el identificador único del proceso (

), la configuración aplicada y los enlaces a los archivos generados. Algunos archivos estarán disponibles de inmediato, mientras que otros se completarán una vez finalizado el procesamiento.

Sections

Ask an AI

Code with AI