Opis usługi lokalizacji

Opis usługi lokalizacji
Adres usługi:
http://punktyadresowe.pl/lokalizacja.php
Parametry:
adres – fraza definiująca adres, który ma być odnaleziony. Nieistotna jest wielkość liter i obecność znaków
diakrytycznych. Fraza może zostać wpisana w dowolny sposób, np.: "Halinów Okuniewska 5", "Reda,
Wejherowska 15", "Biała 12". Poszczególne wyrazy można rozdzielać zarówno spacjami jak i przecinkami.
src - identyfikator układu współrzędnych zwracanych w odpowiedzi, zgodny z EPSG
np. 2180 - ukł. 1992 (domyślny), 4326 - WGS84 itd.
Zwracane wartości:
Usługa zwraca plik w formacie JSON kodowany w UTF8.
Analizując wynik przykładowego żądania:
http://punktyadresowe.pl/lokalizacja.php?adres=halinów okuniewska 5
{"wyniki":[
// Wyniki to tablica obiektów, z których każdy zawiera informację o wyszukanej miejscowości,
miejscowości i ulicy lub miejscowości, ulicy i punkcie adresowym. Obiekty są ułożone wg trafności wyszukiwania.
{"trafnosc":1, // Liczba rzeczywista informująca o trafności wyniku, przyjmuje wartości od 0 do 1 (pełna trafność).
"miejscowosc":"Halinów", // Nazwa miejscowości.
"wojewodztwo":"mazowieckie", // Nazwa województwa.
"powiat":"miński", // Nazwa powiatu.
"gmina":"", // Nazwa gminy.
"zakres_miejscowosci":[659707,485798,662143,488148], // Zakres przestrzenny miejscowości w zadanym układzie
współrzędnych. Jest to tablica, której kolejne pola oznaczają: x minimalny, y mininimalny, x maksymalny, y
maksymalny. Obowiązuje układ matematyczny. Parametr jest opcjonalny.
"ulica":"Okuniewska", // Nazwa ulicy. Parametr występuje, gdy ulica zostanie znaleziona.
"zakres_ulicy":[660473.8125,486229.46875,661606.125,487731.1875], // Zakres przestrzenny ulicy w zadanym
układzie współrzędnych. Jest to tablica, której kolejne pola oznaczają: x minimalny, y mininimalny, x maksymalny, y
maksymalny. Obowiązuje układ matematyczny. Parametr jest opcjonalny.
"punkt":"5", // Numer punktu. Parametr występuje, gdy punkt zostanie odnaleziony.
"wspolrzedne_punktu":[661458.429016793,486394.280104779] // Współrzędne odnalezionego punktu adresowego
w zadanym układzie współrzędnych. Parametr to tablica x, y. Obowiązuje układ matematyczny. Parametr występuje,
gdy odnaleziony zostanie punkt.
}]}
I to samo żądanie zwrócone w formacie XML:
http://punktyadresowe.pl/lokalizacja.php?adres=halinów okuniewska 5&crs=2180&format=xml
<?xml version="1.0" encoding="UTF-8"?>
<WynikiWyszukiwania liczbaPozycji="1">
<Pozycja>
<Trafnosc>1</Trafnosc>
<Miejscowosc>Halinów</Miejscowosc>
<Wojewodztwo>mazowieckie</Wojewodztwo>
<Powiat>miński</Powiat>
<Gmina/>
<ZakresMiejscowosci>659707,485798,662143,488148</ZakresMiejscowosci>
<Ulica>Okuniewska</Ulica>
<ZakresUlicy>660473.8,486229.4,661606.1,487731.1</ZakresUlicy>
<Punkt>5</Punkt>
<WspolrzednePunktu>661458.4,486394.2</WspolrzednePunktu>
</Pozycja>
</WynikiWyszukiwania>