Kartblokker: Vis en plassering uten å skjule adressen

En kartblokk hjelper en besøkende med å forstå hvor et reelt sted befinner seg, og å gå fra lesing til navigasjon. Det varige innholdet er den bekreftede adressen i HTML; det visuelle kartet er en valgfri orienteringshjelp. Standardimplementeringen reserverer kartområdet, viser en lettvektig statisk fallback, og laster en godkjent interaktiv leverandør først etter at den besøkende ber om det.

National Gallery
Trafalgar Square, London WC2N 5DN, Storbritannia
Kart ikke lastet. Åpne plasseringen i kartappen din, eller aktiver Last interaktivt kart når du trenger å inspisere de omkringliggende gatene.

Denne renderte fasaden er nyttig før enhver tredjepartsforespørsel. Den navngir stedet, viser adressen som valgbar tekst, forklarer den ulastede tilstanden, og gir to tydelige veier: åpne et eksternt kart eller bevisst laste det innebygde.

Hvorfor dette elementet er viktig

Stedsspørsmål er praktiske. En besøkende kan vurdere om en avdeling er nær nok, sjekke hvilken side av en jernbanelinje den ligger på, finne riktig inngang, eller sammenligne kollektivtransport med parkering. Et kart reduserer den mentale innsatsen ved å oversette en ukjent adresse til romlig kontekst. Det kan gjøre nærliggende landemerker og gateforhold synlige raskere enn et avsnitt.

Den bekvemmeligheten gjør ikke kartet til sannhetskilden. Besøkende kan kopiere en adresse, sende den til en annen person, eller lese den med hjelpemiddelteknologi. Kartfliser kan ikke pålitelig støtte disse handlingene, og svake data, personverninnstillinger eller leverandørfeil kan blokkere dem. Adressen må forbli nyttig uten kartet.

Et innebygd kart kan legge til iframe, JavaScript, fonter, bilder og tredjepartsforespørsler. Disse ressursene konkurrerer med sidens svar og kan avsløre en IP-adresse eller initiere lagring som krever samtykke. En besøkende som aldri bruker kartet, bør ikke betale den kostnaden.

Maskinuttrekkbarhet betyr at programvare kan identifisere stedet uten å tolke kartpiksler eller kjøre leverandøren. Nettsøk, AI-systemer, skjermlesere, oversettelsesverktøy og lokale datapipelines trenger et stedsnavn, fullstendig postadresse, koordinater der det er styrt, og en stabil destinasjonslenke i HTML eller strukturerte felt. En iframe-URL er ikke en pålitelig adresse. Leverandøretiketter kan endres, og markører kan være litt feilplassert. Den samme bekreftede plasseringsposten bør mate den synlige adressen, kartmarkøren, navigasjonslenken og eventuelle kvalifiserende strukturerte data.

Skrivereglene for elementer har forrang: velg et typet element basert på formål, ikke utseende. Hvis formålet er romlig orientering rundt ett bekreftet sted, bruk en kartblokk. Hvis formålet er å publisere kontaktdetaljer, bruk en åpningstider og kontaktblokk eller NAP-blokk og la kartet bruke samme adressepost. Hvis formålet er å reservere en tid, bruk en bestillingsblokk .

Når du skal bruke det

Bruk en kartblokk når det å se stedet i omgivelsene hjelper leseren med å fullføre en stedsavhengig oppgave. Typiske bruksområder inkluderer en butikk, kontor, klinikk, arrangementslokale, hentepunkt, utstillingslokale, hotell, attraksjon, avdeling, arrangementsinngang eller serviceområdegrense. Det er spesielt nyttig når inngangen avviker fra postadressen, nærliggende veier er forvirrende, tilgjengelighetsruter trenger forklaring, eller kollektivtransport og parkering påvirker besøket.

Bekreft markøren mot den faktiske inngangen eller tjenestepunktet, i stedet for å akseptere leverandørens første geokodingsresultat. For et sted inne i en større bygning, oppgi etasje, enhet eller inngang i tekst.

Nære-tilfeller skaper ofte tiltalende men lite nyttige kart:

• En liste over betjente byer: dette er en serviceområdeerklæring, ikke bevis på en fysisk lokasjon. Ikke slipp markører i bysentre og antyd kontorer.
• En postadresse uten besøksadgang: publiser postdetaljene og si at besøk ikke er mulig. Et kart ville antyde en ikke-støttet ankomsthandling.
• Et eksternt eller kun nettbasert selskap: et registrert kontor kan være juridisk relevant, men det blir ikke en kundedestinasjon fordi en innbygging kan plassere det.
• Tur-for-tur veibeskrivelse: lenk til en navigasjonsleverandør og oppgi rutesspesifikke notater. Et statisk innebygd kart kan ikke ta hensyn til trafikk, stengninger eller den besøkendes startpunkt.
• Mange lokasjoner: bruk et lokaliseringsverktøy med en tekstlig resultatliste. En sky av markører kan ikke erstatte individuelle avdelingssider.
• Bevis på lokal tilstedeværelse: et kart er ikke bevis på at et team opererer der. Støtt påstanden med konsistent identitet, adresse, kontakt, åpningstider og avdelingsspesifikt innhold.
• Dekorativ geografisk kontekst: hvis plasseringen ikke påvirker oppgaven, utelat kartet. En bysilhuett eller regional oversikt hører til et annet visuelt formål.

Hvor du skal plassere det

Plasser kartet umiddelbart etter stedsnavnet, fullstendig adresse og eventuelle besøkskritiske kvalifikasjoner. På en plasseringsside er den vanlige sekvensen introduksjon, adresse og kontaktfakta, kart, ankomstnotater, åpningstider, deretter besøks- eller bestillingshandlingen. Hvis veibeskrivelse er det primære svaret, oppsummer den før kartet.

Hold adressen, kartfasaden, lastekontrollen, fallback-lenken, bildeteksten og veibeskrivelsesnotatet i én merket region. Den besøkende bør ikke måtte krysse en testimonial eller markedsseksjon for å finne adressen som tilhører markøren. En «Få veibeskrivelse»-lenke må bruke samme koordinater eller stedsidentifikator som den viste markøren.

Blokken kan ligge nær åpningstider for samme avdeling, men ikke ved siden av en motstridende adresse, et annet kart, automatisk avspillende video eller reklame som er stilisert som en kontroll. Ikke plasser den inne i en karusell, et trekkspill, en obligatorisk modal, en skjult fane eller en smal tabellcelle.

Ikke plasser kartet mellom en advarsel og instruksjonen den kvalifiserer, eller mellom en bestillingshandling og dens forutsetninger. Dekk aldri viktig adressetekst, samtykkeordlyd eller den eneste veibeskrivelseslenken med kartfliser. På mobil, bevar denne leserekkefølgen: stedsnavn, adresse, besøkskvalifikasjon, fallback, lastekontroll, kartregion, deretter veibeskrivelse.

Anatomi

1. Stedsnavn: identifiserer avdelingen, lokalet eller destinasjonen som markøren representerer.
2. Fullstendig tekstadresse: inkluderer hver adresselinje, sted, postnummer og land som trengs for å skille stedet.
3. Besøkskvalifikasjon: oppgir inngang, enhet, etasje, avtalebehov, besøksbegrensning eller tilgjengelighetsfakta når det endrer ankomst.
4. Reservert visningsområde: fastsetter bredde og sideforhold før interaktive ressurser lastes inn, og forhindrer lay-outendring.
5. Statisk fallback: gir nyttig romlig kontekst uten skript; den må være et reelt generert aktivum før den refereres.
6. Markør: representerer det bekreftede ankomstpunktet, ikke bare et postnummer eller administrativt sentrum.
7. Lastekontroll: er en ekte knapp med et spesifikt tilgjengelig navn, for eksempel «Last interaktivt kart for National Gallery.»
8. Leverandørmerknad: navngir tredjeparten og forklarer at aktivering kan koble til den.
9. Veibeskrivelseslenke: åpner en stabil HTTPS-destinasjon for navigasjon uten å kreve den innebygde spilleren.
10. Bildetekst eller landemerknotat: forklarer kartets nyttige konklusjon, for eksempel at inngangen vender mot en navngitt gate.
11. Plasseringspost: leverer styrte koordinater, stedsidentifikator og bekreftelsesdato til renderingsmotoren.
12. Feiltilstand: bevarer adressen, veibeskrivelseslenken og muligheten til å prøve igjen hvis leverandøren ikke kan laste.

Designeksempler

Hver variant beholder adressen i HTML, reserverer kartdimensjonene, og gir en direkte veibeskrivelseslenke. Bare lasteatferden endres.

Statisk kart med ekstern veibeskrivelse — lavest kostnad

Bruk et optimalisert kartbilde når orientering hjelper, men panorering og zooming ikke gjør det. Alternativtekst forteller den romlige konklusjonen; bildeteksten bærer landemerker. Publiser stien først etter at aktivumet eksisterer.

Klikk-for-å-laste interaktivt kart — standard

Vis en statisk fallback eller et nøytralt reservert panel først. En knapp laster den godkjente iframe-en etter eksplisitt aktivering. Dette beskytter sidehastigheten og gjør tredjepartstilkoblingen bevisst, samtidig som panorering, zoom og gateinspeksjon er tilgjengelig på forespørsel.

Samtykkestyrt kart

Bruk dette når nettstedets personvernpolicy krever samtykke før kontakt med leverandøren. Forklar konsekvensen på vanlig språk og tilby veibeskrivelseslenken uten å kreve samtykke. Å avslå må ikke skjule adressen eller forhindre at resten av siden fungerer.

Alltid lastet interaktivt kart — målt unntak

Bruk bare når interaksjon er sentral, leverandørkontakt er tillatt, og feltmåling aksepterer kostnaden. Lazy-loading kan fortsatt initialiseres når den besøkende nærmer seg. Ha en serverrendert fallback fordi loading="lazy" ikke kan forhindre leverandørfeil.

Enkeltstedsblokk inne i en lokaliseringsfunksjon

For en side med flere lokasjoner, kombiner det valgte kartet med en tekstlig resultatliste. Å laste én valgt avdeling holder interaksjonen forståelig; endring av valg oppdaterer stedsnavn, adresse, markør og veibeskrivelseslenke samtidig. Listen forblir brukbar uten kartet.

Parametere

«Kilde» betyr hvor renderingsmotoren henter den forfatede verdien. Det autoritative plasseringssystemet er fortsatt ansvarlig for å verifisere den faktiske adressen og koordinatene.

Renderingsmotoren må bygge leverandør-URL-er fra godkjente identifikatorer og numeriske koordinater. Forfattere må ikke lime inn vilkårlig iframe-HTML, API-nøkler, tilgangstokener eller JavaScript i brødteksten. Seks desimaler plasserer et punkt med mye finere presisjon enn en besøkende normalt trenger; behold færre sifre når publisering av en eksakt privat inngang vil skape en sikkerhets- eller personvernrisiko.

Syntaks og kodeeksempler

Disse bærbare eksemplene beskriver én kanonisk innholdsmodell. Et prosjekt må implementere og teste den tilsvarende renderingsmotoren før forfattere bruker syntaksen i produksjon.

Bærbar Markdown-direktiv

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

Den første overskriften leverer title; den neste linjen leverer den strukturerte adressen; og resten av brødteksten leverer bildeteksten eller ankomstnotatet.

Hugo shortcode-tilordning

Bruk kun navngitte parametere. Denne notasjonen dokumenterer den tiltenkte adapteren; den hevder ikke at en kart-shortcode allerede finnes i dette repositoriet.

{{< 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 >}}

Adapteren må reservere forholdet, rendere adressen og fallbacken på serveren, og opprette iframe-en først etter den deklarerte utløseren. Den må aldri eksponere en leverandørs API-nøkkel i forfatterinnhold.

WordPress-blokk

<!-- 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 -->

En opprinnelig blokk bør lagre koordinater som tall, holde adressefelt strukturerte, validere leverandøren og rendere en trygg server-side-fasade. Forhåndsvisning i redigeringsverktøyet kan vise en statisk representasjon i stedet for å initialisere hele leverandøren.

Gode og dårlige eksempler

Bra

North Street Clinic
18 North Street, Bristol BS1 3PR, Storbritannia
Bruk gårdsplass-inngangen ved siden av apoteket. Trinnfri adgang er tilgjengelig fra North Street.
Last interaktivt kart · Åpne veibeskrivelse i kart-app

Dette fungerer fordi den besøkende kan identifisere, kopiere og navigere til stedet uten innbyggingen. Inngangsnotatet løser en reell ankomst-usikkerhet. Å laste tredjeparten er et valg, og begge handlingene sier tydelig hva som skjer.

Dårlig

Finn oss her!
[fullbredde interaktivt kart med en umerket markør]

Dette feiler fordi «her» ikke identifiserer et sted, adressen eksisterer bare inne i leverandørens piksler, og markøren kan representere et postnummer snarere enn en inngang. Det ivrige kartet legger til kostnad selv for besøkende som ikke bruker det. Det er ingen fallback, bekreftelsesdato, ankomstnotat eller tilgjengelig navigasjonslenke. Å legge til adresse i iframe-ens title ville forbedre rammeetiketten, men ville ikke skape valgbar sidetekst.

Skjemamerking og tilgjengelighet

En kartblokk har ingen dedikert Schema.org-type. Bekreftede felt kan mate den aktuelle Organization, LocalBusiness-subtype, Place, PostalAddress eller GeoCoordinates når siden representerer den enheten. Bruk én felles plasseringspost; den synlige adressen, markøren, kanoniske avdelings-URL og JSON-LD må samsvare.

Ikke legg til hasMap utelukkende for å få siden til å se mer komplett ut. Når den brukes, bør den peke til en stabil kart-URL for samme sted, ikke en utløpende sesjon-URL eller et iframe-endepunkt med en eksponert nøkkel. En serviceområde-virksomhet uten en offentlig kundelokasjon bør beskrive sitt tjenesteområde ærlig og må ikke publisere oppdiktede lokaler eller altfor presise private koordinater.

Tilgjengelighet begynner med uavhengighet fra kartet. Sett stedsnavnet og hele adressen i HTML, bruk <address> kun for relevant kontaktinformasjon. Tilby en vanlig veibeskrivelseslenke. Beskriv innganger, landemerker, kollektivtransport, parkering og trinnfri adgang i tekst. Alternativtekst for statiske kart bør formidle den nyttige konklusjonen, ikke liste hver gate.

Lastekontrollen må være en tastaturnavigerbar <button> med synlig fokus og et tilgjengelig navn knyttet til stedet. Lasting må ikke flytte fokus uventet. Etter aktivering, kunngjør en kort status som «Interaktivt kart lastet», behold deretter fokus på den initierende kontrollen eller flytt det bare når grensesnittet har et dokumentert tastaturinngangspunkt. Gi hver iframe en unik tittel, for eksempel «Interaktivt gatekart for North Street Clinic.»

Leverandørkontroller må forbli brukbare ved smale bredder og 200 % zoom. Ikke fang tastaturfokus inne i iframe-en. Ikke stol på markørfarge, dra-bevegelser, hover eller visuelle gateetiketter for viktig informasjon. Hvis kartet feiler eller samtykke avslås, hold den reserverte regionen stabil og eksponer adressen, ankomstnotatet, ekstern veibeskrivelseslenke og forsøk-på-nytt-handling.

Skriveregler

Start med det offisielle offentlige stedsnavnet på to til ti ord. Følg med den fullstendige postadressen som lagret i den styrte plasseringsposten. Ikke forkort bort en enhet, bygning, sted eller postnummer som trengs for å nå riktig inngang. Inkluder landet når siden kan motta internasjonal trafikk eller når bynavnet er tvetydig.

Legg til ett ankomstnotat på 8–35 ord kun når det endrer hva den besøkende bør gjøre. Nevn et varig landemerke eller inngangsforhold: «Bruk gårdsplass-inngangen ved siden av apoteket» er nyttig; «Du kan ikke gå glipp av oss» er det ikke. Tids-sensitive veistengninger, konstruksjonsruter og midlertidige innganger trenger en eier og gjennomgangsdato andre steder i innholdssystemet.

Bruk én kartblokk for én valgt destinasjon. En lokaliseringsfunksjon kan bytte destinasjon, men hver valgt tilstand må oppdatere tittelen, adressen, markøren, bildeteksten og lenken atomisk. Vis én primærmarkør som standard. Sekundære landemerker kan bare vises når de forklarer ankomst og er visuelt skillbare i tekst og kontroller.

Hold kontrollerkoder bokstavelige: «Last interaktivt kart,» «Åpne veibeskrivelse,» og «Vis tilgjengelig inngang.» Unngå vage koder som «Utforsk,» «Se mer,» eller «Klikk her.» Oppgi leverandøren før aktivering når en tilkobling har personvernimplikasjoner.

Plasser aldri telefonnumre, åpningstider, reklamepåstander, anmeldelser, priser, bestillingsskjemaer eller lange parkeringsregler inne i det interaktive lerretet. Disse faktaene hører hjemme i HTML og i sine egne typede elementer. Publiser aldri en API-nøkkel, en brukers live-posisjon, en privat boliginngang, oppdiktede kontormarkører, ubekreftede serviceområder eller koordinater kopiert fra en ukontrollert geokoder. Kartet må ikke antyde besøksadgang der ingen finnes.

Bekreft adressen og markøren ved publisering, etter en stedsendring, og under planlagt gjennomgang. Leverandørers veier og etiketter kan endres uavhengig; organisasjonen eier fortsatt nøyaktigheten av sin plasseringspost og ankomstinstruksjoner.

Innholdstyper som bruker det

Feltet postTypes i front matter er kilden for denne implementeringsmatrisen.

QA-sjekkliste

• Stedsnavnet og hele adressen vises som valgbar serverrendert tekst utenfor kartet.
• Markøren peker til det bekreftede offentlige ankomstpunktet snarere enn et postnummer eller bygningssentrum.
• Adressen, koordinatene, stedsidentifikatoren, veibeskrivelseslenken og strukturerte data kommer fra samme styrte post.
• Blokken forklarer eventuelle enheter, etasjer, innganger, avtaleregler eller tilgjengelighetsruter som trengs for å ankomme.
• Standardimplementeringen unngår tredjepartsforespørsler inntil eksplisitt aktivering eller gyldig samtykke.
• Et unntak med alltid lastet kart har et dokumentert formål, personverngrunnlag og målt ytelsesbudsjett.
• Bredde og sideforhold er reservert før bilde, iframe eller leverandørkode lastes.
• Eventuell statisk bildesti peker til et reelt godkjent aktivum og har nyttig alternativtekst.
• Lastekontrollen er en knapp med et stedsspesifikt tilgjengelig navn og synlig fokus.
• Iframe-en, når den opprettes, har en unik beskrivende tittel og fanger ikke tastaturfokus.
• Adressen, veibeskrivelseslenken, ankomstnotatet og forsøk-på-nytt-stien forblir brukbare når skript, samtykke eller leverandøren feiler.
• Viktig informasjon er ikke avhengig av markørfarge, hover, dra, zoom eller kartetiketter.
• Layouten fungerer ved smale bredder og 200 % zoom uten å dekke leverandørkontroller.
• Siden hevder ikke et offentlig kontor, inngang eller tjenesteområde som organisasjonen ikke kan bekrefte.
• Ingen API-nøkler, tilgangstokener, brukerposisjoner, private koordinater eller vilkårlige iframe-URL-er vises i forfatterinnhold.
• Implementeringer med flere lokasjoner beholder en tastaturnavigerbar tekstliste og synkroniserer valgt avdeling atomisk.
• Skjema, hvis til stede, beskriver den samme reelle enheten og adressen som vises til besøkende.
• Bekreftelsesdatoen og gjennomgangsansvarlig oppfyller nettstedets retningslinjer for vedlikehold av lokale data.

En kartblokk lykkes når det å miste kartet endrer bekvemmelighet, ikke mening. Leseren vet fortsatt hvor stedet er, hvordan man kommer dit, og hva man kan forvente; leverandøren forblir valgfri.