Si të shtoni harta në aplikacionin tuaj: trupa, harta interaktive dhe gjetës dyqanesh

Për të shtuar një hartë te aplikacioni juaj, vendosni fillimisht nëse ju duhet një trupë statike (një vend me një shenjues, si "gjeni dyqanin tonë") ose një hartë interaktive (shumë shenjues nga të dhënat tuaja, filtra, grupime, "pranë meje"). Për një vend të vetëm, një hartë e trupëzuar është më e shpejta dhe, me Maps Embed API të Google, falas. Për harta interaktive, përdorni një bibliotekë harte JavaScript — Google Maps JavaScript API, Mapbox GL JS, ose Leaflet me burim të hapur me një ofrues pllakash — ruani latitudën dhe longitudën e çdo vendi në bazën tuaj të të dhënave, dhe kufizoni çelësin API në domenin tuaj. Detajet e ofruesve më poshtë janë nga dokumentacioni i vetë ofruesve, si i shtatorit 2026.

Çfarë lloj harte ju duhet?

Shumica e sajteve të vogla biznesi kanë nevojë vetëm për rreshtin e parë. Drejtoritë, tregjet dhe sajtet e listimeve kanë nevojë për rreshtin e tretë dhe të katërt.

Opsionet tuaja

Google Maps Platform

Udhëzuesi i fillimit i Google thotë se duhet të krijoni një projekt Cloud me faturim të aktivizuar dhe të aktivizoni API-t që dëshironi. Çmimi pay-as-you-go i tij u jep SKU-ve Essentials, përfshi Dynamic Maps, një kufi falas prej 10,000 ngjarjesh në muaj, dhe e shënon Dynamic Maps me 7.00 USD për 1,000 ngjarje mbi atë (në nivelin e parë të vëllimit). SKU-ja Maps Embed shënohet si e pakufizuar dhe falas. Google shet gjithashtu plane abonimi mujore. Kontrolloni çmimet e Google Maps Platform për numrat aktualë.

Mapbox

Faqja e çmimeve të Mapbox shfaq 50,000 ngarkime falas hartash në muaj për Mapbox GL JS në web, pastaj 5.00 USD për 1,000 ngarkime. Shihni çmimet e Mapbox.

Leaflet dhe OpenStreetMap

Leaflet e përshkruan veten si një bibliotekë JavaScript me burim të hapur për harta interaktive që funksionojnë mirë në celular, me rreth 42 KB JavaScript. Ai ka nevojë për pllaka harte (imazhet e hartës) nga diku. Serverët publikë të pllakave të OpenStreetMap janë tundues, por politika e përdorimit të pllakave kërkon atribuim të dukshëm, ndalon shkarkimin masiv, nuk ofron garanci shërbimi, dhe paralajmëron që shërbimet komerciale mund të humbasin aksesin. Për një produkt të vërtetë, përdorni një burim pllakash komercial ose të vetë-strehuar që funksionon me Leaflet.

Çelësat API: publikë, por të kufizuar

Çelësat e hartave të përdorura në shfletues janë të dukshëm për çdo kë që hap faqen tuaj. Kjo është e pritshme, por do të thotë që dikush mund ta kopjojë çelësin tuaj dhe të ngrejë përdorimin në faturën tuaj. Udhëzimi i sigurisë i Google është të shtoni kufizime sipas referuesit HTTP (website) që listojnë domenet tuaja, dhe kufizime API që e bëjnë çelësin të funksionojë vetëm për API-t që përdorni.

Çelësat për shërbime në server — për shembull gjeokodimin e mijëra adresave — duhet të jenë çelësa të veçantë dhe të mbajtur te sekretet e serverit, jo në faqe. Vendosni gjithashtu alarme buxheti ose kuota në konsolën e ofruesit, që një gabim të mos kthehet në faturë të madhe.

Gjeokodimi: ktheni adresat në koordinata një herë

Hartat vizatojnë latitudën dhe longitudën, jo adresat. Kthimi i një adrese në koordinata quhet gjeokodim, dhe shumica e ofruesve e paguajnë për kërkesë. Modeli efikas:

1. Kur ruhet një listim, gjeokodoni adresën në server.
2. Ruani latitudën dhe longitudën në bazën e të dhënave.
3. Harta lexon koordinatat e ruajtura; kurrë nuk gjeokodon në shikim faqeje.

Kontrolloni kushtet e çdo ofruesi për sa kohë lejohet të ruani rezultatet e gjeokodimit; ato ndryshojnë.

Shembuj kërkesash

Një hartë e vetme e trupëzuar:

Te faqja Contact, shto një hartë Google të trupëzuar që tregon adresën tonë (12 High Street, Leeds) duke përdorur Maps Embed API, me çelësin te GOOGLE_MAPS_EMBED_KEY. Shto një lidhje "Merr drejtimet" poshtë saj. Bëje me gjerësi të plotë në telefona dhe ngarko me vonesë.

Një hartë interaktive e listimeve:

Shto latitude dhe longitude te tabela e listimeve. Kur krijohet një listim ose ndryshon adresa, gjeokodoje në server me çelësin te GEOCODING_API_KEY dhe ruaj koordinatat. Te faqja Browse, shfaq një hartë me një shenjues për çdo listim duke përdorur Leaflet, me grupim kur shenjuesit mbivendosen. Klikimi i një shenjuesi tregon titullin, çmimin dhe një lidhje. Harta dhe lista duhet të përdorin të njëjtët filtra.

"Pranë meje":

Shto një buton "Pranë meje" që kërkon vendndodhjen e vizitorit dhe shfaq listimet brenda 10 km, të renditura sipas distancës. Nëse refuzon qasjen te vendndodhja, lëreni të shkruajë një qytet.

Hap pas hapi

1. Zgjidhni llojin e hartës nga tabela në fillim.
2. Krijoni llogarinë e ofruesit dhe një projekt, dhe aktivizoni vetëm API-t që ju duhen.
3. Krijoni çelësat: një çelës për shfletuesin, i kufizuar në domenet tuaja (përfshi domenin e pamjes paraprake gjatë ndërtimit) dhe, nëse duhet, një çelës serveri për gjeokodim.
4. Ruajini çelësat si sekrete dhe kërkojani ndërtuesit tuaj t'i përdorë; çelësi i shfletuesit mbetet i kufizuar edhe pse përfundon në faqe.
5. Ruani koordinatat për çdo vend në bazën tuaj të të dhënave.
6. Ndërtoni hartën: shenjuesit, dritaret kërcyese, grupimi dhe një zoom fillestar i arsyeshëm.
7. Çiftojeni me një listë. Një hartë e vetme është e vështirë për t'u përdorur në telefon dhe për lexuesit e ekranit. Shfaqni të njëjtat rezultate si listë.
8. Vendosni një alarm buxheti në konsolën e ofruesit.
9. Publikoni dhe testoni në domenin e drejtpërdrejtë, sepse kufizimet e referuesit shpesh bllokojnë hartën derisa të shtohet domeni i drejtpërdrejtë.

Gabimet më të shpeshta

• Çelësa pa kufizime. Kushdo mund t'i ripërdorë në sajtin e vet.
• Gjeokodim në çdo shikim faqeje. E ngadaltë dhe e shtrenjtë; gjeokodoni një herë në ruajtje.
• Harrimi i domenit të drejtpërdrejtë te kufizimet e çelësit. Funksionon në pamjen paraprake, kuti gri bosh në prodhim.
• Dizajne vetëm me hartë. Shenjuesit pa listë janë të mundimshëm në ekrane të vegjël dhe të papërdorshëm për personat me aftësi të kufizuara.
• Qindra shenjues pa grupim. Të palexueshëm dhe të ngadaltë.
• Atribuimi i munguar. Shumica e ofruesve të hartave dhe pllakave e kërkojnë atë, dhe fshehja e tij cenon kushtet e tyre.
• Kërkimi i vendndodhjes në ngarkimin e faqes. Kërkojeni vetëm kur përdoruesi prek "Pranë meje".

Listë kontrolli

• Lloji i duhur i hartës i zgjedhur për punën
• Çelësi i shfletuesit i kufizuar në domenet tuaja dhe API-t e nevojshëm
• Çelësat e serverit të mbajtur në sekrete
• Koordinatat të ruajtura në bazën e të dhënave, gjeokoduar një herë
• Rezultatet shfaqen edhe si listë
• Grupim për shumë shenjues
• Atribuimi i dukshëm
• Alarm buxheti i vendosur me ofruesin
• Testuar në domenin e publikuar dhe në telefon

Shtimi i hartave me Mythex

Mythex nuk ka integrim të integruar hartash; ju sillni çelësin tuaj të ofruesit, e shtoni si sekret projekti (ose e ngjitni kur agjenti shfaq një kartelë sekretesh), dhe e kërkoni hartën në chat, siç përshkruhet te Integro çdo API. Koordinatat shkojnë në bazën e të dhënave të projektit. Mos harroni të shtoni si domenin e pamjes paraprake, ashtu edhe atë të publikuar te kufizimet e sajtit të çelësit, dhe publikoni përsëri pas ndryshimit të sekreteve.

Hartat zakonisht ndodhen pranë kërkimit dhe listimeve: shihni si të shtoni kërkim në aplikacionin tuaj, si të ndërtoni një faqe drejtorie dhe si të ndërtoni një sajt për biznes të vogël.

Pyetje