Mapový blok: Zobrazte místo, aniž byste skryli adresu

Mapový blok pomáhá návštěvníkovi pochopit, kde se reálné místo nachází, a přejít od čtení k navigaci. Jeho trvalým obsahem je ověřená adresa v HTML; vizuální mapa je volitelná orientační pomůcka. Výchozí implementace rezervuje prostor pro mapu, zobrazí lehkou statickou záložní variantu a načte schváleného interaktivního poskytovatele až poté, co o to návštěvník požádá.

Národní galerie
Trafalgar Square, London WC2N 5DN, Velká Británie
Mapa nenačtena. Otevřete místo ve své mapové aplikaci nebo aktivujte Načíst interaktivní mapu, když potřebujete prozkoumat okolní ulice.

Tato vykreslená fasáda je užitečná ještě před jakýmkoli požadavkem třetí straně. Uvádí název místa, zpřístupňuje adresu jako vybratelný text, vysvětluje nenačtený stav a poskytuje dvě jasné cesty: otevřít externí mapu nebo záměrně načíst vloženou mapu.

Proč na tomto prvku záleží

Otázky ohledně místa jsou praktické. Návštěvník může zvažovat, zda je pobočka dostatečně blízko, kontrolovat, na které straně železniční tratě se nachází, hledat správný vchod nebo porovnávat veřejnou dopravu s parkováním. Mapa snižuje mentální úsilí potřebné k převedení neznámé adresy do prostorového kontextu. Dokáže zpřehlednit okolní orientační body a uspořádání ulic rychleji než odstavec textu.

Toto pohodlí však neznamená, že je mapa zdrojem pravdy. Návštěvníci si mohou adresu zkopírovat, poslat ji jiné osobě nebo ji číst pomocí asistenční technologie. Mapové dlaždice tyto úkony spolehlivě nepodporují a slabá data, nastavení soukromí nebo selhání poskytovatele jim mohou zabránit. Adresa musí zůstat použitelná i bez mapy.

Vložená mapa může přidat iframe, JavaScript, písma, obrázky a požadavky třetím stranám. Tyto zdroje soutěží s odpovědí stránky a mohou odhalit IP adresu nebo iniciovat ukládání dat podléhající souhlasu. Návštěvník, který mapu nikdy nepoužije, by za to neměl platit.

Strojová extrahovatelnost znamená, že software dokáže identifikovat místo bez interpretace mapových pixelů nebo spouštění poskytovatele. Vyhledávací crawlery, AI systémy, čtečky obrazovky, překladové nástroje a lokální datové pipeliny potřebují název místa, úplnou poštovní adresu, souřadnice (tam, kde je to řízeno) a stabilní odkaz na cíl v HTML nebo strukturovaných polích. URL iframe není spolehlivá adresa. Popisky poskytovatele se mohou změnit a piny mohou být mírně posunuté. Stejný záznam o ověřeném místě by měl napájet viditelnou adresu, značku na mapě, navigační odkaz a případná strukturovaná data.

Platí pravidla pro psaní prvků : vybírejte typový prvek podle účelu, nikoli podle vzhledu. Pokud je účelem prostorová orientace kolem jednoho ověřeného místa, použijte mapový blok. Pokud je účelem zveřejnit kontaktní údaje, použijte blok s otevírací dobou a kontakty nebo blok NAP a nechte mapu čerpat ze stejného záznamu adresy. Pokud je účelem rezervace času, použijte blok pro rezervace .

Kdy jej použít

Mapový blok použijte, když vidět místo v jeho okolí pomáhá čtenáři dokončit úkol závislý na lokalitě. Typické použití zahrnuje obchod, kancelář, kliniku, místo konání, výdejní místo, showroom, hotel, atrakci, pobočku, vchod na akci nebo hranici oblasti služeb. Je zvláště užitečný, když se vchod liší od poštovní adresy, okolní silnice jsou matoucí, přístupové trasy potřebují vysvětlení nebo veřejná doprava a parkování ovlivňují návštěvu.

Ověřte značku podle skutečného vchodu nebo místa poskytování služby, namísto přijetí prvního výsledku geokódování od poskytovatele. U místa uvnitř větší budovy uveďte v textu patro, jednotku nebo vchod.

Mezní případy často vytvářejí atraktivní, ale neužitečné mapy:

• Seznam obsluhovaných měst: toto je prohlášení o oblasti služeb, nikoli důkaz o fyzickém místě. Neumisťujte piny do center měst a nenaznačujte tím existenci kanceláří.
• Poštovní adresa bez možnosti návštěvy: zveřejněte poštovní údaje a uveďte, že návštěva není možná. Mapa by implikovala nepodloženou akci příjezdu.
• Vzdálená nebo pouze online společnost: sídlo společnosti může být právně relevantní, ale nestává se cílem zákazníků jen proto, že ho lze lokalizovat pomocí vložené mapy.
• Navigační instrukce krok za krokem: odkažte na navigačního poskytovatele a poskytněte poznámky specifické pro trasu. Statická vložená mapa nemůže zohlednit dopravu, uzavírky ani výchozí bod návštěvníka.
• Mnoho lokalit: použijte vyhledávač míst s textovým seznamem výsledků. Mrak pinů nemůže nahradit jednotlivé stránky poboček.
• Důkaz o místní přítomnosti: mapa není důkazem, že zde tým skutečně působí. Podpořte tvrzení konzistentní identitou, adresou, kontaktem, otevírací dobou a obsahem specifickým pro pobočku.
• Dekorativní geografický kontext: pokud lokalita neovlivňuje úkol, mapu vynechejte. Panorama města nebo regionální obrys patří k jinému vizuálnímu účelu.

Kam ji umístit

Mapu umístěte bezprostředně za název místa, úplnou adresu a případný kvalifikátor návštěvy. Na stránce místa je obvyklé pořadí: úvod, adresa a kontaktní údaje, mapa, pokyny k příjezdu, otevírací doba, poté akce návštěvy nebo rezervace. Pokud jsou hlavní odpovědí pokyny k příjezdu, shrňte je před mapou.

Udržujte adresu, mapovou fasádu, ovládání načítání, záložní odkaz, popisek a poznámku k pokynům v jedné označené oblasti. Návštěvník by neměl muset procházet sekcí s referencemi nebo marketingem, aby našel adresu patřící k pinu. Odkaz „Získat trasu“ musí používat stejné souřadnice nebo identifikátor místa jako zobrazená značka.

Blok může být umístěn poblíž otevírací doby stejné pobočky, ale ne vedle konfliktní adresy, jiné mapy, automaticky přehrávaného videa nebo reklamy stylizované jako ovládací prvek. Neumisťujte jej do karuselu, accordionu, povinného modálního okna, skryté záložky nebo úzké buňky tabulky.

Neumisťujte mapu mezi varování a instrukci, ke které se vztahuje, ani mezi rezervační akci a její předpoklady. Nikdy nepřekrývejte základní text adresy, znění souhlasu nebo jediný odkaz na pokyny k příjezdu mapovými dlaždicemi. Na mobilu dodržujte toto pořadí čtení: název místa, adresa, kvalifikátor návštěvy, záložní řešení, ovládání načítání, oblast mapy, poté pokyny.

Anatomie

1. Název místa: identifikuje pobočku, místo konání nebo cíl reprezentovaný značkou.
2. Úplná textová adresa: obsahuje všechny řádky adresy, lokalitu, PSČ a zemi potřebné k odlišení místa.
3. Kvalifikátor návštěvy: uvádí vchod, jednotku, patro, požadavek na rezervaci, omezení pro návštěvníky nebo informaci o přístupnosti, pokud mění způsob příjezdu.
4. Rezervované viewport: fixuje šířku a poměr stran před načtením interaktivních zdrojů, čímž zabraňuje pohybu rozvržení.
5. Statická záložní varianta: poskytuje užitečný prostorový kontext bez skriptů; před odkazem na ni musí být skutečně vygenerovaným assetem.
6. Značka (marker): reprezentuje ověřený bod příjezdu, nikoli pouze PSČ nebo administrativní centroid.
7. Ovládání načítání: je skutečné tlačítko s konkrétním přístupným názvem, například „Načíst interaktivní mapu pro Národní galerii“.
8. Informace o poskytovateli: uvádí název třetí strany a vysvětluje, že aktivace může navázat spojení s ní.
9. Odkaz na trasu: otevírá stabilní HTTPS cíl pro navigaci bez nutnosti používat vložený přehrávač.
10. Popisek nebo poznámka k orientačnímu bodu: vysvětluje užitečný závěr mapy, například že vchod směřuje do pojmenované ulice.
11. Záznam o místě: poskytuje rendereru řízené souřadnice, identifikátor místa a datum ověření.
12. Stav selhání: zachovává adresu, odkaz na trasu a možnost opakování, pokud se poskytovatel nenačte.

Příklady provedení

Každá varianta ponechává adresu v HTML, rezervuje rozměry mapy a poskytuje přímý odkaz na trasu. Mění se pouze chování načítání.

Statická mapa s externími pokyny — nejnižší náklady

Použijte optimalizovaný obrázek mapy, když orientace pomáhá, ale posouvání a přibližování není nutné. Alternativní text uvádí její prostorový závěr; popisek nese orientační body. Cestu publikujte až poté, co asset existuje.

Interaktivní mapa na kliknutí — výchozí

Nejprve zobrazte statickou záložní variantu nebo neutrální rezervovaný panel. Tlačítko načte schválený iframe po explicitní aktivaci. Tím se chrání rychlost stránky a spojení s třetí stranou je záměrné, přičemž posouvání, přibližování a prohlížení ulic zůstává na vyžádání k dispozici.

Mapa vyžadující souhlas

Použijte, pokud zásady ochrany soukromí webu vyžadují souhlas před kontaktováním poskytovatele. Vysvětlete důsledky prostým jazykem a nabídněte odkaz na trasu bez nutnosti souhlasu. Odmítnutí nesmí skrýt adresu ani znemožnit fungování zbytku stránky.

Vždy načtená interaktivní mapa — měřená výjimka

Používejte pouze tehdy, když je interakce klíčová, kontakt s poskytovatelem je povolen a měření v terénu akceptuje náklady. Líné načítání (lazy loading) může stále inicializovat, jakmile se návštěvník přiblíží. Udržujte záložní variantu vykreslenou na serveru, protože loading="lazy" nemůže zabránit selhání poskytovatele.

Blok jedné lokality uvnitř lokátoru

Pro stránku s více lokalitami spárujte vybranou mapu s textovým seznamem výsledků. Načtení jedné vybrané pobočky udržuje interakci srozumitelnou; změna výběru aktualizuje název místa, adresu, značku a odkaz na trasu společně. Seznam zůstává použitelný i bez mapy.

Parametry

„Zdroj“ označuje, odkud renderer získává autorovanou hodnotu. Autoritativní systém míst zůstává odpovědný za ověření skutečné adresy a souřadnic.

Renderer musí vytvářet URL poskytovatelů z povolených identifikátorů a číselných souřadnic. Autoři nesmí vkládat libovolný HTML iframe, API klíče, přístupové tokeny nebo JavaScript do těla stránky. Šest desetinných míst lokalizuje bod s mnohem vyšší přesností, než návštěvník obvykle potřebuje; ponechejte méně číslic, pokud by zveřejnění přesného soukromého vchodu představovalo bezpečnostní riziko nebo riziko pro soukromí.

Syntaxe a příklady kódu

Tyto přenosné příklady popisují jeden kanonický obsahový model. Projekt musí implementovat a otestovat odpovídající renderer, než autoři začnou syntaxi používat v produkci.

Přenosná Markdown direktiva

:::map{variant=facade place-id="north-street-clinic" latitude=51.454514 longitude=-2.587910 zoom=16 aspect-ratio="4/3" provider=osm directions-url="https://www.openstreetmap.org/directions?to=51.454514,-2.587910" verified=2026-08-27}
## North Street Clinic

18 North Street, Bristol BS1 3PR, United Kingdom

Use the courtyard entrance beside the pharmacy. Step-free access is available from North Street.
:::

První nadpis poskytuje title; další řádek poskytuje strukturovanou adresu; zbývající tělo poskytuje popisek nebo poznámku k příjezdu.

Mapování na Hugo shortcode

Používejte pouze pojmenované parametry. Tento zápis dokumentuje zamýšlený adaptér; netvrdí, že mapový shortcode již v tomto repozitáři existuje.

{{< map variant="facade" placeId="north-street-clinic" latitude="51.454514" longitude="-2.587910" zoom="16" aspectRatio="4/3" provider="osm" directionsUrl="https://www.openstreetmap.org/directions?to=51.454514,-2.587910" verified="2026-08-27" >}}
## North Street Clinic

18 North Street, Bristol BS1 3PR, United Kingdom

Use the courtyard entrance beside the pharmacy. Step-free access is available from North Street.
{{< /map >}}

Adaptér musí rezervovat poměr stran, vykreslit adresu a záložní variantu na serveru a vytvořit iframe až po deklarovaném spouštěči. Nikdy nesmí vystavit API klíč poskytovatele v autorovaném obsahu.

WordPress blok

<!-- wp:amicited/map {"variant":"facade","placeId":"north-street-clinic","latitude":51.454514,"longitude":-2.587910,"zoom":16,"aspectRatio":"4/3","provider":"osm","directionsUrl":"https://www.openstreetmap.org/directions?to=51.454514,-2.587910","verified":"2026-08-27"} -->
<h2>North Street Clinic</h2>
<address>18 North Street, Bristol BS1 3PR, United Kingdom</address>
<p>Use the courtyard entrance beside the pharmacy. Step-free access is available from North Street.</p>
<!-- /wp:amicited/map -->

Nativní blok by měl ukládat souřadnice jako čísla, udržovat pole adresy strukturovaná, validovat poskytovatele a vykreslovat bezpečnou serverovou fasádu. Náhled v editoru může zobrazit statickou reprezentaci namísto inicializace plného poskytovatele.

Dobré a špatné příklady

Dobrý

North Street Clinic
18 North Street, Bristol BS1 3PR, Velká Británie
Použijte vchod do dvora vedle lékárny. Bezbariérový přístup je k dispozici z ulice North Street.
Načíst interaktivní mapu · Otevřít trasu v mapové aplikaci

Toto funguje, protože návštěvník může místo identifikovat, zkopírovat si adresu a navigovat k němu bez vložené mapy. Poznámka o vchodu řeší skutečnou nejednoznačnost příjezdu. Načtení třetí strany je volba a obě akce jasně uvádějí, co se stane.

Špatný

Najdete nás zde!
[celošířková interaktivní mapa s neoznačeným pinem]

Toto selhává, protože „zde“ neidentifikuje místo, adresa existuje pouze v pixelech poskytovatele a pin může představovat PSČ namísto vchodu. Mapa načtená ihned přidává náklady i pro návštěvníky, kteří ji nepoužívají. Není zde žádné záložní řešení, datum ověření, poznámka k příjezdu ani přístupný navigační odkaz. Přidání adresy do atributu title iframe by zlepšilo popisek rámu, ale nevytvořilo by vybratelný text na stránce.

Schema markup a přístupnost

Mapový blok nemá žádný vyhrazený typ Schema.org. Ověřená pole mohou napájet příslušný Organization, podtyp LocalBusiness, Place, PostalAddress nebo GeoCoordinates, pokud stránka tuto entitu reprezentuje. Používejte jeden sdílený záznam o místě; viditelná adresa, značka, kanonická URL pobočky a JSON-LD musí být v souladu.

Nepřidávejte hasMap pouze proto, aby stránka působila úplněji. Pokud je použit, měl by odkazovat na stabilní URL mapy pro stejné místo, nikoli na expirující session URL nebo endpoint iframe s odhaleným klíčem. Firma poskytující služby v určité oblasti bez veřejného místa pro zákazníky by měla svou oblast služeb popsat poctivě a nesmí zveřejňovat vymyšlené provozovny nebo příliš přesné soukromé souřadnice.

Přístupnost začíná nezávislostí na mapě. Umístěte název místa a úplnou adresu do HTML, přičemž <address> používejte pouze pro relevantní kontaktní údaje. Poskytněte běžný odkaz na trasu. Popište vchody, orientační body, veřejnou dopravu, parkování a bezbariérový přístup v textu. Alternativní text statické mapy by měl sdělovat užitečný závěr, nikoli vyjmenovávat každou ulici.

Ovládání načítání musí být klávesnicově ovladatelné <button> s viditelným fokusem a přístupným názvem spojeným s místem. Načítání nesmí neočekávaně přesunout fokus. Po aktivaci oznamte krátký stav, například „Interaktivní mapa načtena“, poté ponechte fokus na iniciujícím ovládacím prvku nebo jej přesuňte pouze tehdy, má-li rozhraní zdokumentovaný klávesový vstupní bod. Každému iframe přiřaďte jedinečný titulek, například „Interaktivní uliční mapa pro North Street Clinic.“

Ovládací prvky poskytovatele musí zůstat ovladatelné při úzkých šířkách a 200% přiblížení. Nezachycujte klávesový fokus uvnitř iframe. Nespoléhejte se na barvu pinu, přetahování gesty, najetí myší nebo vizuální popisky ulic pro důležité informace. Pokud mapa selže nebo je souhlas odmítnut, udržujte rezervovanou oblast stabilní a zpřístupněte adresu, poznámku k příjezdu, externí odkaz na trasu a možnost opakování.

Pravidla pro psaní

Začněte oficiálním veřejným názvem místa o délce dvou až deseti slov. Následujte úplnou poštovní adresou uloženou v řízeném záznamu o místě. Nezkracujte jednotku, budovu, lokalitu nebo PSČ potřebné k nalezení správného vchodu. Uveďte zemi, pokud stránka může přijímat mezinárodní návštěvnost nebo pokud je název města nejednoznačný.

Přidejte jednu poznámku k příjezdu o délce 8–35 slov pouze tehdy, pokud mění to, co by měl návštěvník udělat. Uveďte trvalý orientační bod nebo vztah ke vchodu: „Použijte vchod do dvora vedle lékárny“ je užitečné; „Nepřehlédnete nás“ není. Časově omezené uzavírky silnic, stavební objížďky a dočasné vchody vyžadují vlastníka a datum kontroly jinde v obsahovém systému.

Používejte jeden mapový blok pro jeden vybraný cíl. Lokátor může tento cíl přepínat, ale každý vybraný stav musí atomicky aktualizovat název, adresu, značku, popisek a odkaz. Ve výchozím nastavení zobrazte jednu primární značku. Sekundární orientační body se mohou objevit pouze tehdy, když vysvětlují příjezd a jsou vizuálně odlišitelné v textu i ovládacích prvcích.

Popisky ovládacích prvků udržujte doslovné: „Načíst interaktivní mapu“, „Otevřít trasu“ a „Zobrazit přístupný vchod.“ Vyhněte se vágním popiskům jako „Prozkoumat“, „Zobrazit více“ nebo „Klikněte zde.“ Uveďte poskytovatele před aktivací, pokud má spojení dopady na soukromí.

Nikdy neumisťujte telefonní čísla, otevírací dobu, propagační tvrzení, recenze, ceny, rezervační formuláře nebo dlouhé informace o parkování do interaktivního plátna. Tyto skutečnosti patří do HTML a do vlastních typových prvků. Nikdy nezveřejňujte API klíč, aktuální polohu uživatele, soukromý obytný vchod, falešné kancelářské piny, neověřené oblasti služeb nebo souřadnice zkopírované z nekontrolovaného geokodéru. Mapa nesmí implikovat možnost návštěvy tam, kde neexistuje.

Ověřte adresu a značku při publikaci, po změně místa a během plánované kontroly. Silnice a popisky poskytovatele se mohou měnit nezávisle; organizace stále nese odpovědnost za přesnost svého záznamu o místě a pokynů k příjezdu.

Typy příspěvků, které jej používají

Pole postTypes v front matter je zdrojem této implementační matice.

Kontrolní seznam QA

• Název místa a úplná adresa jsou uvedeny jako vybratelný text vykreslený na serveru mimo mapu.
• Značka ukazuje na ověřený veřejný bod příjezdu, nikoli na PSČ nebo centroid budovy.
• Adresa, souřadnice, identifikátor místa, odkaz na trasu a strukturovaná data pocházejí ze stejného řízeného záznamu.
• Blok vysvětluje jakoukoli jednotku, patro, vchod, požadavek na rezervaci nebo přístupovou trasu potřebnou k příjezdu.
• Výchozí implementace se vyhýbá požadavkům třetím stranám až do explicitní aktivace nebo platného souhlasu.
• Výjimka s vždy načtenou mapou má zdokumentovaný účel, právní základ a změřený výkonnostní rozpočet.
• Šířka a poměr stran jsou rezervovány před načtením obrázku, iframe nebo kódu poskytovatele.
• Cesta ke statickému obrázku ukazuje na skutečný schválený asset a má užitečný alternativní text.
• Ovládání načítání je tlačítko s přístupným názvem specifickým pro místo a viditelným fokusem.
• Iframe, pokud je vytvořen, má jedinečný popisný titulek a nezachycuje klávesový fokus.
• Adresa, odkaz na trasu, poznámka k příjezdu a možnost opakování zůstávají použitelné, když selžou skripty, souhlas nebo poskytovatel.
• Důležité informace nezávisí na barvě pinu, najetí myší, přetahování, přiblížení nebo popiscích mapy.
• Rozvržení funguje při úzkých šířkách a 200% přiblížení, aniž by zakrývalo ovládací prvky poskytovatele.
• Stránka netvrdí existenci veřejné kanceláře, vchodu nebo oblasti služeb, kterou organizace nemůže ověřit.
• V autorovaném obsahu se nevyskytují žádné API klíče, přístupové tokeny, polohy uživatelů, soukromé souřadnice ani libovolné URL iframe.
• Implementace s více lokalitami zachovává klávesnicově přístupný textový seznam a atomicky synchronizuje vybranou pobočku.
• Schema, pokud je přítomno, popisuje stejnou reálnou entitu a adresu, které jsou zobrazeny návštěvníkům.
• Datum ověření a vlastník kontroly splňují zásady údržby místních dat daného webu.

Mapový blok uspěje, když ztráta mapy změní pohodlí, nikoli význam. Čtenář stále ví, o jaké místo se jedná, jak se k němu dostat a co očekávat; poskytovatel zůstává volitelný.