Servicios de Mapa

Los servicios de edición de mapas también utilizan el dominio de la aspiradora porque todos los servicios están disponibles incluso sin conexión a la nube.

Solicitar mapa

dreame_vacuum.vacuum_request_map

Solicitar al dispositivo que suba un nuevo mapa a la nube. (Este servicio es útil cuando no se usa la conexión a la nube y otra integración se utiliza para manejar la representación del mapa)

Importante

El dispositivo no responde a esta acción cuando:

• Limpiando un punto
• Mapeo rápido
• Se está reubicando
• Después de una edición de mapa hasta que se mueve

Seleccionar mapa

dreame_vacuum.vacuum_select_map

Cambiar el mapa seleccionado actualmente. (Solo es posible si el mapa de varios pisos está habilitado)

Nota

• Puede obtener el id del mapa a partir de los atributos de la entidad de la cámara del mapa guardado.
• El robot finalizará el trabajo activo cuando se cambie el mapa seleccionado.

Ejemplo

• Establecer el mapa actual como el mapa con id 27

  service: dreame_vacuum.vacuum_select_map
  data:
      map_id: 27
  target:
      entity_id: vacuum.vacuum

Eliminar mapa

dreame_vacuum.vacuum_delete_map

Eliminar un mapa.

Nota

• Puede obtener el id del mapa a partir de los atributos de la entidad de la cámara del mapa guardado.
• Cuando la función de mapa de varios pisos está habilitada, los índices de los mapas pueden cambiar después de eliminarse. (Más sobre soporte de mapas de varios pisos)

Ejemplo

• Establecer eliminar mapa con id 48

  service: dreame_vacuum.vacuum_delete_map
  data:
      map_id: 48
  target:
      entity_id: vacuum.vacuum

Renombrar mapa

dreame_vacuum.vacuum_rename_map

Renombrar un mapa.

Nota

• Puede obtener el id del mapa a partir de los atributos de la entidad de la cámara del mapa guardado.
• La App oficial no permite ingresar caracteres especiales en el nombre del mapa, pero esta integración sí lo permite, así que use este servicio con cuidado.

Ejemplo

• Renombrar el mapa con id 14 a "Segundo Piso"

  service: dreame_vacuum.vacuum_rename_map
  data:
      map_id: 14
      map_name: "Second Floor"
  target:
      entity_id: vacuum.vacuum

Restaurar mapa Soporte de Mapa

dreame_vacuum.vacuum_restore_map

Restaurar un mapa desde un estado anterior que ha sido creado y subido por el dispositivo.

Nota

• No se garantiza que la recuperación del mapa sea exitosa. La nube no almacena los archivos para siempre y los archivos de recuperación generalmente se eliminan de la nube después de 365 días desde el último acceso.

Ejemplos

• Restaurar el mapa seleccionado al segundo mapa de recuperación guardado en la lista de mapas de recuperación

  service: dreame_vacuum.vacuum_restore_map
  data:
      recovery_map_index: 2
  target:
      entity_id: vacuum.vacuum

• Restaurar el mapa guardado con id 14 a su estado original

  service: dreame_vacuum.vacuum_restore_map
  data:
      map_id: 14
      recovery_map_index: 1
  target:
      entity_id: vacuum.vacuum

Restaurar mapa desde archivo

dreame_vacuum.vacuum_restore_map_from_file

Restaurar un mapa desde un archivo de mapa de recuperación previamente guardado.

Nota

• Este servicio se puede usar para recuperación sin conexión si descargas y colocas el archivo de mapa de recuperación en la carpeta /www/ de Home Assistant (la aspiradora y el servidor deben estar en la misma red).
• Se requiere el Id del mapa si la conexión a la nube no está habilitada.

Ejemplos

• Restaurar el mapa seleccionado desde un archivo de mapa de recuperación guardado

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      file_url: http://192.168.1.10/local/2023-11-04-1724223415-423528451_284320462.1156.mb.tbz2
  target:
      entity_id: vacuum.vacuum

• Restaurar el mapa guardado con id 14 desde el archivo de mapa de recuperación guardado

  service: dreame_vacuum.vacuum_restore_map_from_file
  data:
      map_id: 14
      file_url: https://dreame-cn.oss-cn-shanghai.aliyuncs.com/iot/tmp/000000/ali_dreame/YR649291/648921668/101?Expires=1699189998&OSSAccessKeyId=LTAI5t96WkBXXNzQrX4HtQti&Signature=ttRrjg8p7aC650H3DwI3%2F2ngOOE%3D
  target:
      entity_id: vacuum.vacuum

Respaldar mapa

dreame_vacuum.vacuum_backup_map

Activar la subida de un mapa guardado como mapa de recuperación a la nube.

Nota

• La nube solo puede almacenar una copia de seguridad de mapa por cada mapa guardado. Este servicio sobrescribirá la copia de seguridad del mapa anterior si tiene una.
• Las aspiradoras sin cámara o sensor lidar no tienen esta función, el disparador de copia de seguridad de mapas solo funciona en dispositivos compatibles.

Ejemplos

• Activar copia de seguridad del mapa seleccionado

  service: dreame_vacuum.vacuum_backup_map
  target:
      entity_id: vacuum.vacuum

• Activar copia de seguridad del mapa con id 15

  service: dreame_vacuum.vacuum_backup_map
  data:
      map_id: 15
  target:
      entity_id: vacuum.vacuum

Guardar mapa temporal

dreame_vacuum.vacuum_save_temporary_map

Guardar mapa recién creado. (El dispositivo le pedirá que lo haga cuando se cree el primer mapa después del restablecimiento de fábrica)

Descartar mapa temporal

dreame_vacuum.vacuum_discard_temporary_map

Descartar mapa recién creado.

Reemplazar mapa temporal

dreame_vacuum.vacuum_replace_temporary_map

Reemplazar mapa nuevo con uno antiguo.

Nota

• Puede obtener el id del mapa a partir de los atributos de la entidad de la cámara del mapa guardado.
• Cuando la función de mapa de varios pisos está habilitada, los índices del mapa pueden cambiar después de reemplazar el mapa. El mapa nuevo reemplazado siempre estará en el último índice disponible, incluso si se reemplaza con un mapa de índice inferior. (Más sobre soporte de mapas de varios pisos)

Ejemplo

• Reemplazar mapa nuevo con mapa con id 39

  service: dreame_vacuum.vacuum_replace_temporary_map
  data:
      map_id: 39
  target:
      entity_id: vacuum.vacuum

Renombrar habitación

dreame_vacuum.vacuum_rename_segment

Establecer nombre personalizado para una habitación en el mapa actual.

Nota

• Puede obtener los ids de mapa y de segmento de los atributos de la entidad de la cámara del mapa guardado.
• La aplicación oficial no permite ingresar caracteres especiales en el nombre de la habitación, pero esta integración sí lo hace, así que use este servicio con cuidado.

Ejemplo

• Renombrar la habitación 3 a "Comedor"

  service: dreame_vacuum.vacuum_rename_segment
  data:
      segment_id: 3
      segment_name: "Dining Room"
  target:
      entity_id: vacuum.vacuum

Ignorar obstáculo Soporte de Mapa

dreame_vacuum.vacuum_set_obstacle_ignore

Establecer el estado de ignorar de un obstáculo detectado en el mapa actual para que el robot no lo evite en los trabajos siguientes.

Nota

• Este servicio solo está disponible en aspiradoras con función de detección de obstáculos con IA y requiere una conexión en la nube.
• Puede adquirir las coordenadas de los obstáculos y su estado de ignorado actual desde el atributo obstacles de la entidad de la cámara del mapa actual. (Más sobre obstáculos)
• Las coordenadas deben coincidir exactamente con un obstáculo existente en el mapa actual, de lo contrario, la acción será rechazada.
• Los obstáculos que son ignorados automáticamente por el dispositivo no pueden ser cambiados con este servicio.
• El estado de ignorar obstáculos no puede cambiarse mientras el robot está en funcionamiento.

Ejemplos

• Ignorar el obstáculo en [819, -263]

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: true
  target:
      entity_id: vacuum.vacuum

• Dejar de ignorar el obstáculo en [819, -263]

  service: dreame_vacuum.vacuum_set_obstacle_ignore
  data:
      x: 819
      y: -263
      obstacle_ignored: false
  target:
      entity_id: vacuum.vacuum

Otros servicios Soporte de Mapa

Servicios adicionales de gestión de mapas son expuestos por la integración. Varios de estos parámetros (como el material del suelo, la visibilidad de la habitación y el tipo de fregona) ya están expuestos y pueden configurarse directamente a través de Entidades de Habitación, haciendo innecesario el uso directo de estos servicios.

No destinado a usuarios finales

Estos servicios se exponen estrictamente para el uso de Tarjeta de Aspiradora Dreame. No tienen parámetros que sean fácilmente accesibles para los usuarios finales. Si se envían parámetros inválidos, pueden ser pasados directamente al dispositivo, lo que puede resultar en problemas graves, como mapas corruptos o que el dispositivo entre en un bucle de arranque. Por lo tanto, estos servicios no deben ser utilizados a menos que se entienda completamente la funcionalidad exacta y la estructura de los parámetros. Por motivos de seguridad, estos servicios están explícitamente excluidos de services.yaml y no incluyen cadenas de traducción.

• Establecer área de alfombra: dreame_vacuum.vacuum_set_carpet_area
• Establecer tipo de alfombra: dreame_vacuum.vacuum_set_carpet_type
• Establecer cortina: dreame_vacuum.vacuum_set_curtain
• Establecer limpieza personalizada de alfombra: dreame_vacuum.vacuum_set_custom_carpet_cleaning
• Establecer material del suelo: dreame_vacuum.vacuum_set_floor_material
• Establecer muebles: dreame_vacuum.vacuum_set_furniture
• Establecer segmentos ocultos: dreame_vacuum.vacuum_set_hidden_segments
• Establecer Área Baja: dreame_vacuum.vacuum_set_low_lying_area
• Establecer Tipo de Mopa: dreame_vacuum.vacuum_set_mop_type
• Establecer Puntos Predefinidos: dreame_vacuum.vacuum_set_predefined_points
• Establecer Zonas Restringidas: dreame_vacuum.vacuum_set_restricted_zone
• Establecer Posición del Router: dreame_vacuum.vacuum_set_router_position
• Establecer Tipo de Segmento: dreame_vacuum.vacuum_set_segment_type
• Establecer Umbral: dreame_vacuum.vacuum_set_threshold
• Establecer Umbral Virtual: dreame_vacuum.vacuum_set_virtual_threshold
• Establecer Paredes: dreame_vacuum.vacuum_set_walls
• Fusionar habitaciones: dreame_vacuum.vacuum_merge_segments
• Dividir Habitación: dreame_vacuum.vacuum_split_segments