Como hemos presentado en la Introducción, un PoI es un punto en el mapa donde se debe desempeñar una tarea (una entrega, un retiro de mercaderías, una visita, etc). La columna de la derecha muestra el modelo de datos de un PoI.
Para crear un PoI, los datos mandatorios que deben definirse son:
code
: código del PoI en el sistema integrado a QuadMinds (tu "código de cliente")name
: nombre del PoI (puede ser un nombre de fantasía, el nombre jurídico o "razón social").address
: dirección del punto para obtener las coordenadas
Email y Teléfono
Si bien los campos
phoneNumber
no son obligatorios para crear un PoI , es importante que estén completos pues de otro modo no podrán enviarse las notificaciones a clientes con los diferentes estados del pedido.
Georreferenciación
Al crear un PoI, la plataforma intentará georreferenciar el punto a partir de la dirección ingresada. Por ello es importante que el objeto address
sea válido e incluya calle, altura, ciudad, estado y país de acuerdo a la nomenclatura oficial de calles de tu ciudad. Por ejemplo: "Avenida Franklin D. Roosevelt" en lugar de "Roosevelt". La precisión en la definición de la dirección del PoI aumenta las probabilidades de una georreferenciación correcta y por lo tanto, facilita luego la optimización de las rutas.
"address": {
"street": "string",
"number": "string",
"locality": "string",
"state": "string",
"country": "string"
}
Eliminación de PoIs
La eliminación de un PoI de la base de datos se realiza en forma lógica. Es decir, un PoI debe marcarse como "enabled": false
mediante el método PUT (update).