9 min lesetid Store Locator
HTML-kode for en butikksøker: hva det krever
En enkel gjennomgang av hva HTML-koden for en butikksøker faktisk inneholder, hvordan geolokalisering og produktsøk passer inn, og hvor du limer den inn på hver plattform.
HTML-kode for en butikksøker er et lite embed: et container-element pluss en skript-tag som laster et kart, leser adressedataene dine og sorterer resultatene etter avstand. Kartleverandøren, geolokaliseringsmetoden og om kunder kan søke på produkt, er separate valg som legges på denne basen.
En forhandler skriver sjelden denne koden selv. Vanligvis genererer en utvidelse, en app eller en SaaS-widget den og gir deg et enkelt utdrag å lime inn. Å vite hva den inneholder hjelper likevel, fordi det viser hva du kan tilpasse.
Hva utdraget faktisk inneholder
Tre deler utgjør en fungerende butikksøker. Et kartbibliotek tegner opp fliser og nuler, med Google Maps, Mapbox, Leaflet med OpenStreetMap-fliser, eller en leverandørs egen vektor-renderer.
En kilde for adressedata leverer adresser og koordinater, som en statisk JSON-array, en CSV-fil omgjort til JSON, eller et API-kall i sanntid. En avstandsfunksjon, nesten alltid haversine-formelen på breddegrad og lengdegrad, sorterer adresser etter hvor langt de ligger fra kunden.
Geolokalisering trenger en reserveplan, ikke bare et spørsmål
En søker kan finne kunden på to måter. Nettleserens geolokalisering spør om tillatelse og returnerer en presis enhetsposisjon, mens en IP-basert estimering hopper over det spørsmålet og i stedet returnerer en estimering på bynivaa.
Kunder som avviser det spørsmålet forventer likevel et fungerende "nær meg"-søk på mobil. En praktisk løsning er å falle tilbake på en IP-basert estimering eller et manuelt adressesok når kunden avviser spørsmålet.
Hvor du faktisk limer inn koden, etter plattform
På Shopify limer forhandlere sjelden inn HTML. Temaarkitekturen viser innhold fra tredjeparts-apper via app blocks, som lar en app legge til innhold i et tema uten å redigere temakoden, så en søker installeres som en blokk i stedet for et kopiert utdrag.
WordPress fungerer i stedet via sin blokkredigerer: en kortkode plassert i en hvilken som helst blokk viser søkeren på den siden, uten HTML. Vår WordPress-guide går gjennom hele oppsettet av en utvidelse.
Code Block i Squarespace er det dokumenterte stedet for egen HTML, selv om JavaScript og iframes inni det krever Core-planen eller høyere. Wix tilbyr i stedet et Embed HTML-element for å lime inn et utdrag, eller en søker-app fra sin App Market; vår Wix-guide dekker den ruten.
Mange andre nettstedbyggere, inkludert Webflow, BigCommerce og Elementor, tilbyr et lignende embed- eller HTML-element for samme formal.
En sjekkliste før du bygger, egenutviklet eller widget
Valget mellom en egen løsning og en ferdig widget kommer ned til fire kontroller:
- Bekreft hvor plattformen din lar deg legge til egen kode: en blokk, et element eller en app-installasjon.
- Sjekk nøkkelbehovet til kartleverandøren separat; Google Maps og Mapbox krever begge en egen nøkkel fra forhandleren, og Google Maps krever også en faktureringskonto.
- Bestem hvordan adressedata skal holdes oppdatert: manuelle endringer, et synkronisert regneark, eller en live-feed fra handelsplattformen din.
- Test geolokalisering på en ekte telefon med tillatelse avslått, ikke bare gitt, fordi det er der "nær meg"-søk vanligvis svikter.
Hva søk på produktnivå faktisk krever
En butikksøker finner et sted. En produktsøker svarer på et mer presist spørsmål, hvilken av adressene dine som nå har en bestemt vare, og det krever lagerdata knyttet til hver adresse, ikke bare et kart.
| Krav | Hva det gjør | Shopify-kilde |
|---|---|---|
| Adresseposter | Butikk eller hentepunkt | Location object |
| Lager per adresse | Lager per produkt | inventoryLevels |
| Produktfilter | Vis vare på lager | storeAvailability |
Radene om adresse og lager kommer fra Shopifys egen Location API og finnes uavhengig av hvilken app du installerer. Tilgjengelighet per adresse for en variant eksponeres også nativt via storeAvailability-feltet i Storefront API, bygget for henting i butikk, selv om å gjøre det til et kartfilter fremdeles er appens jobb.
Still en leverandør to spørsmål før du bestemmer deg:
- Oppdateres produkttilgjengelighet automatisk fra lageret, eller holder noen den oppdatert manuelt?
- Hva viser siden når hver nærliggende adresse er utsolgt?
Oppsummering
En butikksøker er klar når kartet laster rent, en geolokaliseringstest med avslått tillatelse fremdeles gir nærliggende resultater, og et produktsøk, hvis du har bygget et, utelukker en adresse du vet er utsolgt. Alt utover det er finpussing.
Det meste av denne beslutningen handler om data, ikke design: hvor adressene dine bor, hvor oppdaterte de forblir, og om produkttilgjengelighet spores et sted nær sanntid. Gjør det riktig først, så blir kartet under den enkle delen.
Ofte stilte spørsmål
Trenger HTML-kode for en butikksøker en Google Maps API-nøkkel?
Bare hvis du velger Google Maps, som krever forhandlerens egen API-nøkkel og en faktureringskonto. Mapbox krever i stedet sin egen tilgangstoken, mens kart bygget på OpenStreetMap-lignende data klarer seg helt uten nøkkel.
Hva er forskjellen mellom en butikksøker og en produktsøker?
En butikksøker viser hvor adressene dine er. En produktsøker viser hvilken av disse adressene som nå har en bestemt vare på lager, noe som krever lagerdata bak kartet.
Kan jeg legge til en butikksøker uten å skrive kode?
Ja: apper, utvidelser og SaaS-widgeter genererer embedet for deg. Progus Store Locator er et alternativ: en temablokk på Shopify, en kortkode på WordPress, en App Market-installasjon på Wix, administrert fra Shopify-appen eller webdashbordet; andre steder er det et enkelt embed-utdrag.
Spør geolokalisering alltid kunden om tillatelse?
Nei. En IP-basert estimering kan plassere en kunde på bynivaa uten noe spørsmål. Det gjør den til en rimelig reserveplan for kunder som avviser nettleserens spørsmål.
Legg til butikkfinner på nettstedet ditt. Mer om Store Locator ›