Entender la validación de ubicación

Para ciertas acciones de estado de entrega, Driver App puede comparar la ubicación actual del cliente con la del negocio o cliente y mostrar problemas de validación antes de enviar la solicitud de cambio de estado.

Es una comprobación previa del cliente. Que el resultado sea satisfactorio o desfavorable no demuestra que el GPS sea confiable, la ubicación esté actualizada, sea segura contra simulación, exista cercanía física, el servidor la haya aceptado ni cómo se comporte la aplicación implementada.

Disponibilidad

El validador revisado se aplica a ciertos estados objetivo seleccionados por el cliente para llegada, recogida, llegada al cliente y finalización de entrega cuando la configuración de validación correspondiente está activa.

Una configuración explícitamente deshabilitada apaga la comprobación local aunque se haya configurado un umbral de distancia. Si no existe la configuración explícita, un umbral numérico de distancia puede activar la comprobación. Que la validación esté desactivada no da permiso para realizar una acción del pedido.

Matriz de estados y resultados

Estado del cliente	Resultado local	Qué significa	Qué sigue sin confirmarse
El estado objetivo no requiere ubicación	El validador no devuelve ningún problema.	Esta comprobación local no se aplica.	Otros requisitos de ubicación o del servidor.
Validación desactivada explícitamente	La validación no devuelve problemas.	Se omite la comprobación previa del cliente.	Elegibilidad, cercanía o aceptación del servidor.
Falla la búsqueda de ubicación actual	Puede aparecer el problema Cannot get current location.	El cliente no obtuvo una ubicación utilizable de su hook.	Por qué falló el sistema operativo/proveedor o si otra fuente tiene la ubicación.
La marca de tiempo de ubicación supera la antigüedad configurada	Puede aparecer un aviso de ubicación desactualizada.	La marca de tiempo del cliente es anterior a su límite configurado.	Vigencia en el servidor, precisión del proveedor o confiabilidad de la captura de tiempo.
La ubicación no tiene marca de tiempo	No se evalúa la rama de ubicación desactualizada.	El cliente no tiene una marca de tiempo para comparar.	Que la ubicación esté actualizada.
Falta el destino del negocio/cliente	Puede aparecer Target location not found.	Al pedido devuelto le falta un destino que el asistente acepte.	El destino físico real o calidad de datos del servidor.
La distancia calculada supera el umbral	Puede aparecer un problema de distancia excesiva con la distancia y umbral calculados.	Las coordenadas del cliente superaron su límite configurado.	Cercanía confiable, distancia de ruta, precisión del GPS o decisión del servidor.
No hay problemas locales	El asistente devuelve válido con la ubicación actual.	La comprobación previa no encontró ninguno de los problemas que verifica.	Vigencia si no hay marca de tiempo, seguridad ante simulación, llegada física o éxito de la acción.
Hay indicador de ubicación simulada/falsa	En este asistente, el validador revisado del cliente no la rechaza.	La evaluación de ubicación simulada está fuera de esta comprobación local.	Ubicación segura/confiable o aplicación de la política del servidor sobre ubicaciones simuladas.

El asistente usa el negocio para ciertas transiciones de llegada/recogida y el cliente para transiciones seleccionadas de llegada/finalización. Calcula la distancia en línea recta entre coordenadas, no distancia de ruta, avance del recorrido, entrada del edificio ni prueba de presencia física.

Efectos y límites

Límite	Comportamiento definido por el código fuente	Límite público
Configuración	Habilita/deshabilita por estado objetivo y define antigüedad/distancia.	La configuración del cliente no confirma la política del servidor.
Ubicación actual	Usa la ubicación proporcionada o llama al hook de ubicación.	La lectura puede activar efectos del sistema operativo/proveedor/ubicación; el valor no es inherentemente confiable.
Marca de tiempo	Añade un problema de ubicación desactualizada solo si hay marca de tiempo y supera el límite.	La ausencia de marca no se considera desactualizada.
Ubicación de destino	Lee las coordenadas del negocio o cliente de los datos actuales del pedido.	Los datos ausentes/cero-like pueden considerarse ausentes; no se confirma que estén actualizados.
Distancia	Calcula la distancia entre coordenadas y la compara con el umbral.	No es distancia de ruta, precisión del GPS ni prueba de presencia.
Refresh Location	Puede solicitar una ubicación nueva y volver a validar.	Actualizar produce efectos y no está autorizado para reunir evidencia ni en esta referencia.
Go to settings	Puede transferir el control a Settings del sistema operativo después de un error de ubicación.	El traspaso produce efectos; el cambio en Settings y resultado al volver son pasos separados.
Solicitud de estado	Puede continuar solo si se corrigen los problemas del cliente en el flujo llamador.	La autorización de API, validación, escrituras y efectos posteriores siguen siendo independientes.

Interpretar la validación con seguridad

• Considera un problema un motivo para detener la acción de estado actual.
• No cambies, simules, actualices ni introduzcas manualmente la ubicación para que desaparezca el problema.
• En este contexto no pulses Refresh Location ni Go to settings para documentar o probar.
• Un resultado sin problemas no demuestra cercanía física ni autoriza a cambiar el estado.
• Pide al responsable del pedido/ubicación que concilie datos de destino dudosos o el estado actual del servidor.

Variaciones de plataforma y ciclo de vida

• Los permisos, Settings, ubicación en segundo plano, proveedores e indicadores de simulación pueden variar en iOS y Android.
• Los cambios entre primer y segundo plano pueden alterar la antigüedad de la ubicación o activar actualizaciones/seguimientos independientes.
• La exactitud del reloj y zona horaria del dispositivo afecta el cálculo local de antigüedad.
• La precisión del GPS/proveedor y las coordenadas afectan la distancia calculada, pero aquí no forman parte de una evaluación de nivel de confianza.

Solución de problemas

Lo que ves	Qué comprobar	Recuperación segura
Cannot get current location	Estado visible de permisos/proveedor y disponibilidad de servicios de ubicación	Detén la acción del pedido. Sigue la guía de permisos; no abras Settings ni actualices la ubicación para reunir evidencia.
Problema de ubicación desactualizada	Antigüedad local mostrada y reloj del dispositivo	Considéralo una advertencia local, no prueba de vigencia confiable. No cambies el reloj ni simules la ubicación.
Target location not found	Si los detalles actuales del pedido carecen visiblemente del contexto de destino utilizable	No copies coordenadas de otro producto; pide al responsable del pedido que corrija o verifique los datos.
Problema de distancia excesiva	Distancia calculada por el cliente y umbral configurado	No te muevas ni simules o alteres coordenadas para pasar una comprobación. Pide al responsable de ubicación/pedido que verifique el estado físico y del servidor.
No hay problemas, pero la ubicación parece dudosa	La marca de tiempo ausente, precisión del proveedor, controles de simulación y política del servidor no forman parte del resultado local satisfactorio.	Detente antes de la acción de estado y escala el caso.
La validación difiere entre dispositivos	Permisos, proveedor, reloj, precisión, configuración y plataforma pueden diferir.	Registra únicamente tipo de problema, plataforma y hora, nunca coordenadas o direcciones.
Actualizar o Settings parece corregir la interfaz	Son traspasos independientes con efectos y pueden cambiar el estado del cliente.	No consideres la nueva interfaz prueba de aceptación del servidor o cercanía.

Guías relacionadas: Permisos de ubicación · Mapa de entregas · Llegar al negocio · Llegar al cliente · Completar una entrega