--- title: "Usa el contrato de mapas | Documentación de Ordering.co" description: "Separa las lecturas de pedidos, la agrupación de marcadores, la ubicación del dispositivo y las escrituras de posición del contrato de mapas." canonical: https://docs.ordering.co/es/docs/developers/driver-app/maps-contract/ --- # 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](https://docs.ordering.co/es/docs/products/driver-app/maps/delivery-map/) · [Abrir navegación externa](https://docs.ordering.co/es/docs/products/driver-app/maps/open-navigation/) · [Comprender los permisos de ubicación](https://docs.ordering.co/es/docs/products/driver-app/maps/location-permissions/)