API umożliwia automatyczne dopasowanie i skojarzenie przejazdów w oparciu o grupy użytkownika instytucjonalnego stosując wiele kryteriów, które zadawane są w postaci funkcji get.
Aby skorzystać z zasobów grupy zdalnie, należy się zalogować korzystając z biblioteki:
http://php.net/manual/en/class.soapclient.php Funkcja wywoływana pod adresem
https://bytheway.pl/przejazd/json_wyszukane/
Wszystkie parametry muszą zostać przekazana za pomocą funkcji get. Funkcja zwraca enkodowaną tablicę zawierającą dane z wynikami wyszukiwania, w momencie nie znalezienia odpowiednich tras zwracany jest enkodowany napis:
'Obecnie nie ma żadnego przejazdu na wyszukanej przez Ciebie trasie.'.
Aby funkcja działała użytkownik musi być zalogowany w systemie bytheway.pl.
@param int $from_lat [obowiązkowy] - szerokość geograficzna punktu startowego
@param int $from_lng [obowiązkowy] - długość geograficzna punktu startowego
@param int $to_lat [obowiązkowy] - szerokość geograficzna punktu końcowego
@param int $to_lng [obowiązkowy] - długość geograficzna punktu końcowego
@param int $walk_disstance [obowiązkowy] - maksymalna długość przesiadki między trasami
@param string $price_to_select [warunkowy] - maksymalna cena za przejazd,
dopuszczalna wartość: 'max'
@param int $free_places [warunkowy] - minimalna ilość wolnych miejsc na przejazd
dopuszczalna wartość: 'all'
@param int $date_from [warunkowy] - data początkowa wyszukiwanych tras, w postaci timestamp z systemu unix
dopuszczalna wartość: 'past'
@param int $date_to [warunkowy] - data końcowa wyszukiwanych tras, w postaci timestamp z systemu unix
dopuszczalna wartość: 'future'
@param string $group_slug [obowiązkowy] - nazwa grupy (slug) do której osoba posiada dostęp
zwrócona tablica ma następująca postać:
'id' => 'id trasy w bazie danych'
'photo' => 'zdjęcie użytkownika oferującego przejazd',
'short_name' => 'krotka nazwa opisująca trasę, zawiera nazwy miejscowości początkowej i końcowej',
'long_ride' => 'długa nazwa opisująca trasę, zawiera dokładne punkty startu i końca',
'travel_start_date' => 'data startu podróży',
'travel_start_hour' => 'godzina startu podróży',
'price' => 'cena za przejazd',
'places' => 'ilość miejsc dostępnych oraz początkowa ilość miejsc dostępnych na tym przejeździe',
'rate' => 'ocena kierowcy w portalu bytheway, jeżeli ustawiona na -1 oznacza to, że kierowca nie został jeszcze oceniony',
'bounds' => '2 punkty reprezentujące granice mapy przedstawiającej trasę, północny wschod i południowy zachód',
'route' => 'string reprezentujący punkty na mapie, pokazuje dokładną tras po której poruszać się będzie kierowca',
'delivery' => 'maksymalny odległość o jaką może oddalić sie kierowca od preferowanej trasy, odległość mierzona w kilometrach',
'distinction' => 'informacja czy oferta jest wyróżniona'
Przykładowe zapytanie:
https://bytheway.pl/przejazd/json_wyszukane/52.248718499999995/20.9876623/52.048652/20.445987999999943/25/max/1/past/1454572800/nazwa_grupy_do_ktorej_naleze
Przykładowa odpowiedź:
{"123":{"type":"1","photo":"\/files\/s14226161586.png","short_name":"Be\u0142chat\u00f3w - Warszawa","long_ride":"Be\u0142chat\u00f3w - Warszawa","travel_start_date":"Jutro","travel_start_hour":"13:30","price":"<span class=\ "searched_table_price yellow\">19 z\u0142<\/span>","places":"3\/3","rate":"-1","bounds":"<a lat_bounds=\"52.22968 21.01219 51.36874 19.35645\" ><\/a>","route":"<a route=\"51.36874, 19.35645 ;51.37064, 19.37675 ;51.42198, 19.4977 ;51.41302, 19.61463 ;51.40978, 19.63545 ;51.43087, 19.64137 ;51.44724, 19.75991 ;51.52502, 19.93966 ;51.59256, 20.04799 ;51.67452, 20.1838 ;51.76479, 20.26912 ;51.77149, 20.27363 ;51.86369, 20.38286 ;51.93701, 20.4781 ;52.00403, 20.58045 ;52.03738, 20.69583 ;52.09653, 20.81444 ;52.13738, 20.89991 ;52.16632, 20.9338 ;52.19557, 20.96307 ;52.22443, 20.98899 ;52.22746, 21.00175 ;52.22956, 21.01148 \" ><\/a>","delivery":"<a travel_spread=\"16\" ><\/a>","distinction":"0"},"135":{"type":"1","photo":"\/files\/s14226161586.png","short_name":"Warszawa - \u017bory","long_ride":"Warszawa - \u017bory","travel_start_date":"10-02-2015","travel_start_hour":"14:30","price":"<span class=\"searched_table_price yellow\">42 z\u0142<\/span>","places":"3\/3","rate":"-1","bounds":"<a lat_bounds=\"52.22968 21.01219 50.04406 18.66027\" ><\/a>","route":"<a route=\"52.22968, 21.01219 ;52.22995, 21.01125 ;52.22796, 21.00212 ;52.22515, 20.98919 ;52.19055, 20.91989 ;52.17694, 20.91344 ;52.16852, 20.92702 ;52.16646, 20.9333 ;52.13858, 20.90083 ;52.08195, 20.79153 ;52.02682, 20.6669 ;52.00179, 20.5593 ;51.9367, 20.47762 ;51.86345, 20.38254 ;51.7841, 20.27915 ;51.7731, 20.27407 ;51.69873, 20.21693 ;51.6245, 20.0961 ;51.55152, 19.99434 ;51.50016, 19.86113 ;51.44299, 19.69527 ;51.43054, 19.64105 ;51.40729, 19.63377 ;51.25294, 19.52648 ;51.149, 19.43573 ;51.07668, 19.37054 ;50.95965, 19.25188 ;50.87564, 19.16067 ;50.79693, 19.13147 ;50.75995, 19.15968 ;50.70546, 19.14453 ;50.60022, 19.1502 ;50.53538, 19.1885 ;50.44806, 19.2248 ;50.42244, 19.21262 ;50.42026, 19.20281 ;50.45409, 19.10749 ;50.45335, 19.05569 ;50.3756, 18.96603 ;50.38746, 18.84589 ;50.35278, 18.72385 ;50.29012, 18.7146 ;50.20483, 18.69756 ;50.09241, 18.66296 ;50.0811, 18.66318 ;50.06459, 18.66039 ;50.06167, 18.66301 ;50.0549, 18.67986 ;50.0471, 18.69229 ;50.04728, 18.6971 ;50.045, 18.70014 ;50.0443, 18.69851 ;50.04404, 18.69842 \" ><\/a>","delivery":"<a travel_spread=\"35\" ><\/a>","distinction":"0"}}
