service: location
desc: This is a location service, it takes in latitude and longitude and returns geography
parameters:
  latitude: string
  longitude: string
response:
  header:
    status: int
    message: string
  <<: *geography

service: location
desc: This is a location service, it takes in a free string as location and returns a geography object.
parameters:
  q: string
response:
  header:
    status: int
    message: string
  <<: *geography
--- # the locateip service
service: locateip
desc: This is a locate IP Service. It takes an IPAddress and resolves it into a geographic location.
parameters:
  ipaddress: string
response:
  header:
    status: int
    message: string
  latitude: float
  longitude: float
service: findBusinesses
desc: This is a local search service. ( by city state )
parameters:
  term: string
  city: string
  state: string
response:
  header:
    status: int
    message: string
    term: string
    city: string
    state: string
    zip: string
    latitude: string
    longitude: string
    location: string
    q: string
  <<: *listing

service: findBusinesses
desc: This is a local search service. (by zip)
parameters:
  term: string
  zip: string
response:
  header:
    status: int
    message: string
    term: string
    city: string
    state: string
    zip: string
    latitude: string
    longitude: string
    location: string
    q: string
  <<: *listing

service: findBusinesses
desc: This is a local search service. (by lat/lon)
parameters:
  term: string
  latitude: string
  longitude: string
response:
  header:
    status: int
    message: string
    term: string
    city: string
    state: string
    zip: string
    latitude: string
    longitude: string
    location: string
    q: string
  <<: *listing

service: findBusinesses
desc: This is a local search service. (by location)
parameters:
  term: string
  location: string
response:
  header:
    status: int
    message: string
    term: string
    city: string
    state: string
    zip: string
    latitude: string
    longitude: string
    location: string
    q: string
  <<: *listing

service: findBusinesses
desc: This is a local search service. (by free text)
parameters:
  q: string
response:
  header:
    status: int
    message: string
    term: string
    city: string
    state: string
    zip: string
    latitude: string
    longitude: string
    location: string
    q: string
  <<: *listing
service: parse
desc: This is a parsing service which parses a free text into search term and geography.
parameters:
  q: string
response:
  header:
    status: int
    message: string
    q: string
  body: 
    term: string
    <<: *geography