Skip to main content

Map

Use Map to display a map on a page. This component is useful for displaying a map of a location, such as a store or a customer’s address.

string

A label that describes the purpose or contents of the map.

When set, it will be announced to users using assistive technologies and will provide them with more context.

string

A valid API key for the map service provider.

The map service provider may require an API key. Without an API key the map could be hidden or render in a limited developer mode.

Default: 'auto'

Adjust the block size.

string

A unique identifier for the element.

Default: 'auto'

Adjust the inline size.

number
Default: 0

Map center’s latitude in degrees.

number
Default: 0

Map center’s longitude in degrees.

Default: 'none'

Adjust the maximum block size.

Default: 'none'

Adjust the maximum inline size.

number
Default: 18

The maximum zoom level which will be displayed on the map.

Valid zoom values are numbers from zero up to 18.

Default: '0'

Adjust the minimum block size.

Default: '0'

Adjust the minimum inline size.

number
Default: 0

The minimum zoom level which will be displayed on the map.

Valid zoom values are numbers from zero up to 18.

number
Default: 4

The initial Map zoom level.

Valid zoom values are numbers from zero up to 18. Larger zoom values correspond to a higher resolution.

Was this section helpful?

((event: <typeof tagName>) => void) | null

Callback when the viewport bounds have changed or the map is resized.

((event: <typeof tagName>) => void) | null

Callback when the user clicks on the map.

((event: <typeof tagName>) => void) | null

Callback when the user double-clicks on the map.

((event: <typeof tagName>) => void) | null

Callback when the map view changes.

Was this section helpful?

Use MapMarker to display a marker on a map. Use only as a child of s-map component.

string

A label that describes the purpose of the marker. When set, it will be announced to users using assistive technologies and will provide them with more context.

boolean
Default: false

Allows grouping the marker in clusters when zoomed out.

number
Default: 0

Marker’s location latitude in degrees.

number
Default: 0

Marker’s longitude latitude in degrees.

Was this section helpful?

((event: <typeof tagName>) => void) | null

Callback when a marker is clicked.

It does not trigger a click event on the map itself.

Was this section helpful?

HTMLElement

The graphic to use as the marker.

If unset, it will default to the provider’s default marker.

Was this section helpful?

Code

<s-map apikey="YOUR_API_KEY" latitude="51.5074" longitude="-0.1278">
<s-map-marker latitude="51.5074" longitude="-0.1278"></s-map-marker>
</s-map>

Preview