Mapové bloky: Zobrazenie lokality bez skrytia adresy

Mapový blok pomáha návštevníkovi pochopiť, kde sa reálne miesto nachádza, a prejsť od čítania k navigácii. Jeho trvalým obsahom je overená adresa v HTML; vizuálna mapa je voliteľná orientačná pomôcka. Predvolená implementácia vyhradí oblasť mapy, zobrazí ľahkú statickú záložnú verziu a načíta schváleného interaktívneho poskytovateľa až po tom, čo o to návštevník požiada.

Národná galéria
Trafalgar Square, Londýn WC2N 5DN, Spojené kráľovstvo
Mapa nie je načítaná. Otvorte lokalitu vo vašej mapovej aplikácii alebo aktivujte Načítať interaktívnu mapu, keď potrebujete preskúmať okolité ulice.

Táto vykreslená fasáda je užitočná ešte pred akoukoľvek požiadavkou tretej strane. Pomenúva miesto, sprístupňuje adresu ako vybrateľný text, vysvetľuje nenačítaný stav a poskytuje dve jasné cesty: otvoriť externú mapu alebo zámerne načítať vloženú.

Prečo na tomto prvku záleží

Otázky týkajúce sa lokality sú praktické. Návštevník sa môže rozhodovať, či je pobočka dostatočne blízko, kontrolovať, na ktorej strane železničnej trate sa nachádza, hľadať správny vchod alebo porovnávať verejnú dopravu s parkovaním. Mapa znižuje mentálnu námahu pri prevode neznámej adresy do priestorového kontextu. Dokáže sprístupniť blízke orientačné body a vzťahy medzi ulicami rýchlejšie ako odsek.

Toto pohodlie nerobí z mapy zdroj pravdy. Návštevníci môžu adresu kopírovať, poslať ju inej osobe alebo ju čítať s asistenčnou technológiou. Mapové dlaždice tieto činnosti spoľahlivo nepodporujú a slabé dáta, nastavenia ochrany súkromia alebo zlyhanie poskytovateľa ich môžu blokovať. Adresa musí zostať použiteľná aj bez mapy.

Vložená mapa môže pridať iframe, JavaScript, písma, obrázky a požiadavky tretích strán. Tieto zdroje konkurujú odpovedi stránky a môžu prezradiť IP adresu alebo iniciovať ukladanie údajov podliehajúce súhlasu. Návštevník, ktorý mapu nikdy nepoužije, by nemal platiť tieto náklady.

Strojová extrahovateľnosť znamená, že softvér dokáže identifikovať miesto bez interpretácie pixelov mapy alebo spúšťania poskytovateľa. Vyhľadávacie prehľadávače, AI systémy, čítačky obrazovky, prekladové nástroje a miestne dátové pipeline potrebujú názov miesta, úplnú poštovú adresu, súradnice (kde je to regulované) a stabilný cieľový odkaz v HTML alebo štruktúrovaných poliach. URL adresa iframe nie je spoľahlivá adresa. Štítky poskytovateľa sa môžu meniť a body môžu byť mierne nesprávne umiestnené. Ten istý overený záznam lokality by mal napájať viditeľnú adresu, značku na mape, navigačný odkaz a všetky oprávnené štruktúrované dáta.

Platia pravidlá písania prvkov : vyberajte typovaný prvok podľa účelu, nie vzhľadu. Ak je účelom priestorová orientácia okolo jedného overeného miesta, použite mapový blok. Ak je účelom zverejniť kontaktné údaje, použite blok otváracích hodín a kontaktov alebo NAP blok a nechajte mapu používať rovnaký záznam adresy. Ak je účelom rezervovať čas, použite blok rezervácií .

Kedy ho použiť

Mapový blok použite, keď videnie miesta v jeho okolí pomáha čitateľovi dokončiť úlohu závislú od lokality. Typické použitia zahŕňajú obchod, kanceláriu, kliniku, miesto konania, výdajné miesto, showroom, hotel, atrakciu, pobočku, vchod na podujatie alebo hranicu oblasti služieb. Je obzvlášť užitočný, keď sa vchod líši od poštovej adresy, okolité cesty sú mätúce, trasy pre bezbariérový prístup vyžadujú vysvetlenie alebo verejná doprava a parkovanie ovplyvňujú návštevu.

Overte značku oproti skutočnému vchodu alebo miestu služby, nie len prvému výsledku geokódovania poskytovateľa. Pre miesto vo vnútri väčšej budovy uveďte v texte poschodie, jednotku alebo vchod.

Prípady blízkeho nesprávneho použitia často vytvárajú lákavé, ale neužitočné mapy:

• Zoznam obsluhovaných miest: toto je vyhlásenie o oblasti služieb, nie dôkaz o fyzickej lokalite. Neumiestňujte body do centier miest a nenaznačujte kancelárie.
• Poštová adresa bez prístupu návštevníkov: zverejnite poštové údaje a uveďte, že návštevy nie sú možné. Mapa by naznačovala nedostupnú akciu príchodu.
• Vzdialená alebo online-only spoločnosť: registrovaná kancelária môže byť právne relevantná, ale nestáva sa destináciou pre zákazníkov len preto, že ju možno lokalizovať pomocou vloženia.
• Navigácia odbočka po odbočke: odkazujte na navigačného poskytovateľa a poskytnite poznámky špecifické pre trasu. Statická vložená mapa nemôže zohľadniť dopravu, uzávierky ani východiskový bod návštevníka.
• Veľa lokalít: použite vyhľadávač lokalít s textovým zoznamom výsledkov. Mračno bodov nemôže nahradiť jednotlivé stránky pobočiek.
• Dôkaz o miestnej prítomnosti: mapa nie je dôkazom, že tam tím pôsobí. Podporte tvrdenie konzistentnou identitou, adresou, kontaktom, otváracími hodinami a obsahom špecifickým pre pobočku.
• Dekoratívny geografický kontext: ak lokalita neovplyvňuje úlohu, mapu vynechajte. Panoráma mesta alebo regionálny obrys patrí na iný vizuálny účel.

Kam ju umiestniť

Umiestnite mapu ihneď za názov miesta, úplnú adresu a prípadný kvalifikátor dôležitý pre návštevu. Na stránke lokality je obvyklé poradie: úvod, adresa a kontaktné fakty, mapa, poznámky k príchodu, otváracie hodiny, potom akcia návštevy alebo rezervácie. Ak sú primárnou odpoveďou pokyny, zhrňte ich pred mapou.

Adresu, mapovú fasádu, ovládanie načítania, záložný odkaz, popis a poznámku o smere ponechajte v jednom označenom regióne. Návštevník by nemal musieť prechádzať cez sekciu s referenciami alebo marketingom, aby našiel adresu, ktorá patrí k bodu na mape. Odkaz „Získať trasu“ musí používať rovnaké súradnice alebo identifikátor miesta ako zobrazená značka.

Blok môže byť umiestnený v blízkosti otváracích hodín pre rovnakú pobočku, ale nie vedľa konfliktnej adresy, inej mapy, automaticky prehrávaného videa alebo reklamy štylizovanej ako ovládací prvok. Neumiestňujte ho do karuselu, akordeónu, povinného modálneho okna, skrytej karty alebo úzkej bunky tabuľky.

Neumiestňujte mapu medzi varovanie a inštrukciu, ktorú kvalifikuje, ani medzi rezervačnú akciu a jej predpoklady. Nikdy neprekrývajte podstatný text adresy, znenie súhlasu alebo jediný odkaz na trasu na mapových dlaždiciach. Na mobile zachovajte toto poradie čítania: názov miesta, adresa, kvalifikátor návštevy, záložné riešenie, ovládanie načítania, oblasť mapy, potom pokyny.

Anatómia

1. Názov miesta: identifikuje pobočku, miesto konania alebo destináciu reprezentovanú značkou.
2. Kompletná textová adresa: zahŕňa všetky riadky adresy, lokalitu, poštové smerovacie číslo a krajinu potrebné na rozlíšenie miesta.
3. Kvalifikátor návštevy: uvádza vchod, jednotku, poschodie, požiadavku na stretnutie, obmedzenie pre návštevníkov alebo informáciu o bezbariérovosti, ktorá mení spôsob príchodu.
4. Vyhradené zobrazenie: fixuje šírku a pomer strán pred načítaním interaktívnych zdrojov, čím zabraňuje pohybu rozloženia.
5. Statické záložné riešenie: poskytuje užitočný priestorový kontext bez skriptov; musí to byť skutočne vygenerovaný asset predtým, než je naň odkazované.
6. Značka: reprezentuje overený bod príchodu, nie len PSČ alebo administratívny centroid.
7. Ovládanie načítania: je skutočné tlačidlo s konkrétnym prístupným názvom, napríklad „Načítať interaktívnu mapu pre Národnú galériu.“
8. Upozornenie na poskytovateľa: pomenúva tretiu stranu a vysvetľuje, že aktivácia sa môže pripojiť k nej.
9. Odkaz na trasu: otvára stabilný HTTPS cieľ pre navigáciu bez nutnosti používať vložený prehrávač.
10. Popis alebo poznámka o orientačnom bode: vysvetľuje užitočný záver mapy, napríklad že vchod smeruje na pomenovanú ulicu.
11. Záznam lokality: poskytuje vykresľovaču riadené súradnice, identifikátor miesta a dátum overenia.
12. Stav zlyhania: zachováva adresu, odkaz na trasu a možnosť opakovania, ak sa poskytovateľ nedokáže načítať.

Príklady dizajnu

Každý variant ponecháva adresu v HTML, vyhradzuje rozmery mapy a poskytuje priamy odkaz na trasu. Mení sa iba správanie načítania.

Statická mapa s externými pokynmi — najnižšie náklady

Použite optimalizovaný obrázok mapy, keď orientácia pomáha, ale posúvanie a približovanie nie sú potrebné. Alternatívny text uvádza jej priestorový záver; popis nesie orientačné body. Cestu zverejnite až po existencii assetu.

Interaktívna mapa na kliknutie — predvolené

Najprv zobrazte statické záložné riešenie alebo neutrálny vyhradený panel. Tlačidlo načíta schválený iframe po explicitnej aktivácii. To chráni rýchlosť stránky a robí spojenie s treťou stranou zámerným, pričom posúvanie, približovanie a prehliadanie ulíc zostáva k dispozícii na požiadanie.

Mapa riadená súhlasom

Použite to, keď politika ochrany súkromia stránky vyžaduje súhlas pred kontaktovaním poskytovateľa. Vysvetlite dôsledok v jednoduchom jazyku a ponúknite odkaz na trasu bez vyžadovania súhlasu. Odmietnutie nesmie skryť adresu ani zabrániť fungovaniu zvyšku stránky.

Vždy načítaná interaktívna mapa — meraná výnimka

Používajte len vtedy, keď je interakcia centrálna, kontakt s poskytovateľom je povolený a meranie v teréne akceptuje náklady. Lenivé načítanie (lazy loading) môže stále inicializovať, keď sa návštevník približuje. Ponechajte serverovo vykreslené záložné riešenie, pretože loading="lazy" nemôže zabrániť zlyhaniu poskytovateľa.

Blok jednej lokality v rámci vyhľadávača

Pre stránku s viacerými lokalitami spárujte vybranú mapu s textovým zoznamom výsledkov. Načítanie jednej vybranej pobočky udržuje interakciu zrozumiteľnú; zmena výberu aktualizuje názov miesta, adresu, značku a odkaz na trasu súčasne. Zoznam zostáva použiteľný aj bez mapy.

Parametre

„Zdroj“ znamená, odkiaľ vykresľovač získava autorovú hodnotu. Autoritatívny systém lokality je naďalej zodpovedný za overenie skutočnej adresy a súradníc.

Vykresľovač musí vytvárať URL adresy poskytovateľa z povolených identifikátorov a číselných súradníc. Autori nesmú vkladať ľubovoľné HTML iframe, API kľúče, prístupové tokeny ani JavaScript do tela. Šesť desatinných miest lokalizuje bod s oveľa väčšou presnosťou, než návštevník bežne potrebuje; ponechajte menej číslic, ak by zverejnenie presného súkromného vchodu vytvorilo bezpečnostné riziko alebo riziko ochrany súkromia.

Syntax a príklady kódu

Tieto prenosné príklady opisujú jeden kanonický obsahový model. Projekt musí implementovať a otestovať príslušný vykresľovač predtým, než autori použijú syntax v produkcii.

Prenosná direktíva Markdown

:::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.
:::

Prvý nadpis poskytuje title; ďalší riadok poskytuje štruktúrovanú adresu; a zvyšok tela poskytuje popis alebo poznámku o príchode.

Mapovanie Hugo shortcode

Používajte iba pomenované parametre. Tento zápis dokumentuje zamýšľaný adaptér; netvrdí, že mapový shortcode už v tomto repozitári 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í vyhradiť pomer, vykresliť adresu a záložné riešenie na serveri a vytvoriť iframe až po deklarovanej spúšťači. Nikdy nesmie vystaviť API kľúč poskytovateľa v autorovom 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 -->

Natívny blok by mal ukladať súradnice ako čísla, udržiavať polia adresy štruktúrované, overovať poskytovateľa a vykresľovať bezpečnú serverovú fasádu. Editorový náhľad môže zobraziť statickú reprezentáciu namiesto inicializácie plného poskytovateľa.

Dobré a zlé príklady

Dobrý

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.
Načítať interaktívnu mapu · Otvoriť trasu v mapovej aplikácii

Toto funguje, pretože návštevník dokáže identifikovať, skopírovať a navigovať sa na miesto bez vloženia. Poznámka o vchode rieši skutočnú nejednoznačnosť príchodu. Načítanie tretej strany je voľba a obe akcie jasne uvádzajú, čo sa stane.

Zlý

Nájdite nás tu!
[interaktívna mapa v plnej šírke s neoznačeným bodom]

Toto zlyháva, pretože „tu“ neidentifikuje miesto, adresa existuje iba v pixeloch poskytovateľa a bod môže reprezentovať PSČ, nie vchod. Nedočkavá mapa pridáva náklady aj pre návštevníkov, ktorí ju nepoužívajú. Nie je k dispozícii žiadne záložné riešenie, dátum overenia, poznámka o príchode ani prístupný navigačný odkaz. Pridanie adresy do atribútu title iframe by zlepšilo označenie rámca, ale nevytvorilo by vybrateľný text stránky.

Štruktúrované dáta a prístupnosť

Mapový blok nemá vyhradený typ Schema.org. Overené polia môžu napájať príslušné Organization, podtyp LocalBusiness, Place, PostalAddress alebo GeoCoordinates, keď stránka reprezentuje túto entitu. Používajte jeden zdieľaný záznam lokality; viditeľná adresa, značka na mape, kanonická URL pobočky a JSON-LD sa musia zhodovať.

Nepridávajte hasMap len preto, aby stránka vyzerala úplnejšie. Ak sa používa, mal by odkazovať na stabilnú URL mapy pre rovnaké miesto, nie na expirujúcu URL relácie alebo iframe endpoint s vystaveným kľúčom. Firma s oblasťou služieb bez verejnej zákazníckej lokality by mala svoju oblasť služieb opísať čestne a nesmie zverejňovať vymyslené priestory ani príliš presné súkromné súradnice.

Prístupnosť začína nezávislosťou od mapy. Uveďte názov miesta a úplnú adresu v HTML, pričom <address> používajte len pre relevantné kontaktné informácie. Poskytnite bežný odkaz na trasu. V texte opíšte vchody, orientačné body, verejnú dopravu, parkovanie a bezbariérový prístup. Alternatívny text statickej mapy by mal komunikovať užitočný záver, nie vymenúvať každú ulicu.

Ovládanie načítania musí byť klávesnicovo ovládateľné <button> s viditeľným fokusom a prístupným názvom viazaným na miesto. Načítanie nesmie neočakávane presunúť fokus. Po aktivácii ohláste krátky stav, napríklad „Interaktívna mapa načítaná,“ potom ponechajte fokus na iniciujúcom ovládacom prvku alebo ho presuňte len vtedy, keď má rozhranie zdokumentovaný klávesnicový vstupný bod. Každému iframe dajte jedinečný názov, napríklad „Interaktívna pouličná mapa pre North Street Clinic.“

Ovládacie prvky poskytovateľa musia zostať ovládateľné pri úzkej šírke a 200% zväčšení. Nezachytávajte klávesnicový fokus vo vnútri iframe. Nespoliehajte sa na farbu bodu, ťahanie gestami, hover alebo vizuálne štítky ulíc pre podstatné informácie. Ak mapa zlyhá alebo je súhlas zamietnutý, udržujte vyhradený región stabilný a sprístupnite adresu, poznámku o príchode, externý odkaz na trasu a možnosť opakovania.

Pravidlá písania

Začnite oficiálnym verejným názvom miesta v dvoch až desiatich slovách. Nasledujte úplnou poštovou adresou uloženou v riadenom zázname lokality. Neskracujte jednotku, budovu, lokalitu ani PSČ potrebné na nájdenie správneho vchodu. Uveďte krajinu, keď stránka môže prijímať medzinárodnú návštevnosť alebo keď je názov mesta nejednoznačný.

Pridajte jednu poznámku o príchode v rozsahu 8–35 slov, len ak mení to, čo má návštevník urobiť. Uveďte trvalý orientačný bod alebo vzťah k vchodu: „Použite vchod na nádvorí vedľa lekárne“ je užitočné; „Nemôžete nás minúť“ nie je. Časovo citlivé uzávierky ciest, stavebné objazdy a dočasné vchody potrebujú vlastníka a dátum kontroly inde v obsahovom systéme.

Používajte jeden mapový blok pre jednu vybranú destináciu. Vyhľadávač môže túto destináciu prepínať, ale každý vybraný stav musí atómovo aktualizovať názov, adresu, značku, popis a odkaz. Predvolene zobrazte jednu primárnu značku. Sekundárne orientačné body sa môžu objaviť len vtedy, keď vysvetľujú príchod a sú vizuálne rozlíšiteľné v texte aj ovládacích prvkoch.

Udržujte označenia ovládacích prvkov doslovné: „Načítať interaktívnu mapu,“ „Otvoriť trasu“ a „Zobraziť bezbariérový vchod.“ Vyhnite sa vágnym označeniam ako „Preskúmať,“ „Zobraziť viac“ alebo „Kliknúť sem.“ Uveďte poskytovateľa pred aktiváciou, keď má spojenie dôsledky na súkromie.

Nikdy neumiestňujte telefónne čísla, otváracie hodiny, propagačné tvrdenia, recenzie, ceny, rezervačné formuláre ani dlhé pravidlá parkovania do interaktívneho plátna. Tieto fakty patria do HTML a do vlastných typovaných prvkov. Nikdy nezverejňujte API kľúč, živú polohu používateľa, súkromný obytný vchod, falošné kancelárske body, neoverené oblasti služieb ani súradnice skopírované z neskontrolovaného geokodéra. Mapa nesmie naznačovať prístup návštevníkov tam, kde neexistuje.

Overte adresu a značku pri publikácii, po zmene lokality a počas plánovanej kontroly. Cesty a štítky poskytovateľa sa môžu meniť nezávisle; organizácia stále zodpovedá za presnosť svojho záznamu lokality a pokynov na príchod.

Typy príspevkov, ktoré ho používajú

Pole frontmatter postTypes je zdrojom pre túto implementačnú maticu.

Kontrolný zoznam QA

• Názov miesta a úplná adresa sú uvedené ako vybrateľný serverovo vykreslený text mimo mapy.
• Značka ukazuje na overený verejný bod príchodu, nie na PSČ alebo centroid budovy.
• Adresa, súradnice, identifikátor miesta, odkaz na trasu a štruktúrované dáta pochádzajú z rovnakého riadeného záznamu.
• Blok vysvetľuje akúkoľvek jednotku, poschodie, vchod, pravidlo stretnutia alebo trasu bezbariérovosti potrebnú na príchod.
• Predvolená implementácia sa vyhýba požiadavkám tretích strán až do explicitnej aktivácie alebo platného súhlasu.
• Výnimka vždy načítanej mapy má zdokumentovaný účel, základ ochrany súkromia a nameraný výkonnostný rozpočet.
• Šírka a pomer strán sú vyhradené pred načítaním obrázka, iframe alebo kódu poskytovateľa.
• Každá cesta statického obrázka smeruje na skutočný schválený asset a má užitočný alternatívny text.
• Ovládanie načítania je tlačidlo s prístupným názvom špecifickým pre miesto a viditeľným fokusom.
• Iframe, keď je vytvorený, má jedinečný popisný názov a nezachytáva klávesnicový fokus.
• Adresa, odkaz na trasu, poznámka o príchode a možnosť opakovania zostávajú použiteľné, keď zlyhajú skripty, súhlas alebo poskytovateľ.
• Podstatné informácie nie sú závislé od farby bodu, hoveru, ťahania, približovania ani štítkov mapy.
• Rozloženie funguje pri úzkej šírke a 200% zväčšení bez prekrývania ovládacích prvkov poskytovateľa.
• Stránka netvrdí, že má verejnú kanceláriu, vchod alebo oblasť služieb, ktoré organizácia nemôže overiť.
• Žiadne API kľúče, prístupové tokeny, polohy používateľov, súkromné súradnice ani ľubovoľné URL iframe sa nenachádzajú v autorovom obsahu.
• Implementácie s viacerými lokalitami zachovávajú klávesnicovo prístupný textový zoznam a atómovo synchronizujú vybranú pobočku.
• Schema, ak je prítomná, opisuje rovnakú skutočnú entitu a adresu, ktorá je zobrazená návštevníkom.
• Dátum overenia a vlastník kontroly spĺňajú pravidlá údržby miestnych údajov stránky.

Mapový blok je úspešný, keď strata mapy mení pohodlie, nie význam. Čitateľ stále vie, kde je miesto, ako sa k nemu dostať a čo očakávať; poskytovateľ zostáva voliteľný.