Usa el contrato de mapas revisado
Los mapas de Driver combinan lecturas de pedidos, coordenadas devueltas de participantes, ubicación del dispositivo, agrupación local, proveedores de mapas/imágenes, escrituras opcionales de posición Driver, validación, navegación desde globos y transferencias a aplicaciones externas. Ninguna etapa demuestra otra.
La visibilidad de un marcador, el texto de distancia, la representación del proveedor, la navegación desde un globo o una aplicación externa abierta no demuestran la ubicación, la ruta, el uso compartido ni la finalización.
Disponibilidad
La vista Map autenticada está condicionada por el estado local de permisos y una posición inicial utilizable. Los detalles del pedido también pueden abrir un mapa de destino interno y transferencias directas a direcciones/proveedores.
Abrir o enfocar mapas puede iniciar lecturas autenticadas de pedidos, trabajo de GPS/posición actual, seguimiento de ubicación, cargas de proveedores de mapas/imágenes e intención de solicitar la posición Driver. Un simulador no constituye por defecto un entorno de mapas seguro.
Requisitos previos
- Ámbito Driver autenticado y contexto de pedido autorizado.
- Coordenadas tipadas y finitas con origen explícito, marca temporal, política de confianza/simulación y propósito.
- Evidencia independiente por plataforma/versión de solicitudes de permisos y concesiones efectivas.
- Adaptadores de proveedores denegados o sustituidos durante la obtención de evidencia.
- Ninguna dirección, coordenada, persona, pedido, proveedor o ruta real en fixtures públicos.
Límites de responsabilidad
| Responsable | Responsabilidad |
|---|---|
| API de lectura de pedidos | Devolver pedidos dentro del ámbito de Driver y los campos necesarios de participantes |
| Controlador del mapa | Solicitar datos, agrupar localmente y mantener carga/error/paginación |
| Interfaz de marcadores | Validar entradas de visualización y presentar grupos de Driver/negocio/cliente |
| Proveedor de ubicación | Devolver posiciones candidatas del dispositivo/seguimiento con ciclo de vida de plataforma |
| API de posición | Autorizar el ámbito propio de Driver y procesar la escritura/efectos de ubicación |
| Proveedor de mapas/imágenes | Representar teselas/recursos; nunca define la autorización de pedidos/ubicaciones |
| Navegación desde globo | Navegar localmente a un detalle o lista sin implicar un estado |
| Transferencia externa | Enviar el destino al sistema operativo/proveedor tras una elección explícita del usuario |
| Responsables de producto/seguridad/privacidad | Definir vigencia, simulación, retención, uso compartido y políticas de proveedor |
Entradas y resultados
Lectura y agrupación de pedidos
La vista Map solicita un conjunto fijo de pedidos activos determinado por el código fuente y luego agrupa localmente los pedidos devueltos mediante identificadores de negocio y cliente. Un marcador puede representar varios pedidos. Los ID o coordenadas ausentes/mal formados pueden alterar la agrupación y el comportamiento de rutas.
Los resultados pueden ser carga, mapa vacío/sin resolver, marcador solo de Driver, marcadores de participantes, globos agrupados, error o actualización. Ninguno constituye una instantánea completa y actual de pedidos.
Ubicación del dispositivo y escrituras
La App puede solicitar la posición actual o iniciar el seguimiento. Una posición candidata distinta de cero puede activar una escritura de posición Driver. El procesamiento de la fuente actual puede actualizar la ubicación/marca temporal guardadas y, de manera condicional, emitir sockets, tareas de proximidad e historiales de pedidos.
La confianza en la vigencia/simulación y el éxito de la ubicación afectada por el estado están bloqueados a la espera de correcciones del servidor y pruebas negativas.
Proveedores y transferencias
Los mapas internos usan un proveedor y pueden cargar imágenes remotas. Show in other maps puede mostrar proveedores candidatos; los enlaces directos a direcciones usan esquemas de plataforma. La declaración/posibilidad de consulta, instalación, compatibilidad, selección, apertura, ruta, indicaciones, llegada y finalización son estados distintos.
Seguridad y privacidad
- Autoriza el ámbito del pedido y Driver antes de devolver coordenadas/PII.
- Valida rangos finitos, origen, vigencia, política de simulación, marca temporal y destino previsto antes de usar coordenadas para el estado o compartirlas.
- Nunca confíes en un marcador del cliente, control de permisos, respuesta del proveedor o ruta externa como validación de seguridad.
- Reduce al mínimo la retención de direcciones/ubicación y la audiencia; mantén privados los esquemas exactos de proveedores, identificadores y hallazgos de seguridad.
- Bloquea GPS, mapas, imágenes, enlaces de direcciones, enumeración de aplicaciones instaladas, sockets y escrituras de posición en los fixtures de documentación.
Límites y estados de fallo
| Estado | Interpretación requerida |
|---|---|
| Mapa vacío | Posición/pedido/proveedor sin resolver |
| Marcador en cero/en un punto inesperado | Posible entrada no válida/obsoleta |
| Globo agrupado | Agrupación local por clave compartida, no autorización de grupo |
| Marcador de Driver | Posición candidata, no necesariamente reciente/confiable/aceptada por el servidor |
| Respuesta de escritura de posición | No demuestra finalización de socket/historial/visibilidad para clientes |
| Elemento de proveedor | Candidato, no necesariamente instalado/compatible |
| Enlace de dirección | Transferencia preparada, no ruta válida |
| Apertura de aplicación externa | Responsabilidad del proveedor, no éxito de navegación |
No se establece una máquina de estados completa, operación atómica de lectura/escritura/proveedor, reintento seguro, precisión de ruta, seguimiento, uso compartido, retención ni éxito en producción.
Diagnóstico
Faltan marcadores o se agruparon mal
Valida los ID tipados y las coordenadas finitas del registro de origen. No deduzcas que no hay pedidos ni combines/separes registros basándote solo en la interfaz.
La ubicación de Driver parece obsoleta
Trata por separado la posición candidata del dispositivo, ubicación guardada, marca temporal, representación del proveedor, escritura de API, socket y visibilidad del cliente. No actualices repetidamente.
Aparece un proveedor, pero no se abre
Que aparezca en la lista de candidatos no demuestra que esté instalado ni sea compatible. Cancela y usa la transferencia aprobada por el operador después de validar el destino.
Una dirección directa abre un lugar incorrecto
Detén las indicaciones. Valida la dirección y las coordenadas con la persona responsable autoritativa del pedido; no edites ni pruebes esquemas alternativos desde Driver App.
Una prueba de mapas parece funcionar
Confirma que los adaptadores de proveedor/GPS/red/escritura estuvieran inertes y que el fixture usara datos falsos finitos. De lo contrario, considera demostrado solo el soporte del código fuente.
Guías relacionadas: Usar el mapa de entregas · Abrir navegación externa · Comprender los permisos de ubicación