Hvernig á að bæta kortum við appið þitt: innfellingar, gagnvirk kort og staðsetningarleitir

Til að bæta korti við appið þitt skaltu fyrst ákveða hvort þú þurfir kyrrstæða innfellingu (einn staður með nælu, eins og „finndu verslunina okkar“) eða gagnvirkt kort (margar nálar úr gögnunum þínum, síur, þyrpingar, „nálægt mér“). Fyrir einn stað er innfellt kort fljótlegast og, með Maps Embed API frá Google, ókeypis. Fyrir gagnvirk kort notarðu JavaScript-kortasafn — Google Maps JavaScript API, Mapbox GL JS, eða opna Leaflet með flísaveitu — geymir breiddar- og lengdargráðu hvers staðar í gagnagrunninum þínum og takmarkar API-lykilinn við þitt eigið lén. Upplýsingar um þjónustuaðila hér að neðan eru af vefsíðum þeirra eins og þær voru í september 2026.

Hvers konar kort þarftu?

Flest lítil fyrirtækjasíður þurfa aðeins fyrstu línuna. Skrár, markaðstorg og auglýsingasíður þurfa þá þriðju og fjórðu.

Valkostirnir þínir

Google Maps Platform

Leiðbeiningar Google um að byrja segja að þú verðir að búa til Cloud-verkefni með virkri greiðslu og virkja þau API sem þú vilt. Greiðslu-eftir-notkun verðlagning þeirra gefur Essentials-einingar, þar með talið Dynamic Maps, 10.000 ókeypis atburði á mánuði í kvóta, og skráir Dynamic Maps á $7,00 á hverja 1.000 atburði umfram það (á fyrsta magnþrepi). Maps Embed-einingin er skráð sem ótakmörkuð og ókeypis. Google selur líka mánaðarlegar áskriftaráætlanir. Athugaðu verðlagningu Google Maps Platform fyrir núverandi tölur.

Mapbox

Verðsíða Mapbox skráir 50.000 ókeypis kortahleðslur á mánuði fyrir Mapbox GL JS á vefnum, síðan $5,00 á hverja 1.000 hleðslur. Sjá verðlagningu Mapbox.

Leaflet og OpenStreetMap

Leaflet lýsir sér sem opnu JavaScript-bókasafni fyrir farsímavæn gagnvirk kort, um 42 KB af JavaScript. Það þarf kortaflísar (myndirnar af kortinu) frá einhverjum stað. Opinberir flísaþjónar OpenStreetMap eru freistandi, en notkunarstefna flísa krefst sýnilegrar tilvísunar, bannar fjöldaniðurhal, býður enga þjónustutryggingu og varar viðskiptaþjónustur við því að aðgangur geti verið afturkallaður. Fyrir raunverulega vöru skaltu nota viðskiptalega eða sjálfhýsta flísagjafa sem virkar með Leaflet.

API-lyklar: opinberir, en takmarkaðir

Kortalyklar sem eru notaðir í vafra eru sýnilegir hverjum sem opnar síðuna þína. Það er eðlilegt, en þýðir að einhver gæti afritað lykilinn og keyrt upp notkun á reikningnum þínum. Leiðbeiningar Google um öryggi mæla með takmörkunum á vefslóð (HTTP-vísun) sem skráir lénin þín, og API-takmörkunum svo lykillinn virki aðeins fyrir þau API sem þú notar.

Lyklar fyrir þjónustur á þjóni — til dæmis staðsetningarleit þúsunda heimilisfanga — ættu að vera aðskildir lyklar, geymdir sem leyndarmál á þjóninum, ekki á síðunni. Stilltu líka viðvaranir um kostnað eða kvóta í stjórnborði veitunnar svo mistök verði ekki að stórum reikningi.

Staðsetningarleit: breyttu heimilisföngum í hnit einu sinni

Kort teikna breiddar- og lengdargráðu, ekki heimilisföng. Að breyta heimilisfangi í hnit kallast staðsetningarleit (geocoding), og flestar veitur rukka fyrir hverja beiðni. Skilvirka mynstrið:

1. Þegar færsla er vistuð skaltu staðsetja heimilisfangið á þjóninum.
2. Geymdu breiddar- og lengdargráðu í gagnagrunninum.
3. Kortið les geymdu hnitin; það staðsetur aldrei heimilisföng við skoðun síðunnar.

Athugaðu skilmála hverrar veitu um hversu lengi má geyma niðurstöður staðsetningarleitar; þeir eru mismunandi.

Dæmi um fyrirmæli

Eitt innfellt kort:

Á tengiliðasíðunni skaltu bæta við innfelldu Google-korti sem sýnir heimilisfangið okkar (12 High Street, Leeds) með Maps Embed API og lyklinum í GOOGLE_MAPS_EMBED_KEY. Bættu við hlekknum „Fá leiðbeiningar“ undir kortinu. Hafðu það í fullri breidd í símum og hladdu því með lazy-load.

Gagnvirkt kort af skráningum:

Bættu breiddar- og lengdargráðu við töfluna listings. Þegar skráning er búin til eða heimilisfang hennar breytist skaltu staðsetja heimilisfangið á þjóninum með lyklinum í GEOCODING_API_KEY og vista hnitin. Á Browse-síðunni skaltu sýna kort með nál fyrir hverja skráningu með Leaflet, og þyrpingu þegar nálar skarast. Smellur á nál sýnir titil, verð og hlekk. Kortið og listinn eiga að nota sömu síur.

„Nálægt mér“:

Bættu við hnappinum „Nálægt mér“ sem biður um staðsetningu gestsins og sýnir skráningar innan 10 km, raðaðar eftir fjarlægð. Ef hann hafnar aðgangi að staðsetningu skaltu leyfa honum að slá inn borg í staðinn.

Skref fyrir skref

1. Veldu tegund korts úr töflunni efst.
2. Búðu til aðgang hjá veitunni og verkefni, og virkjaðu aðeins þau API sem þú þarft.
3. Búðu til lykla: vafralykil takmarkaðan við lénin þín (þar með talið forskoðunarlénið á meðan þú smíðar) og, ef þörf er, þjónslykil fyrir staðsetningarleit.
4. Geymdu lykla sem leyndarmál og biddu smíðatólið um að nota þá; vafralykillinn er samt takmarkaður þó hann endi í síðunni.
5. Geymdu hnit fyrir hvern stað í gagnagrunninum.
6. Smíðaðu kortið: nálar, sprettigluggar, þyrping og skynsamlegt sjálfgefið aðdráttarstig.
7. Paraðu það við lista. Kort eitt og sér er erfitt í notkun í síma og fyrir skjálesara. Sýndu sömu niðurstöður sem lista.
8. Stilltu fjárhagsviðvörun í stjórnborði veitunnar.
9. Birtu og prófaðu á lifandi léninu, því takmarkanir á vísun lykils loka oft fyrir kortið þar til lifandi lénið er bætt við.

Algeng mistök

• Ótakmarkaðir lyklar. Hver sem er getur notað þá aftur á eigin síðu.
• Staðsetningarleit við hverja skoðun síðu. Hægt og dýrt; staðsettu einu sinni við vistun.
• Gleymt lifandi léninu í takmörkunum lykils. Virkar í forskoðun, auður grár reitur í framleiðslu.
• Útlit þar sem aðeins er kort. Nálar án lista eru erfiðar í litlum skjám og óaðgengilegar.
• Hundruð nála án þyrpingar. Ólæsilegt og hægt.
• Vantar tilvísun. Flestar kort- og flísaveitur krefjast hennar, og að fela hana brýtur skilmálana.
• Biðja um staðsetningu við hleðslu síðu. Biddu aðeins þegar notandinn ýtir á „Nálægt mér“.

Gátlisti

• Rétt tegund korts valin fyrir verkefnið
• Vafralykill takmarkaður við lénin þín og nauðsynleg API
• Þjónslyklar geymdir í leyndarmálum
• Hnit geymd í gagnagrunninum, staðsett einu sinni
• Niðurstöður líka sýndar sem listi
• Þyrping fyrir mörg merki
• Tilvísun sýnileg
• Fjárhagsviðvörun stillt hjá veitunni
• Prófað á birtu léni og í síma

Kort með Mythex

Mythex hefur enga innbyggða kortatengingu; þú kemur með þinn eigin veitulykil, bætir honum við sem leyndarmál verkefnisins (eða límir hann inn þegar agentinn sýnir leyndarmálskort), og biður um kortið í spjallinu, eins og lýst er í Tengdu hvaða API sem er. Hnit fara í gagnagrunn verkefnisins. Mundu að bæta bæði forskoðunarléninu og birta léninu við vefslóðatakmarkanir lykilsins, og birtu aftur eftir að leyndarmálum er breytt.

Kort eru yfirleitt við hliðina á leit og skráningum: sjá hvernig á að bæta leit við appið þitt, hvernig á að smíða skráavefsíðu og hvernig á að smíða vefsíðu fyrir lítil fyrirtæki.

Spurningar