როგორ დავამატოთ რუკა თქვენს აპში: ჩაშენებული რუკები, ინტერაქტიული რუკები და მაღაზიების მაძიებლები

აპში რუკის დასამატებლად ჯერ გადაწყვიტეთ, გჭირდებათ თუ არა სტატიკური ჩაშენება (ერთი ადგილი ნიშულით, მაგალითად „იპოვეთ ჩვენი მაღაზია“) თუ ინტერაქტიული რუკა (ბევრი ნიშული თქვენი მონაცემებიდან, ფილტრები, დაჯგუფება, „ახლოს ჩემთან“). ერთი ადგილისთვის ჩაშენებული რუკა ყველაზე სწრაფია და Google-ის Maps Embed API-ით უფასოა. ინტერაქტიული რუკებისთვის გამოიყენეთ JavaScript რუკის ბიბლიოთეკა — Google Maps JavaScript API, Mapbox GL JS ან ღია კოდის Leaflet tile პროვაიდერთან ერთად — შეინახეთ თითოეული ადგილის განედი და გრძედი მონაცემთა ბაზაში და შეზღუდეთ თქვენი API გასაღები თქვენს დომენზე. მომწოდებლების დეტალები ქვემოთ მათივე დოკუმენტაციიდან არის მოცემული, 2026 წლის სექტემბრის მდგომარეობით.

რა სახის რუკა გჭირდებათ?

პატარა ბიზნესის საიტების უმეტესობას მხოლოდ პირველი მწკრივი სჭირდება. დირექტორიებსა და ბაზრებს, რომლებიც განცხადებებს აქვეყნებენ, მესამე და მეოთხე სჭირდებათ.

თქვენი ვარიანტები

Google Maps Platform

Google-ის დაწყების სახელმძღვანელო ამბობს, რომ უნდა შექმნათ ანგარიშსწორებადი Cloud პროექტი და ჩართოთ სასურველი API-ები. მისი pay-as-you-go ფასები მოიცავს Essentials SKU-ებს, მათ შორის Dynamic Maps-ს, თვეში 10,000 მოვლენის უფასო ლიმიტით, და ჩამოთვლის Dynamic Maps-ს $7.00-ად 1,000 მოვლენაზე ამ ლიმიტის ზემოთ (პირველი მოცულობის საფეხურზე). Maps Embed SKU ჩამოთვლილია როგორც შეუზღუდავი და უფასო. Google ყიდის ასევე ყოველთვიურ საბსკრიფშენ გეგმებსაც. მიმდინარე ციფრებისთვის იხილეთ Google Maps Platform-ის ფასები.

Mapbox

Mapbox-ის ფასების გვერდი ჩამოთვლის 50,000 უფასო ყოველთვიურ რუკის ჩატვირთვას Mapbox GL JS-ისთვის ვებზე, შემდეგ $5.00 1,000 ჩატვირთვაზე. იხილეთ Mapbox-ის ფასები.

Leaflet და OpenStreetMap

Leaflet თავს აღწერს როგორც ღია კოდის JavaScript ბიბლიოთეკას მობილურისთვის მორგებული ინტერაქტიული რუკებისთვის, დაახლოებით 42 KB JavaScript-ით. მას სჭირდება რუკის tiles (რუკის გამოსახულებები) რაღაც წყაროდან. OpenStreetMap-ის საჯარო tile სერვერები საცდურია, მაგრამ tile-ების გამოყენების პოლიტიკა მოითხოვს ხილულ ატრიბუციას, კრძალავს მასობრივ ჩამოტვირთვას, სერვისის გარანტიას არ იძლევა და კომერციულ სერვისებს აფრთხილებს, რომ წვდომა შეიძლება შეწყდეს. რეალური პროდუქტისთვის გამოიყენეთ კომერციული ან საკუთარი ჰოსტირებული tile წყარო, რომელიც Leaflet-თან მუშაობს.

API გასაღებები: საჯარო, მაგრამ შეზღუდული

ბრაუზერში გამოყენებული რუკის გასაღებები ყველასთვის ხილულია, ვინც თქვენს გვერდს გახსნის. ეს მოსალოდნელია, მაგრამ ნიშნავს, რომ ვიღაცამ შეიძლება გასაღები დააკოპიროს და თქვენს ხარჯზე გამოიყენოს. Google-ის უსაფრთხოების რეკომენდაციაა დაამატოთ ვებსაიტის (HTTP referrer) შეზღუდვები, რომლებიც ჩამოთვლის თქვენს დომენებს, და API შეზღუდვები, რომ გასაღები მხოლოდ იმ API-ებზე მუშაობდეს, რომლებსაც იყენებთ.

სერვერის მხარის სერვისების გასაღებები — მაგალითად, ათასობით მისამართის გეოკოდირება — უნდა იყოს ცალკე გასაღებები, სერვერის საიდუმლოებში შენახული და არა გვერდზე. ასევე დააყენეთ ბიუჯეტის შეტყობინებები ან კვოტები პროვაიდერის კონსოლში, რომ შეცდომამ დიდ ანგარიშამდე არ მიგვიყვანოს.

გეოკოდირება: მისამართების კოორდინატებად გადაქცევა ერთხელ

რუკები მისამართებს კი არა, განედსა და გრძედს ხატავს. მისამართის კოორდინატებად გადაქცევას გეოკოდირება ჰქვია, და ბევრი პროვაიდერი თითო მოთხოვნაზე იხდის. ეფექტური ნიმუში:

1. როცა ნიშული შეინახება, სერვერზე გეოკოდირეთ მისი მისამართი.
2. შეინახეთ განედი და გრძედი მონაცემთა ბაზაში.
3. რუკა კითხულობს შენახულ კოორდინატებს და არასდროს გეოკოდირებს გვერდის ნახვისას.

შეამოწმეთ, თითოეული პროვაიდერის პირობები იმის შესახებ, რამდენ ხანს შეგიძლიათ გეოკოდირების შედეგების შენახვა; ისინი განსხვავდება.

მაგალითი მოთხოვნები

ერთი ჩაშენებული რუკა:

საკონტაქტო გვერდზე დაამატე ჩაშენებული Google რუკა, რომელიც გვაჩვენებს ჩვენს მისამართს (12 High Street, Leeds) Maps Embed API-ით, გასაღებით GOOGLE_MAPS_EMBED_KEY-დან. ქვემოთ დაამატე ბმული „მიიღე მიმართულებები“. ტელეფონებზე სრული სიგანე იყოს და ჩატვირთვა lazy იყოს.

ინტერაქტიული რუკა ნიშულებით:

დაამატე latitude და longitude listings ცხრილს. როცა ნიშული იქმნება ან მისამართი იცვლება, სერვერზე გეოკოდირე იგი GEOCODING_API_KEY-ის გასაღებით და შეინახე კოორდინატები. Browse გვერდზე აჩვენე რუკა ნიშულით თითო განცხადებაზე Leaflet-ით, მარკერების გადაფარვისას დაჯგუფებით. მარკერზე დაწკაპუნებისას აჩვენე სათაური, ფასი და ბმული. რუკასა და სიას ერთი და იგივე ფილტრები უნდა ჰქონდეს.

„ახლოს ჩემთან“:

დაამატე ღილაკი „ახლოს ჩემთან“, რომელიც ვიზიტორისგან მდებარეობას ითხოვს და აჩვენებს 10 კმ-ში მდებარე განცხადებებს მანძილის მიხედვით დალაგებულს. თუ მდებარეობაზე წვდომაზე უარს იტყვიან, მიეცით საშუალება, ჩაწერონ ქალაქი.

ნაბიჯ-ნაბიჯ

1. აირჩიეთ რუკის ტიპი ზემოთ მოცემული ცხრილიდან.
2. შექმენით პროვაიდერის ანგარიში და პროექტი და ჩართეთ მხოლოდ საჭირო API-ები.
3. შექმენით გასაღებები: ბრაუზერის გასაღები, შეზღუდული თქვენს დომენებზე (მათ შორის გადახედვის დომენზე აშენებისას), და საჭიროების შემთხვევაში სერვერის გასაღები გეოკოდირებისთვის.
4. შეინახეთ გასაღებები საიდუმლოებად და სთხოვეთ თქვენს შემქმნელს გამოიყენოს; ბრაუზერის გასაღები მაინც შეზღუდული რჩება, მიუხედავად იმისა, რომ გვერდში ხვდება.
5. შეინახეთ კოორდინატები ყოველი ადგილისთვის მონაცემთა ბაზაში.
6. ააგეთ რუკა: მარკერები, ამომხტარი ფანჯრები, დაჯგუფება და გონივრული საწყისი მასშტაბი.
7. დააწყვილეთ სიასთან. მხოლოდ რუკა ტელეფონზე და ეკრანის მკითხველებისთვის მძიმეა. აჩვენეთ იგივე შედეგები სიის სახით.
8. დააყენეთ ბიუჯეტის შეტყობინება პროვაიდერის კონსოლში.
9. გამოაქვეყნეთ და შეამოწმეთ ცოცხალ დომენზე, რადგან referrer-ის შეზღუდვები ხშირად რუკას ბლოკავს, სანამ ცოცხალი დომენი არ დაემატება.

ხშირი შეცდომები

• შეუზღუდავი გასაღებები. ნებისმიერს შეუძლია გამოიყენოს ისინი საკუთარ საიტზე.
• გეოკოდირება ყოველ გვერდის ნახვაზე. ნელი და ძვირი; გეოკოდირება ერთხელ შენახვისას.
• ცოცხალი დომენის დავიწყება გასაღების შეზღუდვებში. გადახედვაში მუშაობს, წარმოებაში — ცარიელი ნაცრისფერი ყუთი.
• მხოლოდ რუკის განლაგებები. მარკერები სიის გარეშე მტკივნეულია პატარა ეკრანებზე და მიუწვდომელია.
• ასობით მარკერი დაჯგუფების გარეშე. არაწაკითხადი და ნელი.
• ატრიბუციის დაკარგვა. უმეტესი რუკისა და tile პროვაიდერი მას მოითხოვს, და მისი დამალვა მათ პირობებს არღვევს.
• ადგილმდებარეობის თხოვნა გვერდის ჩატვირთვისას. ჰკითხეთ მხოლოდ მაშინ, როცა მომხმარებელი „ახლოს ჩემთან“-ს დააჭერს.

ჩამონათვალი

• სწორი რუკის ტიპი არჩეულია დავალებისთვის
• ბრაუზერის გასაღები შეზღუდულია თქვენს დომენებზე და საჭირო API-ებზე
• სერვერის მხარის გასაღებები საიდუმლოებში ინახება
• კოორდინატები მონაცემთა ბაზაშია, გეოკოდირებულია ერთხელ
• შედეგები ასევე სიის სახით ჩანს
• დაჯგუფება ბევრი მარკერისთვის
• ატრიბუცია ხილულია
• ბიუჯეტის შეტყობინება დაყენებულია პროვაიდერთან
• შემოწმებულია გამოქვეყნებულ დომენზე და ტელეფონზე

რუკების დამატება Mythex-ით

Mythex-ს ჩაშენებული რუკების ინტეგრაცია არ აქვს; თქვენ მოგაქვთ საკუთარი პროვაიდერის გასაღები, ამატებთ მას როგორც პროექტის საიდუმლოს (ან აწვდით, როცა აგენტი საიდუმლოების ბარათს აჩვენებს) და ჩატში ითხოვთ რუკას, როგორც აღწერილია Integrate any API-ში. კოორდინატები პროექტის მონაცემთა ბაზაში მიდის. არ დაგავიწყდეთ გასაღების ვებსაიტის შეზღუდვებში დაამატოთ როგორც გადახედვის, ისე გამოქვეყნებული დომენები და საიდუმლოების შეცვლის შემდეგ ხელახლა გამოაქვეყნოთ.

რუკები ჩვეულებრივ ძიებასა და სიებთან ერთად გამოიყენება: იხილეთ როგორ დავამატოთ ძიება თქვენს აპში, როგორ ავაშენოთ დირექტორიის ვებსაიტი და როგორ ავაშენოთ პატარა ბიზნესის ვებსაიტი.

კითხვები