travel.izi.api.service

Interface CountryService

public interface CountryService

Endpoints for Country.

Method Summary

Modifier and Type	Method and Description
retrofit.client.Response	getChildrenResponse(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, java.lang.Boolean children_count, java.lang.String form)
retrofit.client.Response	getCitiesResponse(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, java.lang.String form)
java.util.List<CompactMtgObject>	getCompactChildren(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset) Get Country children in compact form.
void	getCompactChildren(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, IZITravelCallback<java.util.List<CompactMtgObject>> callback) Asynchronous version of getCompactChildren(String, String[], String[], String[], Long, Long).
java.util.List<CompactMtgObject>	getCompactCities(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset) Get list of compact City objects which belong to the Country with requested UUID.
void	getCompactCities(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, IZITravelCallback<java.util.List<CompactMtgObject>> callback) Asynchronous version of getCompactCities(String, String[], String[], String[], Long, Long).
java.util.List<CompactMtgObject>	getCompactCountries(java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset) Get list of compact Country objects which have content on requested languages.
void	getCompactCountries(java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, IZITravelCallback<java.util.List<CompactMtgObject>> callback) Asynchronous version of getCompactCountries(String[], String[], String[], Long, Long).
retrofit.client.Response	getCountriesResponse(java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, java.lang.String form)
FullMtgObject	getCountry(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except) Get full Country object by UUID.
void	getCountry(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, IZITravelCallback<FullMtgObject> callback) Asynchronous version of getCountry(String, String[], String[], String[]).
retrofit.client.Response	getCountryResponse(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.String form)
java.util.List<FullMtgObject>	getFullChildren(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, java.lang.Boolean children_count) Get Country children in full form.
void	getFullChildren(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, java.lang.Boolean children_count, IZITravelCallback<java.util.List<FullMtgObject>> callback) Asynchronous version of getFullChildren(String, String[], String[], String[], Long, Long, Boolean).
java.util.List<FullMtgObject>	getFullCities(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset) Get list of full City objects which belong to the Country with requested UUID.
void	getFullCities(java.lang.String uuid, java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, IZITravelCallback<java.util.List<FullMtgObject>> callback) Asynchronous version of getFullCities(String, String[], String[], String[], Long, Long).
java.util.List<FullMtgObject>	getFullCountries(java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset) Get list of full Country objects which have content on requested languages.
void	getFullCountries(java.lang.String[] languages, java.lang.String[] includes, java.lang.String[] except, java.lang.Long limit, java.lang.Long offset, IZITravelCallback<java.util.List<FullMtgObject>> callback) Asynchronous version of getFullCountries(String[], String[], String[], Long, Long).

Method Detail

getCompactCountries

@GET(value="/countries?form=compact")
java.util.List<CompactMtgObject> getCompactCountries(@Query(value="languages")
                                                                                           java.lang.String[] languages,
                                                                                           @Query(value="includes")
                                                                                           java.lang.String[] includes,
                                                                                           @Query(value="except")
                                                                                           java.lang.String[] except,
                                                                                           @Query(value="limit")
                                                                                           java.lang.Long limit,
                                                                                           @Query(value="offset")
                                                                                           java.lang.Long offset)

Get list of compact Country objects which have content on requested languages.

Parameters:

languages - Array of languages which should have country.

includes - Array of sections which should be included to country object.

except - Array of sections which should NOT be included to country object.

limit - Limit for pagination, defaults to 20.

offset - Offset for pagination, defaults to 0.

Returns:

List of countries which have content on requested languages. Returns empty list of there are no matched countries.

See Also:

getFullCountries(String[], String[], String[], Long, Long)

getCompactCountries

@GET(value="/countries?form=compact")
void getCompactCountries(@Query(value="languages")
                                                               java.lang.String[] languages,
                                                               @Query(value="includes")
                                                               java.lang.String[] includes,
                                                               @Query(value="except")
                                                               java.lang.String[] except,
                                                               @Query(value="limit")
                                                               java.lang.Long limit,
                                                               @Query(value="offset")
                                                               java.lang.Long offset,
                                                               IZITravelCallback<java.util.List<CompactMtgObject>> callback)

Asynchronous version of getCompactCountries(String[], String[], String[], Long, Long).

getFullCountries

@GET(value="/countries?form=full")
java.util.List<FullMtgObject> getFullCountries(@Query(value="languages")
                                                                                  java.lang.String[] languages,
                                                                                  @Query(value="includes")
                                                                                  java.lang.String[] includes,
                                                                                  @Query(value="except")
                                                                                  java.lang.String[] except,
                                                                                  @Query(value="limit")
                                                                                  java.lang.Long limit,
                                                                                  @Query(value="offset")
                                                                                  java.lang.Long offset)

Get list of full Country objects which have content on requested languages.

See Also:

getCompactCountries(String[], String[], String[], Long, Long)

getFullCountries

@GET(value="/countries?form=full")
void getFullCountries(@Query(value="languages")
                                                         java.lang.String[] languages,
                                                         @Query(value="includes")
                                                         java.lang.String[] includes,
                                                         @Query(value="except")
                                                         java.lang.String[] except,
                                                         @Query(value="limit")
                                                         java.lang.Long limit,
                                                         @Query(value="offset")
                                                         java.lang.Long offset,
                                                         IZITravelCallback<java.util.List<FullMtgObject>> callback)

Asynchronous version of getFullCountries(String[], String[], String[], Long, Long).

getCountriesResponse

@GET(value="/countries")
retrofit.client.Response getCountriesResponse(@Query(value="languages")
                                                                       java.lang.String[] languages,
                                                                       @Query(value="includes")
                                                                       java.lang.String[] includes,
                                                                       @Query(value="except")
                                                                       java.lang.String[] except,
                                                                       @Query(value="limit")
                                                                       java.lang.Long limit,
                                                                       @Query(value="offset")
                                                                       java.lang.Long offset,
                                                                       @Query(value="form")
                                                                       java.lang.String form)

getCountry

@GET(value="/countries/{uuid}")
FullMtgObject getCountry(@Path(value="uuid")
                                                         java.lang.String uuid,
                                                         @Query(value="languages")
                                                         java.lang.String[] languages,
                                                         @Query(value="includes")
                                                         java.lang.String[] includes,
                                                         @Query(value="except")
                                                         java.lang.String[] except)

Get full Country object by UUID.

Parameters:

uuid - UUID of the Country.

languages - Array of languages which should have country.

includes - Array of sections which should be included to country object.

except - Array of sections which should NOT be included to country object.

Returns:

Country or 404 HTTP code if there is no Country with provided UUID.

getCountry

@GET(value="/countries/{uuid}")
void getCountry(@Path(value="uuid")
                                                java.lang.String uuid,
                                                @Query(value="languages")
                                                java.lang.String[] languages,
                                                @Query(value="includes")
                                                java.lang.String[] includes,
                                                @Query(value="except")
                                                java.lang.String[] except,
                                                IZITravelCallback<FullMtgObject> callback)

Asynchronous version of getCountry(String, String[], String[], String[]).

getCountryResponse

@GET(value="/countries/{uuid}")
retrofit.client.Response getCountryResponse(@Path(value="uuid")
                                                                            java.lang.String uuid,
                                                                            @Query(value="languages")
                                                                            java.lang.String[] languages,
                                                                            @Query(value="includes")
                                                                            java.lang.String[] includes,
                                                                            @Query(value="except")
                                                                            java.lang.String[] except,
                                                                            @Query(value="form")
                                                                            java.lang.String form)

getCompactChildren

@GET(value="/countries/{uuid}/children?form=compact")
java.util.List<CompactMtgObject> getCompactChildren(@Path(value="uuid")
                                                                                                          java.lang.String uuid,
                                                                                                          @Query(value="languages")
                                                                                                          java.lang.String[] languages,
                                                                                                          @Query(value="includes")
                                                                                                          java.lang.String[] includes,
                                                                                                          @Query(value="except")
                                                                                                          java.lang.String[] except,
                                                                                                          @Query(value="limit")
                                                                                                          java.lang.Long limit,
                                                                                                          @Query(value="offset")
                                                                                                          java.lang.Long offset)

Get Country children in compact form.

Parameters:

uuid - UUID of the Country.

languages - Array of requested languages, i.e. Country's children should have one of the requested languages.

includes - Array of sections which should be included into response.

except - Array of sections which should NOT be included into response.

limit - Limit for pagination, defaults to 20.

offset - Offset for pagination, defaults to 0.

Returns:

Tours and Museums which belongs to the country. Returns 404 HTTP code if there is no Country with provided UUID.

See Also:

getFullChildren(String, String[], String[], String[], Long, Long, Boolean)

getCompactChildren

@GET(value="/countries/{uuid}/children?form=compact")
void getCompactChildren(@Path(value="uuid")
                                                                              java.lang.String uuid,
                                                                              @Query(value="languages")
                                                                              java.lang.String[] languages,
                                                                              @Query(value="includes")
                                                                              java.lang.String[] includes,
                                                                              @Query(value="except")
                                                                              java.lang.String[] except,
                                                                              @Query(value="limit")
                                                                              java.lang.Long limit,
                                                                              @Query(value="offset")
                                                                              java.lang.Long offset,
                                                                              IZITravelCallback<java.util.List<CompactMtgObject>> callback)

Asynchronous version of getCompactChildren(String, String[], String[], String[], Long, Long).

getFullChildren

@GET(value="/countries/{uuid}/children?form=full")
java.util.List<FullMtgObject> getFullChildren(@Path(value="uuid")
                                                                                                 java.lang.String uuid,
                                                                                                 @Query(value="languages")
                                                                                                 java.lang.String[] languages,
                                                                                                 @Query(value="includes")
                                                                                                 java.lang.String[] includes,
                                                                                                 @Query(value="except")
                                                                                                 java.lang.String[] except,
                                                                                                 @Query(value="limit")
                                                                                                 java.lang.Long limit,
                                                                                                 @Query(value="offset")
                                                                                                 java.lang.Long offset,
                                                                                                 @Query(value="children_count_in_full_form")
                                                                                                 java.lang.Boolean children_count)

Get Country children in full form.

See Also:

getCompactChildren(String, String[], String[], String[], Long, Long)

getFullChildren

@GET(value="/countries/{uuid}/children?form=full")
void getFullChildren(@Path(value="uuid")
                                                                        java.lang.String uuid,
                                                                        @Query(value="languages")
                                                                        java.lang.String[] languages,
                                                                        @Query(value="includes")
                                                                        java.lang.String[] includes,
                                                                        @Query(value="except")
                                                                        java.lang.String[] except,
                                                                        @Query(value="limit")
                                                                        java.lang.Long limit,
                                                                        @Query(value="offset")
                                                                        java.lang.Long offset,
                                                                        @Query(value="children_count_in_full_form")
                                                                        java.lang.Boolean children_count,
                                                                        IZITravelCallback<java.util.List<FullMtgObject>> callback)

Asynchronous version of getFullChildren(String, String[], String[], String[], Long, Long, Boolean).

getChildrenResponse

@GET(value="/countries/{uuid}/children")
retrofit.client.Response getChildrenResponse(@Path(value="uuid")
                                                                                      java.lang.String uuid,
                                                                                      @Query(value="languages")
                                                                                      java.lang.String[] languages,
                                                                                      @Query(value="includes")
                                                                                      java.lang.String[] includes,
                                                                                      @Query(value="except")
                                                                                      java.lang.String[] except,
                                                                                      @Query(value="limit")
                                                                                      java.lang.Long limit,
                                                                                      @Query(value="offset")
                                                                                      java.lang.Long offset,
                                                                                      @Query(value="children_count_in_full_form")
                                                                                      java.lang.Boolean children_count,
                                                                                      @Query(value="form")
                                                                                      java.lang.String form)

getCompactCities

@GET(value="/countries/{uuid}/cities?form=compact")
java.util.List<CompactMtgObject> getCompactCities(@Path(value="uuid")
                                                                                                      java.lang.String uuid,
                                                                                                      @Query(value="languages")
                                                                                                      java.lang.String[] languages,
                                                                                                      @Query(value="includes")
                                                                                                      java.lang.String[] includes,
                                                                                                      @Query(value="except")
                                                                                                      java.lang.String[] except,
                                                                                                      @Query(value="limit")
                                                                                                      java.lang.Long limit,
                                                                                                      @Query(value="offset")
                                                                                                      java.lang.Long offset)

Get list of compact City objects which belong to the Country with requested UUID.

Parameters:

uuid - UUID of the Country.

languages - Array of requested languages, each Country's City should have content at one of the requested language.

includes - Array of sections which should be included to city object.

except - Array of sections which should NOT be included to city object.

limit - Limit for pagination, defaults to 20.

offset - Offset for pagination, defaults to 0.

Returns:

List of cities which belong to requested Country and have content on requested languages object or 404 HTTP code if there is no Country with provided UUID.

See Also:

getFullCities(String, String[], String[], String[], Long, Long)

getCompactCities

@GET(value="/countries/{uuid}/cities?form=compact")
void getCompactCities(@Path(value="uuid")
                                                                          java.lang.String uuid,
                                                                          @Query(value="languages")
                                                                          java.lang.String[] languages,
                                                                          @Query(value="includes")
                                                                          java.lang.String[] includes,
                                                                          @Query(value="except")
                                                                          java.lang.String[] except,
                                                                          @Query(value="limit")
                                                                          java.lang.Long limit,
                                                                          @Query(value="offset")
                                                                          java.lang.Long offset,
                                                                          IZITravelCallback<java.util.List<CompactMtgObject>> callback)

Asynchronous version of getCompactCities(String, String[], String[], String[], Long, Long).

getFullCities

@GET(value="/countries/{uuid}/cities?form=full")
java.util.List<FullMtgObject> getFullCities(@Path(value="uuid")
                                                                                             java.lang.String uuid,
                                                                                             @Query(value="languages")
                                                                                             java.lang.String[] languages,
                                                                                             @Query(value="includes")
                                                                                             java.lang.String[] includes,
                                                                                             @Query(value="except")
                                                                                             java.lang.String[] except,
                                                                                             @Query(value="limit")
                                                                                             java.lang.Long limit,
                                                                                             @Query(value="offset")
                                                                                             java.lang.Long offset)

Get list of full City objects which belong to the Country with requested UUID.

See Also:

getCompactCities(String, String[], String[], String[], Long, Long)

getFullCities

@GET(value="/countries/{uuid}/cities?form=full")
void getFullCities(@Path(value="uuid")
                                                                    java.lang.String uuid,
                                                                    @Query(value="languages")
                                                                    java.lang.String[] languages,
                                                                    @Query(value="includes")
                                                                    java.lang.String[] includes,
                                                                    @Query(value="except")
                                                                    java.lang.String[] except,
                                                                    @Query(value="limit")
                                                                    java.lang.Long limit,
                                                                    @Query(value="offset")
                                                                    java.lang.Long offset,
                                                                    IZITravelCallback<java.util.List<FullMtgObject>> callback)

Asynchronous version of getFullCities(String, String[], String[], String[], Long, Long).

getCitiesResponse

@GET(value="/countries/{uuid}/cities")
retrofit.client.Response getCitiesResponse(@Path(value="uuid")
                                                                                  java.lang.String uuid,
                                                                                  @Query(value="languages")
                                                                                  java.lang.String[] languages,
                                                                                  @Query(value="includes")
                                                                                  java.lang.String[] includes,
                                                                                  @Query(value="except")
                                                                                  java.lang.String[] except,
                                                                                  @Query(value="limit")
                                                                                  java.lang.Long limit,
                                                                                  @Query(value="offset")
                                                                                  java.lang.Long offset,
                                                                                  @Query(value="form")
                                                                                  java.lang.String form)