Współrzędne z adresu i adres ze współrzędnych

Dane z państwowego rejestru adresowego (punkty adresowe PRG, GUGiK), a nie z płatnego geokodera. Dla polskich adresów to najdokładniejsze źródło, bo z tego rejestru adresy pochodzą. Samo zapytanie do rejestru potrafi jednak zmylić, więc API robi za Ciebie resztę:

Dostawy, przedstawiciele, serwis w terenie, mapy i CRM

  • pisownia miejscowości: „Krakow” bez polskich znaków rejestr pomija całkowicie, API odtwarza „Kraków” (po kodzie pocztowym, gdy nazwa jest niejednoznaczna),
  • numer z dopiskiem: „94/98 lok. 2” albo „42lok.U2” rejestr odrzuca, API upraszcza numer krok po kroku,
  • kontrola ulicy: na nieznaną ulicę rejestr odpowiada najbliższą podobną („Polwiejska 2” → Podmiejska 2); API porównuje nazwy i takiej odpowiedzi nie przyjmuje,
  • poziom trafienia: adres, ulica albo miejscowość, zawsze podany w odpowiedzi razem z uwagami,
  • właściwa miejscowość z wielu: Psary są w Polsce 21 razy; wybiera kod pocztowy albo jego gmina, a bez kodu miasto na prawach powiatu.

Start

49 złnetto miesięcznie

do 1 000 adresów dziennie

Aplikacja firmy, CRM, trasy przedstawicieli.

Więcej

149 złnetto miesięcznie

do 10 000 adresów dziennie

Większe bazy klientów i punktów, logistyka.

Adres ze współrzędnych liczy się tak samo jak współrzędne z adresu: jedna pozycja = jeden adres z limitu. Jednorazowe uzupełnienie współrzędnych w całym pliku klientów zrobię też w ramach porządku w danych.

Współrzędne z adresu

POST /api/v1/wspolrzedne
curl https://odswiezona.pl/api/v1/wspolrzedne \  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \  -H "Content-Type: application/json" \  -d '{"adresy": ["ul. Marszałkowska 94/98 lok. 2, 00-510 Warszawa",               {"miejscowosc": "Krakow", "ulica": "Dluga", "numer": "1"}]}'

200 OK, odpowiedź skrócona

{  "ok": true,  "wyniki": [    { "ok": true, "lat": 52.2292521, "lon": 21.0126736, "poziom": "adres",      "potwierdzone": true, "potwierdzone_przez": "kod_pocztowy",      "adres": { "miejscowosc": "Warszawa", "ulica": "ulica Marszałkowska", "numer": "94/98", "kod": "00-510",                 "wojewodztwo": "mazowieckie", "powiat": "Warszawa", "gmina": "Warszawa",                 "teryt": "146501", "simc": "0918123", "ulic": "12400" },      "zapytanie": "Warszawa, Marszałkowska 94/98", "uwagi": [] },    { "ok": true, "lat": 50.0666318, "lon": 19.9391034, "poziom": "adres", "potwierdzone": true,      "adres": { "miejscowosc": "Kraków", "ulica": "ulica Długa", "numer": "1", "kod": "31-147", … },      "uwagi": ["Uzupełniono pisownię miejscowości: Krakow → Kraków (…)"] }  ],  "zrodlo": "punkty adresowe PRG (GUGiK); pisownia miejscowości: GeoNames (CC-BY 4.0)",  "limit": { "dzienny": 1000, "wykorzystano": 2 }}

Adres ze współrzędnych

POST /api/v1/adres
curl https://odswiezona.pl/api/v1/adres \  -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \  -H "Content-Type: application/json" \  -d '{"punkty": [{"lat": 52.2297, "lon": 21.0122}], "promien": 100}'

200 OK, odpowiedź skrócona

{ "ok": true, "promien": 100,  "wyniki": [{ "ok": true, "odleglosc_m": 59,    "adres": { "miejscowosc": "Warszawa", "ulica": "ulica Marszałkowska", "numer": "94/98", "kod": "00-510", … } }],  "limit": { "dzienny": 1000, "wykorzystano": 3 } }
CoJak
AdresPOST /api/v1/wspolrzedne: adres albo adresy (do 10 w jednym zapytaniu); pozycja to tekst z przecinkiem („ulica numer, kod miejscowość”) albo obiekt { miejscowosc, ulica, numer, kod }. Kod pocztowy nie jest wymagany, ale pomaga przy powtarzających się nazwach
PunktPOST /api/v1/adres: lat i lon (WGS84) albo punkty (do 10), promien od 1 do 2000 m (domyślnie 100)
Poziomadres (punkt budynku), ulica (środek ulicy, gdy rejestr nie zna numeru), miejscowosc (środek miejscowości); potwierdzone: czy miejscowość wskazał kod pocztowy, jego gmina, jedyne dopasowanie albo miasto na prawach powiatu
Identyfikatoryteryt, simc i ulic z rejestrów TERYT, gdy rejestr je podaje; województwo, powiat i gmina
Klucz i limitynagłówek Authorization: Bearer odsw_…; dzienny limit adresów według planu i 20 zapytań na minutę
Błędy400 złe dane (nie liczą się do limitu), 401 zły klucz, 429 limit; adres nieznany rejestrowi albo chwilowa awaria rejestru to "ok": false w danej pozycji ("ponow": true, gdy warto wysłać ją jeszcze raz)

Dane pochodzą z usługi GUGiK dostępnej publicznie; rejestr może mieć przerwy, na które nie mam wpływu. Adresów i współrzędnych nie zapisuję, liczę tylko liczbę pozycji na klucz. Do rejestru trafia sam adres albo punkt, bez niczego więcej. Jeśli adresy dotyczą osób (np. Twoich klientów), przetwarzam je na Twoje zlecenie na podstawie umowy powierzenia, którą podpisuję razem z umową na API. Pisownię miejscowości odtwarzam ze zbioru GeoNames (geonames.org, licencja CC-BY 4.0).

Klucz testowy na tydzień

Napisz, do czego chcesz używać współrzędnych. Dostaniesz klucz z małym limitem, żeby sprawdzić trafność na własnych adresach.