Render - Get Map Static Image

string

Número de versión de la API de Azure Maps. La versión actual es 2024-04-01.

number[]

Un rectángulo delimitador se define mediante dos latitudes y dos longitudes que representan los cuatro lados de un área rectangular en la Tierra. Formato: 'minLon, minLat, maxLon, maxLat' (en double).

Nota: bbox o center son parámetros obligatorios. Son mutuamente excluyentes. bbox no debe usarse con alto ni ancho.

Los intervalos máximos y mínimos permitidos para Lat y Lon se definen para cada nivel de zoom de la tabla en la parte superior de esta página.

number[]

Coordenadas del punto central en double. Formato: 'lon,lat'. Intervalo de longitud: -180 a 180. Intervalo de latitud: -90 a 90.

Nota: Los parámetros central o bbox son obligatorios. Son mutuamente excluyentes.

integer (int32)

Alto de la imagen resultante en píxeles. Oscila entre 80 y 1500. El valor predeterminado es 512. No se debe usar con bbox.

string

Idioma en el que se deben devolver los resultados de la búsqueda. Debe ser una de las etiquetas de idioma IETF admitidas, sin distinción entre mayúsculas y minúsculas. Cuando los datos del idioma especificado no están disponibles para un campo específico, se usa el idioma predeterminado.

Consulte idiomas admitidos para obtener más información.

string[]

Estilo de ruta de acceso y ubicaciones (en double). Use este parámetro para agregar opcionalmente líneas, polígonos o círculos a la imagen. El estilo de ruta de acceso describe la apariencia de la línea y el relleno. (Asegúrese de codificar correctamente la dirección URL de este parámetro, ya que contendrá caracteres reservados, como canalizaciones y puntuación).

El parámetro Path se admite en la SKU de la cuenta de Azure Maps a partir de S1. Varias instancias del parámetro path permiten especificar varias geometrías con sus estilos. El número de parámetros por solicitud está limitado a 10 y el número de ubicaciones está limitado a 100 por ruta de acceso.

Para representar un círculo con radio de 100 metros y punto central en latitud 45°N y longitud 122°W con el estilo predeterminado, agregue el parámetro querystring.

path=ra100||-122 45

Tenga en cuenta que la longitud viene antes de la latitud. Después de codificar la dirección URL, tendrá un aspecto similar al siguiente:

path=ra100%7C%7C-122+45

Todos los ejemplos aquí muestran el parámetro path sin codificación URL, para mayor claridad.

Para representar una línea, separe cada ubicación con un carácter de canalización. Por ejemplo, use

path=||-122 45|-119.5 43.2|-121.67 47.12

Se especifica un polígono con una ruta de acceso cerrada, donde los puntos primero y último son iguales. Por ejemplo, use

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

El valor de longitud de las ubicaciones de líneas y polígonos puede estar en el intervalo de -360 a 360 para permitir la representación de geometrías que cruzan el anti meridiano.

Modificadores de estilo

Puede modificar la apariencia de la ruta de acceso agregando modificadores de estilo. Estos se agregan antes de las ubicaciones. Cada uno de los modificadores de estilo tiene un nombre de dos letras. Estos nombres abreviados se usan para ayudar a reducir la longitud de la dirección URL.

Para cambiar el color del contorno, use el modificador de estilo 'lc' y especifique el color con el formato de color RGB HTML/CSS, que es un número hexadecimal de seis dígitos (no se admite el formulario de tres dígitos). Por ejemplo, para usar un color rosa profundo que especificaría como #FF1493 en CSS, use

path=lcFF1493||-122 45|-119.5 43.2

Se pueden combinar varios modificadores de estilo para crear un estilo visual más complejo.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

Resumen del modificador de estilo

string[]

Estilo y instancias de marcadores. Use este parámetro para agregar opcionalmente marcadores a la imagen. El estilo de marcadores describe la apariencia de los marcadores y las instancias especifican las coordenadas de los marcadores (en doble) y etiquetas opcionales para cada patilla. (Asegúrese de codificar correctamente la dirección URL de este parámetro, ya que contendrá caracteres reservados, como canalizaciones y puntuación).

La SKU de la cuenta de Azure Maps S0 solo admite una sola instancia del parámetro pins y el número de ubicaciones está limitado a 5 por patilla. Otras SKU permiten hasta 25 instancias del parámetro pins especificar varios estilos de patilla y el número de ubicaciones está limitado a 50 por patilla.

Para representar un marcador en latitud 45°N y longitud 122°W con el estilo de marcadores integrado predeterminado, agregue el parámetro querystring.

pins=default||-122 45

Tenga en cuenta que la longitud viene antes de la latitud. Después de codificar la dirección URL, tendrá un aspecto similar al siguiente:

pins=default%7C%7C-122+45

Todos los ejemplos aquí muestran el parámetro pins sin codificación url, para mayor claridad.

Para representar un pin en varias ubicaciones, separe cada ubicación con un carácter de canalización. Por ejemplo, use

pins=default||-122 45|-119.5 43.2|-121.67 47.12

La SKU de la cuenta de Azure Maps de S0 solo permite cinco marcadores. Otras SKU de cuenta no tienen esta limitación.

Modificadores de estilo

Puede modificar la apariencia de los pines agregando modificadores de estilo. Se agregan después del estilo, pero antes de las ubicaciones y etiquetas. Cada uno de los modificadores de estilo tiene un nombre de dos letras. Estos nombres abreviados se usan para ayudar a reducir la longitud de la dirección URL.

Para cambiar el color de la chincheta, use el modificador de estilo 'co' y especifique el color con el formato de color RGB HTML/CSS, que es un número hexadecimal de seis dígitos (no se admite el formulario de tres dígitos). Por ejemplo, para usar un color rosa profundo que especificaría como #FF1493 en CSS, use

pins=default|coFF1493||-122 45

Etiquetas de marcadores

Para agregar una etiqueta a las patillas, coloque la etiqueta entre comillas simples justo antes de las coordenadas. Evite usar caracteres especiales como | o || en la etiqueta. Por ejemplo, para etiquetar tres patillas con los valores '1', '2' y '3', use

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Hay un estilo de marcadores integrado denominado "none" que no muestra una imagen de marcadores. Puede usar esto si desea mostrar etiquetas sin ninguna imagen de anclaje. Por ejemplo

pins=none||'A'-122 45|'B'-119.5 43.2

Para cambiar el color de las etiquetas de marcadores, use el modificador de estilo de color de etiqueta 'lc'. Por ejemplo, para usar marcadores rosas con etiquetas negras, use

pins=default|coFF1493|lc000000||-122 45

Para cambiar el tamaño de las etiquetas, use el modificador de estilo de tamaño de etiqueta "ls". El tamaño de etiqueta representa el alto aproximado del texto de la etiqueta en píxeles. Por ejemplo, para aumentar el tamaño de la etiqueta a 12, use

pins=default|ls12||'A'-122 45|'B'-119 43

Las etiquetas se centran en el marcador 'label anchor'. La ubicación del delimitador está predefinida para marcadores integrados y está en el centro superior de marcadores personalizados (consulte a continuación). Para invalidar el delimitador de etiqueta, use el modificador de estilo "la" y proporcione coordenadas de píxeles X e Y para el delimitador. Estas coordenadas son relativas a la esquina superior izquierda de la imagen de marcadores. Los valores X positivos mueven el delimitador a la derecha y los valores Y positivos mueven el delimitador hacia abajo. Por ejemplo, para colocar el delimitador de etiqueta de 10 píxeles a la derecha y 4 píxeles por encima de la esquina superior izquierda de la imagen de marcadores, use

pins=default|la10 -4||'A'-122 45|'B'-119 43

Marcadores personalizados

Para usar una imagen de marcadores personalizada, use la palabra "custom" como nombre de estilo de patilla y, a continuación, especifique una dirección URL después de la información de ubicación y etiqueta. El tamaño máximo permitido para una imagen de etiqueta personalizada es de 65 536 píxeles. Use dos caracteres de canalización para indicar que ha terminado de especificar ubicaciones y está iniciando la dirección URL. Por ejemplo

pins=custom||-122 45||http://contoso.com/pushpins/red.png

Después de la codificación de direcciones URL, tendría el aspecto siguiente:

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

De forma predeterminada, las imágenes de marcadores personalizadas se dibujan centradas en las coordenadas de anclaje. Esto normalmente no es ideal, ya que oculta la ubicación que intenta resaltar. Para invalidar la ubicación de anclaje de la imagen de anclaje, use el modificador de estilo "an". Usa el mismo formato que el modificador de estilo de anclaje de etiqueta "la". Por ejemplo, si la imagen de anclaje personalizada tiene la punta del pin en la esquina superior izquierda de la imagen, puede establecer el delimitador en ese punto mediante

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

Nota: Si usa el modificador de color 'co' con una imagen de marcadores personalizada, el color especificado reemplazará los canales RGB de los píxeles de la imagen, pero dejará el canal alfa (opacidad) sin cambios. Normalmente, esto solo se haría con una imagen personalizada de color sólido.

Escala, rotación y opacidad

Puede hacer que las marcadores y sus etiquetas sean más grandes o más pequeñas mediante el modificador de estilo de escala "sc". Se trata de un valor mayor que cero. Un valor de 1 es la escala estándar. Los valores mayores que 1 harán que las patillas sean más grandes y los valores menores que 1 los harán más pequeños. Por ejemplo, para dibujar los marcadores 50% más grandes de lo normal, use

pins=default|sc1.5||-122 45

Puede girar marcadores y sus etiquetas mediante el modificador de estilo de rotación "ro". Se trata de un número de grados de rotación en sentido de las agujas del reloj. Use un número negativo para girar en sentido contrario a las agujas del reloj. Por ejemplo, para girar las marcadores de 90 grados en el sentido de las agujas del reloj y duplicar su tamaño, use

pins=default|ro90|sc2||-122 45

Puede hacer que las marcadores y sus etiquetas sean parcialmente transparentes especificando el modificador de estilo alfa 'al'. Se trata de un número comprendido entre 0 y 1 que indica la opacidad de los marcadores. Cero hace que sean completamente transparentes (y no visibles) y 1 los hace completamente opacos (que es el valor predeterminado). Por ejemplo, para crear marcadores y sus etiquetas solo 67% opaco, use

pins=default|al.67||-122 45

Resumen del modificador de estilo

• Las coordenadas X e Y pueden estar en cualquier lugar dentro de la imagen de anclaje o un margen alrededor de ella. El tamaño del margen es el mínimo del ancho y alto del pin.

TilesetId

Estilo de mapa que se va a devolver. Los valores posibles son microsoft.base.road, microsoft.base.darkgrey y microsoft.imagery. El valor predeterminado se establece en microsoft.base.road. Para obtener más información, vea Render TilesetId.

TrafficTilesetId

Valor opcional, que indica que no se superpone ningún flujo de tráfico en el resultado de la imagen. Los valores posibles son microsoft.traffic.relative.main y none. El valor predeterminado no es ninguno, lo que indica que no se devuelve ningún flujo de tráfico. Si se proporciona tilesetId relacionado con el tráfico, devolverá la imagen de mapa con la capa de tráfico correspondiente. Para obtener más información, vea Render TilesetId.

LocalizedMapView

El parámetro View (también denominado parámetro "user region") permite mostrar los mapas correctos para un determinado país o región para regiones geopolíticamente disputadas. Los distintos países o regiones tienen vistas diferentes de estas regiones y el parámetro View permite que la aplicación cumpla con la vista requerida por el país o región a la que va a servir la aplicación. De forma predeterminada, el parámetro View se establece en "Unified" incluso si no lo ha definido en la solicitud. Es su responsabilidad determinar la ubicación de los usuarios y, a continuación, establecer el parámetro View correctamente para esa ubicación. Como alternativa, tiene la opción de establecer "View=Auto", que devolverá los datos del mapa en función de la dirección IP de la solicitud. El parámetro View de Azure Maps debe usarse de conformidad con las leyes aplicables, incluidas las relativas a la asignación, del país o región en el que los mapas, imágenes y otros datos y contenido de terceros a los que está autorizado para acceder a través de Azure Maps está disponible. Ejemplo: view=IN.

Consulte vistas admitidas para obtener más información y ver las vistas disponibles.

integer (int32)

Ancho de la imagen resultante en píxeles. Oscila entre 80 y 2000. El valor predeterminado es 512. No se debe usar con bbox.

integer (int32)

Nivel de zoom deseado del mapa. Compatibilidad con el intervalo de valores de zoom entre 0 y 20 (inclusive) para tilesetId es microsoft.base.road o microsoft.base.darkgrey. Admite el intervalo de valores de zoom entre 0 y 19 (inclusive) para tilesetId que es microsoft.imagery. El valor predeterminado es 12.

Para obtener más información, vea niveles de zoom y cuadrícula de mosaico.