Field map

Version: Pro.

Why this type

Coordinates and address for contact_map sections. Enrich builds embed and maps link. Flat map_* when type=map or name contains map.

When to use

• Office on contact_map landing
• Single delivery or pickup point
• Geo block next to form

Tips

Multiple points use repeater with lat lng text or custom. Output embed from enrich, do not hand-build URL.

Similar types

• text for address without coordinates
• url for manual maps.google link

Schema

{
  "name": "location",
  "type": "map",
  "label": "Map",
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Object { lat, lng, zoom, provider }; enrich adds embed_url on the object and flat map_embed_url.

Section data

Key location in the section data after save enrich (MapEmbedResolver):

{
  "location": {
    "lat": 55.751244,
    "lng": 37.618423,
    "zoom": 14,
    "provider": "yandex",
    "embed_url": "https://yandex.ru/map-widget/v1/?ll=37.618423%2C55.751244&z=14&pt=37.618423%2C55.751244%2Cpm2rdm&l=map",
    "watch_url": "https://yandex.ru/maps/?ll=37.618423%2C55.751244&z=14&pt=37.618423%2C55.751244%2Cpm2rdm&l=map"
  },
  "map_embed_url": "https://yandex.ru/map-widget/v1/?ll=37.618423%2C55.751244&z=14&pt=37.618423%2C55.751244%2Cpm2rdm&l=map",
  "map_provider": "yandex",
  "map_watch_url": "https://yandex.ru/maps/?ll=37.618423%2C55.751244&z=14&pt=37.618423%2C55.751244%2Cpm2rdm&l=map"
}

• Flat map_embed_url, map_provider, and map_watch_url duplicate the embed of the first map field (priority for key location).
• Default provider yandex; osm is OpenStreetMap.

Chunk example

<iframe src="{$location.embed_url|default($map_embed_url)|escape}" title="Map"></iframe>

Common properties

For fields with name that are stored in the section data:

Key	Type	Role	CMP
tab	string	Group subtitle in the inspector	yes
width	25–100	Field width as % of the row (flex)	yes
description	string	Hint under the label	yes
default	any	Initial value for a new section	yes
active	bool	false hides the field in the inspector	yes
required	bool	Required on publish (draft still saves)	yes

• Also: enrich adds embed_url, watch_url, and flat map_* to section.data.

See fields overview.

See also

• Field types reference
• Fields overview
• Pro in manager