convertMapToVirtualPixelCoord

Descripción

Convierte un conjunto especificado de coordenadas de mapa en coordenadas en el espacio de píxel virtual de una imagen de mapa completa, y las devuelve.

Nota: No se debe confundir las coordenadas en el espacio de píxel virtual de la imagen de mapa completa con las coordenadas de píxeles de la pantalla normal. Las coordenadas de píxeles de pantalla normal comienzan siempre con (0, 0) en la esquina superior izquierda de la pantalla, independientemente de qué sección de la imagen de mapa completa se está mostrando actualmente en la pantalla. Por el contrario, el espacio de píxeles virtuales de la imagen de mapa es constante en cualquier nivel de zoom particular, independientemente de qué parte del mapa se esté mostrando actualmente en la pantalla. Así, por ejemplo, si una imagen de mapa se ajusta en nivel de zoom 3, la imagen de mapa se compone de 4 mosaicos dispuestos horizontalmente y 4 mosaicos dispuestos verticalmente. Si cada mosaico tiene dimensiones de 512 por 256 píxeles, las dimensiones de la imagen de mapa completa son 2048 por 1024 píxeles. Esto se conoce como el espacio de píxeles virtual de la imagen de mapa, debido a que puede mostrarse solamente una subsección de la imagen completa en la pantalla en forma simultánea.

Parámetros

Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.

Parámetro	Tipo	Requerido	Descripción
worldX	Float	sí	Especifica la coordenada x de la ubicación del punto del mapa. La ubicación del mapa se especifica en los términos de las unidades del sistema de coordenadas del mapa (por ejemplo, grados o metros). Puede determinar el sistema de coordenadas del mapa convocando el método convertScreenToMapCoord y examinando el objeto MapCoordinate devuelto. Para obtener más información, consulte convertScreenToMapCoord y también MapCoordinate.
worldY	Float	sí	Especifica la coordenada y de la ubicación del punto del mapa. La ubicación del mapa se especifica en los términos de las unidades del sistema de coordenadas del mapa (por ejemplo, grados o metros). Puede determinar el sistema de coordenadas del mapa convocando el método convertScreenToMapCoord y examinando el objeto MapCoordinate devuelto. Para obtener más información, consulte convertScreenToMapCoord y también MapCoordinate.
level	Integer	sí	Especifica el nivel de zoom del mapa. Este parámetro se debe establecer en un valor superior o igual al valor minLevel e inferior o igual al valor maxLevel del mapa con nombre asignado. Puede determinar estos valores convocando el método getDescription y examinando el objeto MapDescription devuelto. Para obtener más información, consulte getDescription y también MapDescription.
nombre	Cadena	sí	Especifica del nombre del mapa con nombre asignado desde el cual se generan los mosaicos de mapas.
output	Cadena	sí	Especifica el formato de respuesta. Debe ser json.

Ejemplo


http://<server>:<port>/rest/Spatial/LegacyMapTilingService/convertMapToVirtualPixelCoord?
  name=/NamedTiles/WorldTile
  &level=4
  &worldX=-79.377366
  &worldY=43.64713
  &output=json

El ejemplo anterior devolverá el siguiente objeto de respuesta JSON:


{"EnvinsaResponse":{"type":"MapTilingResponse","virtualPixelCoord":{"virtualX":1023,"virtualY":1023}}}

Devolución

Un objeto VirtualPixelCoordinate tal como se observó en el ejemplo anterior. Consulte VirtualPixelCoordinate.