WooCommerce PickPoint - dostava preko paketomata i mjesta preuzimanja. Ponuđena usluga je besplatna

Ovaj dodatak vam omogućuje integraciju usluge dostave putem paket terminala u vašu internetsku trgovinu. PickPoint. Koristeći ovu uslugu, kupci će moći odabrati terminal (Postamat) ili mjesto preuzimanja koji su im najbliži i preuzeti svoju narudžbu u bilo kojem trenutku. PickPoint ne kombinira samo dostavu, već i plaćanje. U isto vrijeme, kupac ne mora stajati u zamornim redovima ili čekati kurira kod kuće ili na poslu.

Dodatak omogućuje kupcu da odabere najbliži paketomat na karti bez napuštanja vaše trgovine. Odabrani paketni ormarić (njegov ID i točna adresa) bilježi se u narudžbi i također se odražava u obavijestima putem e-pošte za administratora i kupca.

Ovaj dodatak ne izračunava tarife i vrijeme isporuke., tako da sami navedete fiksnu cijenu ili uopće ne navedete cijenu PickPoint dostave ako cijena nije fiksna. U tom slučaju po dogovoru, prema PickPoint tarifi za odabrani grad. Dodatak kupcima daje samo mogućnost da odaberu najbliži paketomat i zabilježe adresu paketomata u narudžbi. Također zahtijevaju od kupaca da upišu broj mobitela na koji će dobiti SMS obavijest s pin kodom za primanje narudžbe.

Ovaj dodatak ne podržava pun rad API-ja s podrškom za automatski izračun tarifa. Ovo je samo pojednostavljena verzija dodatka.

Značajke dodatka:
— Mogućnost da kupac odabere paketomat u skočnom prozoru (pomoću popisa ili karte).
— Automatsko ažuriranje PickPoint gradova i adresa za dostavu.

PickPoint je prva ruska tvrtka koja nudi jedinstvenu alternativu poštom i kurirskoj dostavi. Vaši kupci mogu preuzeti svoju robu na posebnim terminalima za preuzimanje narudžbi koji su instalirani u područjima s velikim prometom.

Tvrtka PickPoint pruža puni ciklus isporuke i izdavanja narudžbi. Mreža automatskih terminala (postamata) i mjesta za preuzimanje narudžbi nalaze se u područjima s velikim prometom: trgovački i poslovni centri, veliki trgovački lanci. Terminali izdaju robu naručenu u online trgovinama i iz kataloga. U sljedeće dvije godine PickPoint mreža paketomata će pokriti sve veće gradove Rusije.

Postamat– automatizirano mjesto za preuzimanje narudžbi na koje se dostavljaju narudžbe iz internetske trgovine. Riječ je o sigurnom terminalu s ugrađenim ćelijama s kojeg kupac može preuzeti robu naručenu u internetskoj trgovini. Slijedeći upute na terminalu, kupac može samostalno iu vrijeme koje mu odgovara preuzeti svoju kupnju, plaćajući je izravno u pošti. Paketomani rade do 22 sata, a neki rade 24 sata dnevno, sedam dana u tjednu.

Točka izdavanja (POP)– klasično mjesto preuzimanja narudžbi, kada Vam djelatnik PickPointa predaje naručenu robu.

Kako funkcionira PickPoint mreža

Kako radi:
Svoju narudžbu možete platiti i preuzeti na jednom mjestu iu vrijeme pogodno za kupca. Prilikom narudžbe servis Vas obavještava o predviđenom vremenu dostave do navedenog paketomata ili mjesta preuzimanja. Čim se izvrši dostava u paketni ormarić, kupac će dobiti SMS poruku s jedinstvenim kodom za primanje narudžbe. Nakon toga jednostavno ode do odabranog paketomata i unese kod, nakon čega će se otvoriti željena ćelija i možete preuzeti narudžbu. Ako je roba plaćena unaprijed, kupac ne plaća ništa po primitku.

1. Naručite dostavu na pretinac za pakete ili mjesto za preuzimanje.
Kupac na vašoj web stranici odabire način dostave PickPoint (pretinac za pakete ili mjesto preuzimanja). Zatim u skočnom prozoru odabire adresu prikladnog paketomata ili mjesta preuzimanja na karti ili na popisu terminala.

2. Primitak robe u poštanskom uredu ili dostavnom mjestu.
Čim se narudžba preda u paketomat, kupac će dobiti SMS poruku i e-mail s jedinstvenim kodom paketa za preuzimanje naručene robe na paketomatu ili na mjestu preuzimanja. Da biste primili svoju narudžbu, morat ćete unijeti kod za ovu online narudžbu u izborniku terminala. Nakon unosa koda otvorit će se vrata ormarića za pakete. Rok trajanja paketa u terminalu i na mjestu preuzimanja nije duži od 3-5 dana (provjerite za svoju zemlju).

3. Plaćanje naručene robe
Ako je potrebno, kupac također može platiti naručenu robu izravno na terminalu u gotovini ili plastičnom karticom. Prilikom plaćanja narudžbe putem terminala, kupac također plaća PickPoint proviziju od 2,36%. Narudžbu možete platiti gotovinom ili kreditnom karticom. Terminal prihvaća plaćanje bankovne kartice Visa, MasterCard ili Maestro. Prilikom plaćanja u gotovini, imat ćete nekoliko opcija za uplatu kusura: na račun mobilnog telefona (eventualno u Yandex novčanik) ili primite kusura na blagajni PickPoint (Moskva, Volgogradski prospekt, 42, zgrada 23). Na mjestu izdavanja plaćanje se vrši samo u gotovini.

Tarife i rokovi isporuke "PICKPOINT"
Cijena i vrijeme dostave usluge PICKPOINT ovise o dimenzijama pošiljke i odredištu pošiljke. Geografija PickPoint dostave podijeljena je na gradove MOSKVA/SANKT PETERBURG i sve ostale gradove, koji su podijeljeni u 6 zona. U Moskvi i Sankt Peterburgu vrijeme isporuke je 1-2 dana, u druge gradove od 1 do 6 (na primjer, u zoni 6 - regija Magadan)
Vrijeme isporuke za robu - http://pickpoint.ru/services/?expand=4#p1

ODGOVORI NA PITANJA:
Odakle cijena dostave do peakpointa kada klijent još nije odabrao paketni ormarić na karti?
Cijena dostave preuzeta je iz postavki dodatka (polje „Naknada dostave”).
Opis dodatka govori o tome nekoliko puta:
“Ovaj dodatak ne izračunava cijenu i vrijeme isporuke, tako da sami određujete fiksnu cijenu ili uopće ne navodite cijenu dostave PickPointa ako se cijena ne može odrediti. U tom slučaju po dogovoru, prema PickPoint tarifi za odabrani grad. Dodatak kupcima daje samo mogućnost da odaberu najbliži paketomat i zabilježe adresu paketomata u narudžbi. Također zahtijevaju od kupaca da upišu broj mobitela na koji će dobiti SMS obavijest s pin kodom za primanje narudžbe.

Ovaj dodatak ne podržava pun rad API-ja s podrškom za automatski izračun tarifa. Ovo je samo pojednostavljena verzija dodatka."

Cijena dodatka: 10 USD.
Uključeno u cijenu: Woocommerce dodatak. PickPoint dostava.

Preuzmite Woocommerce PickPoint dodatak možete odmah nakon uplate.

Datum objave:

Datum ažuriranja:

Prilagodljivost:

Kompozitna podrška:

Broj instalacija:

Kompatibilna izdanja

Opis

Integracija s PickPointom je profesionalan i praktičan modul za integraciju s uslugom dostave PickPoint za online trgovine na platformi 1C-Bitrix.

Glavne prednosti rješenja:

• Učitavanje narudžbi u PickPoint, nakon čega slijedi spremanje broja pošiljke u narudžbu i slanje pisama kupcima s tekstom broja za praćenje i poveznicom na web stranicu tvrtke, gdje mogu pratiti svoju narudžbu koristeći ovaj broj;
• Izračun troškova dostave narudžbe iz bilo kojeg grada.
• Provjera dostupnosti odabranog načina plaćanja. Odnosno, ako je klijent odabrao dostavu na mjesto preuzimanja, sustav će provjeriti dostupnost odabranog načina plaćanja na odabranom mjestu preuzimanja.
• Mogućnost postavljanja marža na troškove isporuke;
• Mogućnost postavljanja fiksnog troška dostave;
• Svi zahtjevi za PickPoint API pohranjuju se u predmemoriju kako bi se ubrzali izračuni troškova dostave;
• Prozor za odabir za odabir točaka preuzimanja - izvorni widget koji nudi PickPoint, informacije o dostupnosti točaka preuzimanja uvijek su ažurne;
• Mogućnost uređivanja narudžbe na administrativnoj ploči odabirom drugog mjesta preuzimanja
• Rješenje može raditi s testnim pristupom PickPointu radi testiranja integracije;
• Radi na izdanjima "1C-Bitrix: Upravljanje web-mjestom: mala poduzeća ili poduzeća" od verzije 16 i novije;
• Biblioteka cUrl nije potrebna na vašem hostingu, moguće je slati sve zahtjeve koristeći HttpClient - ugrađenu BUS klasu.

Osnoveprednost PickPoint kurirske službe -razgranatu mrežu terminala za pakete i mjesta preuzimanja diljem Rusije

Možeš dobiti11% popusta na tarifeza sveobuhvatno pozicioniranje PickPointa i postavljanje materijala za vaše kupce. Dobijte više informacija

Naši stručnjaci rado će vam savjetovati i pružiti pomoć u instalaciji i konfiguraciji rješenja (pojedinosti u odjeljku "Podrška"), kao i pružiti usluge za finalizaciju rješenja prema vašim potrebama!

Nakon aktivacije kupona, instalacija se odvija automatski.

Nakon instaliranja modula potrebno je konfigurirati postavke modula (Administracija - Postavke - Postavke proizvoda - Postavke modula - Pickpoint Delivery Service): Site_name/bitrix/admin/settings.php?lang=ru&mid=webfly.pickpoint

Morate konfigurirati modul:

1. Unesite korisničko ime, lozinku i IKN, koje vam je Pickpoint dao zajedno s pristupom vašem osobnom računu.
2. Odaberite metodu za slanje zahtjeva Pickpoint API-ju: cURL ili BUS znači. Prema zadanim postavkama, svi će se zahtjevi slati putem HttpClient - ugrađene BUS klase;
3. Provjerite ostale postavke;
4. Dodati nova usluga dostava Tip mjesta preuzimanja (Administracija - Trgovina - Postavke - Dostavne službe).
5. Konfigurirajte kreiranu uslugu dostave

Nakon postavljanja modula kreira se točka za upravljanje/moderiranje naloga u administrativnom odjeljku „Servis“.

Pažnja!
Modul se instalira samo na softver 1C-Bitrix s aktivnom mogućnošću primanja ažuriranja i tehničke podrške.

Pročitajte pravila podrške!

Način rada: 12:00 - 18:00 po moskovskom vremenu.
Vrijeme odgovora na zahtjeve je do 3 radna dana (nastojimo odgovoriti brzo, po načelu tko prvi dođe, prvi uslužen).
Vikendi: subota, nedjelja, praznici.

Ako imate problem ili grešku, odmah pošaljite pristup projektu koji će sustav tražiti od vas prilikom kreiranja zahtjeva.
____________________________________________________________

Prije kreiranja zahtjeva pročitajte upute za ovo rješenje koje smo pokušali i napisali posebno za vas

Plaćanje:

• Konzultacije - besplatno,
• pitanja - besplatno,
• Ispravak pogreške - besplatno,
• Radi na stranici - po stopi "Jednokratno". http://webfly24.ru/tariffs/

Nastojimo ne preuzimati poboljšanja na stranicama, budući da su naši resursi usmjereni isključivo na naše module (u ovom slučaju), ali kada se pojave iznimke, tražimo plaćanje prema standardnim satima koji će biti utrošeni na rješavanje vašeg problema ("Jednokratno" " tarifa http:/ /webfly24.ru/tariffs/)

Ova cijena vrijedi i za ugradnju modula, ako smo uredili kod stranice. Odnosno, konzultacije i savjeti - besplatno.

Zahtjev tehničkoj podršci možete podnijeti putem sustava tiketa.

ugodan dan!

Instaliranje widgeta karte PickPoint

Nudimo modul "odaberite adresu za dostavu narudžbe" koji se može jednostavno integrirati u vaše web stranice ili aplikacije.

Widget je praktičan alat za pronalaženje najbližeg mjesta gdje vaši kupci mogu preuzeti svoje narudžbe.

1. Ponuđena usluga je besplatna.

KRATKI OPIS
Dodatni "gumb" instaliran je na vašoj web stranici ili aplikaciji na mjestu koje vam je potrebno, na primjer "Dostava u PickPoint ormariće paketa",

kada je odabrano, vaš korisnik se odvodi na posebno dizajnirano sučelje za odabir mjesta isporuke koje mu odgovara. Izbor se može izvršiti pomoću karte grada, karte metroa (za one gradove za koje je to relevantno) ili popisa. Primjer postavljanja možete vidjeti na poveznici: https:// pickpoint. ru/ test/

Informacije o odabranom mjestu preuzimanja ili Postamatu vraćaju se u obliku niza s ključevima "id", "address" i "name", gdje je id ID paketomata, adresa je njegova adresa zajedno s gradom, naziv je naziv točke. Ove informacije moraju biti pohranjene u vašoj bazi podataka.

TEHNIČKI OPIS ZA UGRADNJU

1. 
   Na stranicama na koje trebate povezati naš widget (slično prikazanom u https:// pickpoint. ru/ test/ ) nakon oznake morate spojiti sljedeću skriptu:

Bilješka: kako biste izbjegli poruke upozorenja o nesigurnom sadržaju u nekim preglednicima. Kodiranje skripte je UTF-8, tako da morate navesti atribut charset="utf-8" ako vaša stranica koristi drugačije kodiranje.

Ne preporučuje se učitajte postamat.js skriptu koristeći ajax ili drugu metodu različitu od gore navedene.
Zabranjeno je kopiranje postamat.js i drugih skripti na Vašu web stranicu.Kopiranje datoteka onemogućit će vam korištenje Trenutna verzija widget.

1. 
   Zatim na pravo mjesto na web stranici trgovine trebate staviti vezu:
   a href="#" na klik=" PickPoint. otvoren(moj_ funkcija); povratak lažno">Odaberite paketni terminala> ,
   nakon događaja “onclick” treba pozvati funkciju “PickPoint.open” iz prethodno povezane datoteke. Ovoj funkciji se mora proslijediti parametar, tzv. “callback funkcija”, koja će s odabranim paketomatom primiti niz podataka.
   

1. 
   "My_function" - javascript - funkcija dostupna na stranici za naplatu. Slijedi otvaranje novog prozora, odabir paketomata itd. “my_function” je naziv “callback funkcije”; njen naziv može biti bilo koji, glavna stvar je da se proslijedi kao parametar u “PickPoint.open”. Ovo je funkcija java-skripte koja mora biti uključena na stranicu za naplatu.

1. 
   Kada kliknete gumb "odaberi" na web mjestu, poziva se funkcija my_function, gdje se objekt s ključevima "id" i "address" prosljeđuje kao parametar.

Format podataka u vraćenom objektu je niz.

Rezultat se generira ovako (java-script kod):
var proizlaziti= {

"id" : "broj točke",

"adresa" : "poštanski broj, regija, grad, ulica, kućni broj ",

"shortaddress" : "Ulica, kuća #",

"name" : "Naziv terminala za pakete",

"cityname" : "Grad",

"postcode" : "poštanski broj",

"region" : "Regija",

"country" : "Država",

"dužina" : zemljopisna dužina,

"latitude" : zemljopisna širina,

"maxsize" : "maksimalna veličina",

"maksimalna težina": " Ograničenje težine",

"house" : "Br. kuća"

}
Primjer vraćenih podataka:
{

"id": "7701-070",

"adresa" : "129223, Moskovska regija, Moskva, Mira prosp., 92, zgrada 1 ",

"shortaddress" : "Mira prosp., 92, zgrada 1",

"name" : "Poštanski terminal: Robna kuća Krestovsky 7701-070",

"ime grada" : "Moskva",

"poštanski broj": "129223",

"region" : "Moskovska regija.",

"država" : "Rusija",

"dužina" : 37.635604,

"geografska širina" : 55.793254,

"maxsize": "60x60x60",

"maxweight" : "15 kg",

"kuća" : "92, zgrada 1"

}

Bilješka: Na stranicihttp s http://pickpoint.ru/test/ pokazuje primjer kako dizajnirati poveznicu za pozivanje widgeta tijekom narudžbe i kako postaviti ID paketomata ili mjesta preuzimanja u skrivenom polju za daljnju obradu na strani poslužitelja i kako korisniku pokazati adresu paketomata (preporuka je uvijek prikazati ovu informaciju kako bi korisnik mogao vidjeti adresu odabrane točke i shvatiti da je njegov odabir uspješno evidentiran).

1. 
   Primljeni podaci spremaju se zajedno s ostalim podacima o narudžbi i naknadno se koriste prilikom obrade pošiljki u Vašoj osobni račun e-rješenje.

Kontakti:

[e-mail zaštićen]

Ovaj odjeljak namijenjen je programerima aplikacija i poslužitelja koji koriste platformu za geokodiranje PickPoint. Prije nego što počnete raditi s API-jem morate kreirati račun. Kako biste se brzo upoznali s našom uslugom, pogledajte odjeljak Prvi koraci.

Sve što trebate za početak eksperimentiranja je bilo koji uslužni program za slanje HTTP-zahtjeva ili čak možete koristiti adresnu traku svog web preglednika. Također možete koristiti , koji je dostupan na nadzornoj ploči vašeg računa.

Ovjera

Dok smo razvijali PickPoint, dali smo sve od sebe kako bismo smanjili napor potreban za njegovu integraciju s vašim proizvodima. Namjerno smo odlučili ne koristiti osnovnu autentifikaciju, autentifikaciju tokena nositelja i druge, u korist korištenja korisničkih ključeva izravno u URL zahtjevima za našu uslugu.

Da biste započeli raditi s našom uslugom, prvo morate kopirati svoj API ključ koji je dostupan u vašem odjeljku:

Sada možete uputiti svoj prvi zahtjev za PickPoint API. Da biste to učinili, izradite URL u sljedećem formatu:

https://api.site/v1/? ključ=VAŠ-API-KLJUČ

Otvorite rezultirajući URL u adresnoj traci vašeg preglednika. Vidjet ćete poruku "Dobro došli u PickPoint API". To znači da ste uspješno autorizirani i spojeni na naš API. U protivnom ćete vidjeti poruku "Neautorizirano".

Za korištenje PickPoint API funkcija morate dodati svoj API ključ svim svojim upitima:

Ključ=VAŠ-API-KLJUČ

Molim Zabilježite, da su sve funkcije PickPointa dostupne samo pomoću pristupnog ključa.

Naprijed geokodiranje

Forward Geocoding je funkcija za pretvaranje geografskih adresa u koordinate u formatu Latitude - Longitude. Na primjer, ako navedete adresu kao što je "221b Baker St, London NW1 6XE", dobili biste njezine koordinate - "51.524259, -0.1584738", i prikazali biste je na karti.

Korištenje geokodiranja prema naprijed rezultirat će popisom geografskih objekata iz OSM baze podataka, poredanih po važnosti. To znači da će opcije za koje se smatra da točnije odgovaraju očekivanim rezultatima biti na vrhu popisa.

Ulazna točka

Funkcije geokodiranja unaprijed se izvršavaju pomoću sljedećih upita:

PREUZMI https://api.site/v1/forward

Upit

Glavni parametar funkcije geokodiranja je upit za pretraživanje koji se šalje s ključem q. Obično je geografska adresa objekta upit za pretraživanje, na primjer:

221b Baker St, London NW1 6XE

Bilješka, da redak upita treba pretvoriti u URL-kodirani format.

The q parametar je također dovoljan za izradu jednostavnog upita:

q=21b%20Baker%20St,%20London%20NW1%206XE

Ako želite suziti svoj upit prema vrsti traženog elementa, na primjer pretraživati ​​samo gradove ili zemlje, trebate koristiti sljedeće parametre:

• zemlja- pretraživanje po zemlji
• država- pretraživanje po državama
• okrug- pretraživanje po okruzima / pokrajinama
• Grad- pretraživanje po imenima gradova
• ulica- pretraživanje po imenima ulica. Treba navesti u sljedećem formatu
• Poštanski broj- ograničiti rezultate na određeni poštanski broj

Imajte na umu da ovi parametri nisu primjenjivi na q parametar.

Razmotrimo pretragu gradova s ​​imenom St. Petersburg:

GET /forward/?key=YOUR-API-KEY& grad=Sankt Peterburg

Granice

Iz raznih razloga možda ćete htjeti ograničiti svoje rezultate pretraživanja. Ispod ćete vidjeti nekoliko korisnih parametara koje možete koristiti za to.

The kodovi država parametar se koristi za ograničavanje područja pretraživanja prema zemlji ili popisu zemalja. Vrijednost parametra ovdje bi trebala biti dvoslovna šifra zemlje (ili šifre država) u formatu ISO 3166 alpha-2. Evo primjera:

• Poljska - pl
• Novi Zeland - nz
• Kina-cn

Možda znate da se London kao zemljopisni naziv odnosi ne samo na glavni grad Ujedinjenog Kraljevstva, već i na nekoliko gradova u SAD-u. Kako biste isključili rezultate izvan UK-a, trebate formulirati svoj upit kao:

kodovi država=gb

Potpuni popis kodova zemalja u ISO 3166 alpha-2 formatu može se pronaći.

Postoji veliki broj različitih geo-objekata s istim imenom. No, ako geometrijski ograničite svoje područje pretraživanja, formiranjem pravokutnog područja na koordinatnoj mreži, vjerojatno ćete dobiti bolje rezultate. Ovdje je okvir za prikaz parametar dolazi u obzir. Na primjer, želite pronaći koordinate za objekte koji u nazivu imaju riječ "park". Točnije, vaša pretraga je za takvim objektima samo u Londonu. Koristeći rezultate prethodnog upita, navedite:

GET /forward/?key=VAŠ-API-KEY&q=park& viewbox=0.0,52.0,1.0,53.0&bounded=1

Imajte na umu da osim okvir za prikaz upit uključuje omeđen parametar. Korištenje ovog parametra jamči samo rezultate iz navedenog područja ( okvir za prikaz) će se prikazati.

Kako biste isključili rezultate za koje znate da su nevažni, upotrijebite exclude_place_ids parametar s OSM (place_id) identifikatorima za neželjene geografske objekte. Na primjer, želite pronaći sve objekte pod nazivom "London", isključujući glavni grad Ujedinjenog Kraljevstva. Koristeći place_id koji smo primili kao rezultat za jedan od naših prethodnih upita, imamo:

GET /forward/?key=VAŠ-API-KEY&q=London& exclude_place_ids=158415464

Da biste ograničili broj rezultirajućih opcija, koristite ograničiti parametar:

GET /forward/?key=VAŠ-API-KEY&q=London& granica=1

Obrnuto geokodiranje

Obrnuto geokodiranje je funkcija koja pretvara koordinate u formatu Latitude – Longitude u geografske adrese. Na primjer, unosom koordinata "51.524259, -0.1584738" dobit ćete geografsku adresu za ovu točku:

Ulazna točka

Funkcije obrnutog geokodiranja dostupne su na sljedećoj adresi:

https://api.site/v1/reverse

Upit

Kako biste izvršili jednostavnu funkciju obrnutog geokodiranja, morate koristiti dva parametra: lat– zemljopisna širina, i dužina- zemljopisna dužina. Ove parametre treba navesti u stupnjevima. Primjer:

GET /obrnuto/?key=VAŠ-API-KLJUČ& lat=48.85881005&lon=2.32003101155031

Rezultati funkcije obrnutog geokodiranja mogu se skalirati promjenom zum parametar od 0 (najširi parametar – zemlje) do 18 (najuži parametar – zgrade). Primjer:

GET /reverse/?key=VAŠ-API-KEY&lat=52.183430&lon=-106.2707519& zumiranje=0

Traženje adrese

Address Lookup je funkcija za pretvaranje OSM identifikatora u geografske adrese s odgovarajućim koordinatama. Na primjer, OSM baza podataka ima način s identifikatorom 3996986 koji se sprema za vas kao rezultat funkcije geokodiranja. Korištenjem traženja možete dobiti geografsku adresu: "Baker Street, Marylebone, Westminster, London, Greater London, England, NW1 6XE".

Ulazna točka

Ovo je ulazna točka za funkciju traženja adrese:

https://api.site/v1/lookup

Upit

Ulaz ove funkcije je osm_ids parametar. Treba navesti objekte (od jedan do 50), odvojene zarezima. Za svaki objekt morate navesti kojem tipu OSM-a pripada, a pored treba stajati identifikator objekta. Postoje tri glavne vrste OSM objekata:

• R - odnos
• W-put
• N-čvor

Evo primjera za svaku vrstu objekta:

GET /lookup/?key=VAŠ-API-KLJUČ& osm_ids=W481027013,N1809771508,R568660

Format odgovora

Naša platforma za geokodiranje podržava dva najčešća formata odgovora: JSON i XML. Možete ih promijeniti uključivanjem željenog formata (json ili xml) u format parametar upita, na primjer:

GET /forward/?key=VAŠ-API-KEY&q=Tokyo& format=json

Lokalizacija

Koristiti prihvatiti-jezik parametrom možete odrediti željeni jezik rezultata geokodiranja. Vrijednost ovog parametra mora biti navedena u formatu ab-XY, gdje je:

• "ab" je dvoslovni jezični kod u formatu ISO 639-1. Na primjer, "en" je engleski, "fr" je francuski, "ru" je ruski. Za pregled cjelovitog popisa svih kodova jezika kliknite .
• "XY" je dvoslovni kod zemlje u formatu ISO-3166. Na primjer, "ES" je Španjolska, "DE" je Njemačka, "CN" je Kina. Da biste vidjeli cijeli popis kodova zemalja, kliknite .

GET /forward/?key=VAŠ-API-KEY&q=London& accept-language=de-DE

Prošireni odgovor

Svaka vrsta upita za geokodiranje može vratiti adrese u strukturiranom formatu. Za ovo biste trebali koristiti detalji adrese=1 parametar. Kao rezultat toga, u tijelu odgovora bit će novi atribut "addressparts" (za upite traženja adrese detaljna adresa je dio tijela odgovora) koji detaljno opisuje svaki dio pronađene adrese.

Primjer upita s detaljnom adresom:

GET /reverse/?key=VAŠ-API-KEY&lat=48.8698899&lon=2.3084521&zoom=18& detalji adrese=1

Ako trebate vidjeti popis imena geo-objekata na drugim jezicima ili pronaći moguća alternativna imena, koristite imenovani detalji=1 parametar. Odgovor će imati novi atribut "namedetails" s popisom svih mogućih imena, kao u sljedećem primjeru:

GET /lookup/?key=VAŠ-API-KLJUČ&osm_ids=R2360164& imenovani detalji=1

Izlazna geometrija

U nekim slučajevima možda ćete trebati znati granice geo-objekata, na primjer, da biste ih prikazali na karti ili ih vizualizirali na bilo koji drugi način. Trenutačno je ova opcija dostupna samo za upite geokodiranja naprijed i nazad. Ove koordinate možete dobiti u četiri različita formata:

• GeoJSON - prilikom postavljanja poligon_geojson parametara na 1, rezultat će doći u geojson atribut retka odgovora.
• KML-pošalji poligon_kml=1, za primanje koordinata kao vrijednosti atributa geokml.
• SVG - podaci u ovom formatu trebaju se tražiti pomoću poligon_svg=1 parametar. Rezultat će se pojaviti u atributu geosvg.
• Tekst - za primanje koordinata kao teksta, koristite poligon_tekst=1 parametar. Rezultat će biti u atributu geoteksta.

Evo primjera za dobivanje granica Londona:

GET /reverse/?key=VAŠ-API-KEY&lat=51.5073219&lon=-0.1276473&zoom=10& poligon_geojson=1