Render - Get Map Image

RasterTileFormat

Formato deseado de la respuesta. Valor posible: png.

string

Número de versión de la API de Azure Maps.

number[]

Rectángulo de límite. Proyección usada: EPSG:3857. Formato: 'minLon, minLat, maxLon, maxLat'.

Nota: bbox o center son parámetros obligatorios. Son mutuamente excluyentes. No se debe usar con alto o ancho.

Los intervalos máximos 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. Formato: 'lon,lat'. Proyección usada

• EPSG:3857. Intervalo de longitud: -180 a 180. Intervalo de latitud: -85 a 85.

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

integer (int32)

Alto de la imagen resultante en píxeles. El intervalo es de 1 a 8192. 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.

StaticMapLayer

Capa de mapa solicitada. Si la capa está establecida en etiquetas o híbridas, el formato debe ser png.

string[]

Estilo y ubicaciones de ruta de acceso. 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

Para representar un polígono, la última ubicación debe ser igual a la ubicación inicial. Por ejemplo, use

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

Los valores de longitud y latitud para las ubicaciones de líneas y polígonos pueden 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

Obtención de ubicaciones de ruta de acceso desde Azure Maps Data Storage

Para todas las SKU de cuenta de Azure Maps distintas de S0, la información de ubicación de la ruta de acceso se puede obtener de Azure Maps Data Storage. Después de cargar un documento GeoJSON que contiene ubicaciones de ruta de acceso, el servicio Almacenamiento de datos devuelve un identificador de datos único (UDID) que puede usar para hacer referencia a los datos en el parámetro path.

Para usar la geometría de punto desde un documento GeoJSON cargado como ubicaciones de ruta de acceso, especifique el UDID en la sección locations del parámetro path. Por ejemplo

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenga en cuenta que no se permite mezclar ubicaciones de ruta de acceso desde Data Storage con ubicaciones especificadas en el parámetro path.

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 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. Otras SKU permiten que varias instancias del parámetro pins especifiquen varios estilos de 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. 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. 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.

Obtención de marcadores de Azure Maps Data Storage

Para todas las SKU de cuenta de Azure Maps distintas de S0, la información de ubicación de marcadores se puede obtener de Azure Maps Data Storage. Después de cargar un documento GeoJSON que contiene ubicaciones de anclaje, el servicio Almacenamiento de datos devuelve un identificador de datos único (UDID) que puede usar para hacer referencia a los datos en el parámetro pins.

Para usar la geometría de punto desde un documento GeoJSON cargado como ubicaciones de anclaje, especifique UDID en la sección locations del parámetro pins. Por ejemplo

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Tenga en cuenta que solo se usará la geometría de punto y multipunto, los puntos y los puntos de las colecciones de geometría y la geometría de punto de las características. Se omitirá la geometría linestring y polygon. Si el punto procede de una característica y la característica tiene una propiedad de cadena denominada "label", el valor de esa propiedad se usará como etiqueta para la patilla.

Puede mezclar ubicaciones de anclaje desde Data Storage y ubicaciones de anclaje especificadas en el parámetro pins. Cualquiera de las ubicaciones de patillas delimitadas por canalización puede ser una longitud y latitud o UDID. Por ejemplo

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

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.

MapImageStyle

Estilo de mapa que se va a devolver. Los valores posibles son main y dark.

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. El intervalo es de 1 a 8192. El valor predeterminado es 512. No se debe usar con bbox.

integer (int32)

Nivel de zoom deseado del mapa. El valor de zoom debe estar en el intervalo: 0-20 (incluido). El valor predeterminado es 12.

Consulte niveles de zoom y de cuadrícula de mosaico para obtener más información.