Blok NAP: kanoniczna nazwa, adres i telefon

Blok NAP publikuje nazwę, adres i numer telefonu lokalizacji biznesowej w jednym kanonicznym rekordzie. „Kanoniczny” oznacza, że organizacja wybrała jedną autorytatywną, podstawową wartość dla każdego pola, nawet jeśli katalog skraca nazwę ulicy, a link telefoniczny używa międzynarodowego formatu maszynowego.

Wyrenderowany element jest celowo niepozorny. Jego zadaniem jest tożsamość, a nie perswazja: jedna lokalizacja, jedna nazwa widoczna dla klientów, jeden adres do doręczeń, jeden monitorowany numer i wystarczający rodowód, aby porównać wszystkie kopie ze źródłem.

Dlaczego ten element jest ważny

Lokalne decyzje mają wysoki koszt błędu. Czytelnik może wybierać, dokąd pojechać, który oddział zadzwonić, gdzie wysłać dokument lub czy firma obsługuje jego obszar. Gdy stopka pokazuje numer centrali, strona lokalizacji pokazuje numer oddziału, a panel mapy wskazuje stare wejście, czytelnik musi zgadywać, który fakt decyduje o następnym działaniu. Ta niepewność niszczy zaufanie, zanim rozmowa się zacznie.

Korzyść psychologiczna to pewność poprzez konkretność. Pełny adres uliczny sygnalizuje, że strona opisuje prawdziwe miejsce, a nie ogólną stronę kierowaną na miasto. Numer telefonu specyficzny dla lokalizacji mówi czytelnikowi, kogo osiągnie. Stabilna nazwa pomaga mu rozpoznać ten sam oddział w wynikach wyszukiwania, mapach, platformach recenzji, fakturach i oznakowaniu. Żaden z tych szczegółów nie dowodzi jakości usług, ale razem usuwają możliwe do uniknięcia wątpliwości co do tożsamości i dostępu.

Ekstrakcja maszynowa to zdolność crawlera, wyszukiwarki, katalogu, asystenta lub procesu syndykacji do zachowania każdej wartości i jej powiązania z jedną lokalizacją. Zdanie takie jak „Zadzwoń do naszego waszyngtońskiego zespołu w pobliżu Capitol Hill” może brzmieć naturalnie, ale nie ujawnia pełnego adresu pocztowego ani jednoznacznej wartości telefonicznej. Oznaczony blok ze stabilnym ID lokalizacji tworzy rekord, który można porównywać pole po polu.

Spójność należy traktować jako audytowalny problem danych, a nie rytuał typograficzny. Normalizuj wielkość liter, Unicode, białe znaki, przyrostki ulic, identyfikatory jednostek, kody pocztowe, kody krajów i cyfry telefonów przed porównaniem rekordów. „1200 Example Ave., Ste 210” i „1200 Example Avenue, Suite 210” mogą normalizować się do tego samego adresu; „Suite 120” już nie. Podobnie (202) 555-0147 i +1 202-555-0147 mogą reprezentować ten sam numer, podczas gdy numer do śledzenia połączeń może celowo się różnić i musi być odnotowany jako zatwierdzony alias z właścicielem routingu.

Kiedy go używać

Użyj bloku NAP, gdy strona reprezentuje fizyczną lokalizację biznesową, którą klienci mogą odwiedzić, zadzwonić, wysłać korespondencję, zweryfikować lub odróżnić od innego oddziału. Jest wymagany na stronach lokalizacji i oddziałów, przydatny w kontrolowanych rekordach katalogowych i odpowiedni w profilu firmy, gdy adres jest rzeczywiście częścią publicznej tożsamości.

Utwórz jeden blok na lokalizację. Indeks wielolokalizacyjny może wyrenderować dwadzieścia bloków, ale musi wyrenderować dwadzieścia oddzielnych rekordów, a nie jedną nazwę firmy, po której następuje mieszana lista adresów i numerów. Każda instancja powinna wskazywać ID lokalizacji, aby system treści nie mógł sparować adresu Oddziału A z telefonem Oddziału B.

Przypadki graniczne wymagają innego podejścia:

• Firma świadcząca usługi na obszarze bez lokalu dla klientów nie powinna publikować domowego adresu właściciela. Podaj obszar usług i drogę kontaktu, nie udając, że istnieje odwiedzana lokalizacja NAP.
• Skrytka pocztowa, adres agenta do doręczeń, adres do fakturowania, magazyn i adres zwrotów nie są wymienne z lokalizacją klienta. Oznacz każdy cel operacyjny i trzymaj go poza głównym blokiem, chyba że jest to adres, którego klienci mają używać.
• Godziny otwarcia, dostępność terminów, wskazówki dojazdu, parking i informacje o dostępności mogą znajdować się obok bloku, ale są to oddzielne fakty z oddzielnymi cyklami aktualizacji.
• Numer do śledzenia połączeń nie jest automatycznie niespójny. Jest dopuszczalny, gdy routing jest niezawodny, własność i kanoniczne miejsce docelowe są udokumentowane, a widoczny numer nie zmienia się nieprzewidywalnie dla crawlerów lub powracających użytkowników.
• Firma działająca wyłącznie online może mieć adres prawny dla celów zgodności, ale nie posiadać lokalnego lokalu. Nie zamieniaj ujawnienia prawnego w marketing lokalnej obecności.
• Praktyk w klinice może potrzebować rekordu praktyka, a klinika może potrzebować rekordu lokalizacji. Nie łącz ich nazwisk i numerów telefonów w hybrydową tożsamość.

Zasady pisania elementów mają pierwszeństwo: wybierz element zgodnie z celem fragmentu. Jeśli zadaniem fragmentu jest podanie kanonicznej nazwy, adresu i telefonu lokalizacji, użyj bloku NAP, nawet jeśli ogólna karta lub stopka mogłyby wyświetlić podobny tekst.

Gdzie go umieścić

Na dedykowanej stronie lokalizacji umieść główny blok NAP bezpośrednio po wstępnej identyfikacji i bezpośredniej odpowiedzi, a przed wskazówkami dojazdu, godzinami, usługami, recenzjami lub kontrolkami rezerwacji. Czytelnik powinien wiedzieć, które miejsce reprezentuje strona, zanim zinterpretuje jakiekolwiek lokalne twierdzenie. Jeśli hero już renderuje pełny kanoniczny rekord, późniejsza sekcja kontaktowa może go powtórzyć tylko z tego samego obiektu danych.

W profilu firmy umieść go w wyraźnie oznaczonej sekcji „Centrala” lub „Publiczna lokalizacja kontaktowa”, a nie pod ogólnym nagłówkiem „O firmie”. W indeksie katalogowym umieść jeden kompaktowy blok w każdym odpowiadającym wpisie i połącz całą grupę tożsamościową z właściwym profilem oddziału. W stopce witryny używaj tylko głównej publicznej lokalizacji lub jawnego selektora lokalizacji; stopka jest zbyt ciasna na nieoznaczoną mieszankę kilku biur.

Blok może znajdować się obok godzin, mapy, wskazówek dojazdu, parkingu lub przycisku rezerwacji tylko wtedy, gdy każdy sąsiedni komponent używa tego samego ID lokalizacji. Nie może znajdować się obok pinezki mapy dla innego wejścia, ogólnofirmowej centrali oznaczonej jako linia oddziału, adresu magazynu tylko do dostaw ani selektora lokalizacji, którego bieżący wybór jest niejasny. Nie umieszczaj reklamy, referencji, formularza newslettera ani oferty promocyjnej między nazwą a adresem lub między adresem a telefonem. Te przerwy niszczą rekord wizualnie i w kolejności czytania.

Na urządzeniach mobilnych zachowaj kolejność: nazwa, ulica, miejscowość, region i kod pocztowy, w razie potrzeby kraj, a następnie telefon. Nie pozwól, by przyklejony przycisk połączenia zastąpił widoczny numer lub zasłonił, który oddział wywołuje.

Anatomia

1. Nazwa lokalizacji: zatwierdzona nazwa widoczna dla klientów, zawierająca kwalifikator oddziału tylko wtedy, gdy jest używany konsekwentnie.
2. Adres uliczny: numer i nazwa ulicy umożliwiające doręczenie, a nie opis punktu orientacyjnego.
3. Podlokal: apartament, lokal, piętro, budynek lub wydział potrzebny do dotarcia do właściwego miejsca.
4. Miejscowość i region: miasto lub miejscowość plus wartość zarządzanego stanu, prowincji, hrabstwa lub regionu.
5. Kod pocztowy i kraj: kompletny kod sortowania i kraj, w tym kraj, gdy odbiorcy lub syndykacja przekracza granice.
6. Wyświetlany telefon: czytelny dla człowieka numer sformatowany dla odbiorców danej lokalizacji.
7. Cel telefoniczny: ten sam numer znormalizowany do wybierania, zwykle w formacie E.164 wewnątrz linku tel:.
8. ID lokalizacji: stabilny wewnętrzny klucz, który zapobiega mieszaniu szczegółów oddziałów podczas renderowania lub syndykacji.
9. Metadane weryfikacji: data oraz autorytatywny system lub właściciel, względem których rekord został sprawdzony.

Przykłady projektowe

Każdy wariant używa tego samego podstawowego rekordu lokalizacji. Gęstość i otaczające akcje mogą się zmieniać, ale mechanizm renderujący nie może skracać apartamentu, zastępować numeru ogólnofirmowego ani ukrywać adresu wymaganego do odróżnienia oddziału.

Standardowa lokalizacja. Domyślny wariant pokazuje każdy komponent w pionowej, łatwej do skopiowania grupie. Użyj go na dedykowanej stronie lokalizacji lub oddziału.

Kompaktowy pasek kontaktowy. Użyj w stopce lub pasku kontaktowym, gdy jedna publiczna lokalizacja reprezentuje stronę. Może zwijać się do wierszy na wąskich ekranach, ale nie może obcinać jednostki, kodu pocztowego ani telefonu.

Karta katalogowa. Powtórz jeden kompaktowy blok NAP na lokalizację. Trzymaj filtry, odległość, „otwarte teraz” i etykiety usług poza polami tożsamości, aby stany dynamiczne nie mogły nadpisać kanonicznego rekordu.

Lokalizacja tylko po wcześniejszym umówieniu. Pokaż pełny publiczny blok NAP, gdy klienci mogą odwiedzić, a następnie dodaj „Wymagana rezerwacja” jako oddzielną notatkę operacyjną. Nie wstawiaj tego wyrażenia do linii adresu.

Międzynarodowy. Zachowaj kolejność adresu oczekiwaną w kraju docelowym, przechowując każdy komponent osobno. Wyświetl lokalną konwencję telefoniczną dla czytelników i zachowaj międzynarodową wartość wybierania dla linku i warstwy danych.

Parametry

„Źródło” poniżej oznacza, skąd mechanizm renderujący pobiera pole. Autorytatywny dla wartości tożsamościowych pozostaje zarządzany rejestr lokalizacji firmy, a nie treść artykułu.

Przechowuj komponenty osobno, nawet jeśli mechanizm renderujący łączy je do wyświetlenia. Pojedynczy blob address="1200 Example Avenue, Washington..." uniemożliwia sortowanie specyficzne dla kraju, wiarygodne porównania i ukierunkowaną korektę błędnego apartamentu lub kodu pocztowego.

Składnia i przykłady kodu

Wszystkie trzy formy kodują ten sam ID lokalizacji i pola kanoniczne. Przenośna dyrektywa jest autorskim kontraktem; projekt musi zarejestrować i przetestować swoje adaptery Hugo i WordPress przed opublikowaniem składni.

Przenośna dyrektywa Markdown

:::nap{location-id="NSH-DC-01" name="Northstar Heating — Capitol Hill" street-address="1200 Example Avenue|Suite 210" locality="Washington" region="DC" postal-code="20001" country="US" phone="+12025550147" phone-display="(202) 555-0147" verified="2026-08-27" source="location-registry"}
## Northstar Heating — Capitol Hill

Note: Visits by appointment.
:::

Shortcode Hugo

{{< nap location-id="NSH-DC-01" name="Northstar Heating — Capitol Hill" street-address="1200 Example Avenue|Suite 210" locality="Washington" region="DC" postal-code="20001" country="US" phone="+12025550147" phone-display="(202) 555-0147" verified="2026-08-27" source="location-registry" >}}
## Northstar Heating — Capitol Hill

Note: Visits by appointment.
{{< /nap >}}

Wszystkie parametry shortcode są nazwane. Adapter musi escapować tekst, wygenerować grupę <address> i link tel:, udostępnić ID lokalizacji warstwie danych oraz zachować notatkę w treści poza adresem pocztowym.

Blok WordPress

<!-- wp:amicited/nap {"locationId":"NSH-DC-01","name":"Northstar Heating — Capitol Hill","streetAddress":["1200 Example Avenue","Suite 210"],"locality":"Washington","region":"DC","postalCode":"20001","country":"US","phone":"+12025550147","phoneDisplay":"(202) 555-0147","verified":"2026-08-27","source":["location-registry"],"variant":"standard"} -->
<div class="wp-block-amicited-nap">Server-rendered from canonical location fields.</div>
<!-- /wp:amicited/nap -->

Blok WordPress powinien używać typowanych pól inspektora i renderowania po stronie serwera. Autorzy mogą wybrać rekord lokalizacji i dodać zatwierdzoną notatkę, ale nie powinni przepisywać kanonicznej nazwy, adresu ani telefonu w formacie Rich Text.

Przykłady

Poprawny: jedna kompletna, przypisana lokalizacja

Northstar Heating — Capitol Hill
1200 Example Avenue, Suite 210
Washington, DC 20001, Stany Zjednoczone
(202) 555-0147
Lokalizacja NSH-DC-01 · Zweryfikowano 27 sierpnia 2026 względem zatwierdzonego rejestru lokalizacji

Działa to, ponieważ kwalifikator oddziału, apartament, kod pocztowy, kraj, wyświetlany numer, cel wybierania, stabilny ID, data i źródło wszystkie opisują jeden rekord. Czytelnik może odwiedzić lub zadzwonić; crawler może wyodrębnić te same wartości; audytor może porównać blok z wpisem w katalogu bez zgadywania, które biuro kontroluje stronę.

Niepoprawny: pozornie poprawna kompilacja

Northstar Heating Washington
Near Capitol Hill, Washington DC
Zadzwoń do naszego zespołu: 555-0147 lub do centrali
Otwarte w pobliżu

To nie działa, ponieważ „Near Capitol Hill” nie jest adresem do doręczeń, lokalny numer nie zawiera kontekstu kierunkowego i krajowego, „centrala” nie ma numeru, a nazwa nie identyfikuje zarządzanego oddziału. „Otwarte w pobliżu” miesza godziny i odległość z tożsamością bez podstawy lokalizacji lub czasu. Bloku nie można z pewnością dopasować do rekordu mapy, cytatu w katalogu, encji schematu ani wewnętrznego źródła.

Napraw to, wybierając dokładny ID lokalizacji, rozwiązując każde pole z rejestru, publikując pełny publiczny adres i monitorowany telefon oraz przenosząc godziny lub twierdzenia o odległości do własnych komponentów.

Znaczniki schematu i dostępność

Blok NAP może zasilać kwalifikującą się encję Organization, podtyp LocalBusiness lub inną encję opartą na miejscu. Zmapuj widoczne name, telephone i komponenty adresu na PostalAddress: streetAddress, addressLocality, addressRegion, postalCode i addressCountry. Użyj najbardziej szczegółowego prawdziwego typu biznesowego obsługiwanego przez stronę; nie wybieraj kategorii wyłącznie w celu uzyskania funkcji wyszukiwania.

Dane strukturalne muszą identyfikować tę samą lokalizację, którą identyfikuje strona. Nie umieszczaj centrali w JSON-LD, pokazując oddział w bloku, nie łącz kilku oddziałów w jeden adres ani nie dodawaj szerokości i długości geograficznej odczytanej z kodu pocztowego. Jeśli każdy oddział ma własną stronę i trwałą encję, użyj stabilnego kanonicznego URL i zarządzanego identyfikatora, aby utrzymać rozdzielność grafów. Data weryfikacji i źródło wspierają wewnętrzne zarządzanie, ale nie wymagają publicznych właściwości Schema.org.

Użyj elementu <address> dla danych kontaktowych lokalizacji reprezentowanej przez stronę lub sekcję. Nie zakładaj, że <address> oznacza dowolny adres pocztowy; jego znaczenie HTML to dane kontaktowe dla odpowiedniego artykułu lub właściciela strony. Umieść nazwę lokalizacji w nagłówku, oznacz powtarzane karty katalogowe i zachowaj logiczną kolejność źródła.

Widoczny numer telefonu musi pozostać tekstem, a nie ikoną lub obrazem. Połącz go z href="tel:+12025550147" gdy dzwonienie jest właściwe, ale zachowaj czytelny lokalny wyświetlacz. Nie dziel poszczególnych cyfr na stylowane spany, nie wymawiaj interpunkcji przez niedokładną etykietę dostępności ani nie ukrywaj niezbędnych numerów wewnętrznych w dymku. Upewnij się, że fokus klawiatury jest widoczny, cel linku zawiera oddział, gdy kilka linków połączeń pojawia się razem, a powiększenie lub przepływ nie oddziela apartamentu lub kodu pocztowego od adresu.

Zasady pisania

Te zasady chronią przede wszystkim rozpoznawalność tożsamości; wizualna schludność jest drugorzędna:

• Używaj dokładnie jednej nazwy widocznej dla klientów, jednego adresu i jednego głównego telefonu na blok. Jeśli dodatkowy numer jest operacyjnie niezbędny, oznacz jego cel poza kanonicznym trio NAP.
• Utrzymuj nazwę w granicach 2–100 znaków. Używaj rzeczywistej publicznej marki i zarządzanego kwalifikatora oddziału; nie dodawaj słów kluczowych takich jak „najlepszy hydraulik awaryjny w Warszawie.”
• Używaj 1–3 linii adresu ulicznego, każda nie dłuższa niż 100 znaków. Zachowaj apartament, lokal, piętro, budynek i informacje kierunkowe wymagane do doręczenia lub dotarcia.
• Używaj pełnego adresu pocztowego dla lokali publicznych. Nigdy nie zastępuj go „centrum”, „koło stacji”, pinezką mapy ani wskazówkami dojazdu.
• Przechowuj kraj jako dwuliterowy kod i renderuj jego czytelną dla człowieka nazwę, gdy kontekst odbiorców tego wymaga. Nigdy nie wnioskuj o kraju wyłącznie z domeny najwyższego poziomu.
• Przechowuj numery telefonów w formacie E.164 i renderuj znajomą lokalną formę. Dołącz numer wewnętrzny jako oddzielną zarządzaną wartość, gdy routing jest od niego zależny.
• Używaj rzeczowego, administracyjnego tonu. Blok może mówić „Wymagana rezerwacja” lub „Brak dostępu publicznego”; nie może zawierać sloganów, twierdzeń o usługach, recenzji, nagród, rabatów, komunikatów pilności ani list słów kluczowych.
• Nie umieszczaj godzin, wskazówek dojazdu, instrukcji parkowania, obszarów usług, dostępności terminów, adresów e-mail, numerów faksów ani profili społecznościowych wewnątrz trzech pól tożsamości. Sąsiednie oznaczone pola są dopuszczalne, gdy ich własność i częstotliwość aktualizacji są jasne.
• Nie nadpisuj po cichu wartości kanonicznej, aby dopasować ją do zewnętrznego katalogu. Zbadaj, czy zewnętrzny rekord jest nieaktualny, zatwierdzonym aliasem czy faktycznie inną lokalizacją, a następnie skoryguj odpowiednie źródło.
• Rejestruj datę weryfikacji i źródło dla każdej opublikowanej instancji. Ponownie weryfikuj po przeprowadzkach, rebrandingach, zmianach routingu telefonicznego, fuzjach, zamknięciach oddziałów, zmianach apartamentów i migracjach katalogów.
• Traktuj interpunkcję i skróty jako różnice prezentacyjne tylko wtedy, gdy normalizacja udowodni, że podstawowe komponenty są zgodne. Zmieniona cyfra, apartament, kod pocztowy lub kwalifikator oddziału są istotne.

Typy postów, które go używają

Tabela jest zarządzana przez postTypes[] w metadanych (frontmatter). Dodaj lub usuń wiersz tylko wtedy, gdy odpowiednia tablica się zmieni.

Lista kontrolna QA

• Blok pochodzi z jednego stabilnego ID lokalizacji, a nie z niezależnie wpisywanych pól.
• Publiczna nazwa jest zgodna z zarządzaną marką i polityką nazewnictwa oddziałów, bez dodatkowych słów kluczowych.
• Numer ulicy, nazwa ulicy, kierunek, apartament lub lokal, miejscowość, region, kod pocztowy i kraj zostały sprawdzone względem autorytatywnego źródła.
• Adres jest ważny dla deklarowanego działania klienta: wizyty, korespondencji, odbioru lub innego wyraźnie oznaczonego celu.
• Prywatne domy, biura agentów do doręczeń, magazyny i wirtualne biura nie są prezentowane jako lokalizacje klientów.
• Wyświetlany telefon i cel tel: normalizują się do tego samego monitorowanego miejsca docelowego.
• Sąsiednie godziny, mapa, wskazówki dojazdu, rezerwacja i komponenty CTA używają tego samego ID lokalizacji.
• Żaden sąsiedni blok nie jest sprzeczny z adresem, telefonem, nazwą oddziału, polityką odwiedzin ani wyborem lokalizacji.
• Znormalizowane porównanie odróżnia nieszkodliwe różnice formatowania od zmienionych cyfr, jednostek lub komponentów pocztowych.
• Widoczna treść i znaczniki Organization, LocalBusiness lub PostalAddress są zgodne pole po polu.
• Powtarzane bloki mają unikalne nagłówki lub dostępne etykiety, a każdy link telefoniczny ma jasny cel.
• Pełny rekord pozostaje czytelny, kopiowalny, dostępny klawiaturowo i prawidłowo uporządkowany przy 200% powiększeniu oraz na wąskim ekranie.
• Data weryfikacji i źródło są obecne, a nazwany właściciel otrzymuje raporty o niezgodnościach.
• Przeprowadzki, zamknięcia, rebrandingi, zmiany numerów i zatwierdzone aliasy mają ścieżkę aktualizacji na stronie internetowej, profilach, katalogach i kanałach danych.

FAQ

Co oznacza NAP w lokalnym SEO?

NAP oznacza nazwę, adres i telefon. Blok NAP publikuje te trzy fakty tożsamościowe dla jednej lokalizacji biznesowej w kanonicznej, opisanej formie, którą ludzie i maszyny mogą odczytać bez łączenia szczegółów z różnych oddziałów.

Czy interpunkcja musi być identyczna na każdej stronie internetowej?

Nie. Nieszkodliwe różnice prezentacyjne, takie jak „Suite” versus „Ste.” czy lokalnie sformatowany versus międzynarodowy wyświetlacz telefonu, nie tworzą odrębnego podmiotu, gdy podstawowe wartości normalizują się do tych samych faktów. Audytuj znormalizowane pola, zachowując jedną preferowaną formę wyświetlania pod swoją kontrolą.

Czy firma świadcząca usługi na obszarze powinna publikować adres domowy?

Nie. Nie ujawniaj prywatnego adresu ani adresu, który nie kwalifikuje się dla klientów, tylko po to, by uzupełnić blok. Opublikuj nazwę firmy widoczną dla klientów i monitorowany telefon, podaj informację, że usługa jest świadczona w lokalizacjach klientów, a prywatny adres przechowuj w zarządzanych systemach, które rzeczywiście go wymagają.

Czy jeden blok NAP może zawierać kilka oddziałów?

Nie. Jeden blok reprezentuje jeden rekord lokalizacji. Katalog może powtórzyć komponent raz na oddział, ale każda instancja potrzebuje własnego identyfikatora lokalizacji, adresu, telefonu, źródła i strony docelowej, aby szczegóły nie mogły zostać przypadkowo połączone.

Jak często należy sprawdzać informacje NAP?

Sprawdzaj je za każdym razem, gdy zmienia się lokalizacja, numer, polityka nazewnictwa lub wpis w katalogu, i uwzględnij je w cyklicznym audycie danych lokalnych. Odpowiedni odstęp czasu zależy od tempa zmian operacyjnych; blok powinien rejestrować datę ostatniej weryfikacji i autorytatywne źródło, zamiast sugerować trwałą dokładność.