Developer Network


townwalls' Developer Network APIs and Web Services enhance the value of local content. Simply put, knowing location is useful, but providing context is invaluable. Our solutions are used by leading local search, portal, real estate, mobile and other publishers to provide context to content.

The townwalls Developer Network offers Web Services and APIs to make it easy for developers to build powerful applications and mashups. townwalls' APIs and Web Services let developers tap into a world class data and infrastructure to help them power their business. townwalls' APIs and Web Services are governed by the relevant Terms of Use and Usage Policy. While we make a limited amount of queries available for small-volume applications, we are also interested in working with companies to help them gain an edge by building on top of townwalls' as a platform, applications that often require greater query volumes.

All of our Web Services are available for use up to the standard per-service rate limit in applications and web sites that comply with our Terms of Use. Many of our Web Services will allow certain kinds of business usage, but this can vary per-service. You can review our general Usage Policies for more information about what is permitted. Access is rate limited based on the caller's IP address, and queries are limited per IP and per day. Each service may have a different access rate limit. See the documentation for each service for more information. Circumvention of these rate limits by any means is expressly forbidden under our Terms of Use.


APIs and Web Services

To access the Developer Network APIs and Web Services, you will need to get an application ID. To obtain an application ID please contact api@ombrosbrands.com. We are currnetly offering private distribution of application IDs.


General Services


Web Service Description
getListingInfo Returns information on a given listing (business, place, event) given latitude/longitude, address, phone or id. Information includes name, address, coordinates, short descriptions, long descriptions, images, reviews, ratings, email, official url, hours of operation and much more.
getListingCoordinates Returns the latitide/longitide of a given listing given latitude/longitude, address, phone or id.
getListingDescription Returns the description of a given listing given latitude/longitude, address, phone or id.
getListingDirections Returns the directions of a given listing given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getListingMajorDirections Returns the major directions (from major highways) of a given listing given latitude/longitude, address, phone or id.
getListingImages Returns any images urls, both full and thumbnails of a listing given latitude/longitude, address, phone or id. Images will alos return the original image source and attributions.
getListingURL Returns the official listing Web site URL of a given listing given latitude/longitude, address, phone or id.
getListingPhone Returns the primary phone number of a given listing given latitude/longitude, address, phone or id.
getListingFax Returns the primary fax number of a given listing given latitude/longitude, address, phone or id.
getListingAddress Returns the address of a given listing given latitude/longitude, address, phone or id.
getListingHours Returns the hours of operations for a business of a given listing given latitude/longitude, address, phone or id.
getListingCategories Returns the any associaled categories (see categories) a given listing given latitude/longitude, address, phone or id.
getCountryCode Returns the iso country code for the given latitude/longitude (reverse geocoding).
getCountryInfo Returns the country information including capital, population, area in square km, bounding coordinates, descriptions, wikipedia links and more the given latitude/longitude or iso country code.
getCountrySubdivisions Returns returns the country and the administrative subdivison (state, province, etc.) for the given latitiude or longitude or iso country code.
getOcean Returns the ocean or sea for the given latitude/longitude. Includes description information including links to Wikipedia articles and images.
getAdminsitrativeSubdivision Returns the administrative subdivision (divisions such as states, provinces, districts and municipalities) given the latitude/longitude (reverse geocoding).
getLocality Returns the locality (town, city, etc.) given the latitude/longitude (reverse geocoding).
getDependentLocality Returns the dependent locality (dependent town, city, etc.) given the latitude/longitude (reverse geocoding).
getPostalCode Returns the postal code given the latitude/longitude (reverse geocoding). (reverse geocoding).
getThoroughfare Returns the thoroughfare and number (street address) given the latitude/longitude (reverse geocoding).
getNeighborhood Returns the neighbourhood for the given latitude/longitude. Includes description information including links to Wikipedia articles and images.
getElevation Returns the height above sea level for the given latitude and longitude.
getPhotos Returns a set of plublic photos for the given latitude and longitude range. Photos are mined real-time from a number of online resources including Panoramio, Flickr, Google and others.
getCoordinates_IPAddress Returns the latitude/longitude given an IP Address. Coordinates are based on a mumber of factors included known WiFi locatons, GMS and more.
getCoordinates_Address Returns the latitude/longitude given an street address.
getCoordinates_Phone Returns the latitude/longitude given a phone number.
getDirections Returns the directions of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getMassTransitDirections Returns the directions via mass transit services of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getWalkingDirections Returns the walking directions of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getBicycleDirections Returns the bicycle directions of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getDirectionsFromMajorRoads Returns the directions from major roads coming from North, South, East or West of a given latitude/longitude, address, phone or id.
getClosestMajorRoads Returns a list of closest major roads of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getClosestMajorCities Returns a list of closest major cities (adminsitrative subdivisions, localities) and approximate distances of a given latitude/longitude, address, phone or id given the starting point latitide/longitide.
getPhoneCarrier Returns the phone carrier service given a phone number.
getWeather Returns the current weather of a given latitude/longitude.
getWeatherTrends Returns the weather trends (average highs, lows, rainfall, etc.) of a given latitude/longitude.
getTimeZone Returns the timezone at the latitude/longitude with gmt offset (1. January) and dst offset (1. July). Name of the timezone (according to olson), this information is sufficient to work with the timezone and defines DST rules.
getTime Returns the local time at the latitude/longitude.
getSunriseSunsetTimes Returns the local times of sunrise and sunset at the latitude/longitude.

Context Specific Services


Web Service Description
getFreeWiFiLocations Returns free WiFi locations given latitude/longitude. Query based on a number of paramaters given categories, radius, status, etc.
getHotelLocations Returns hotel/motel/resort locations given latitude/longitude. Query based on a number of paramaters given categories (hotel, motel, resort), price range, radius, status, etc.
getHotelRates Returns the current rates of a given hotel location.
getHotelRateTrends Returns the rates trends of a given hotel location over a specified date range.
getVegetarianLocations Returns vegetarian locations given latitude/longitude. Query based on a number of paramaters given categories, radius, status, etc.
getGreenLocations Returns eco-friendly ("green") locations given latitude/longitude. Query based on a number of paramaters given categories (restaurants, stores, etc.), radius, status, etc.
getKosherLocations Returns kosher locations given latitude/longitude. Query based on a number of paramaters given categories (restaurants, bakeries, etc.), radius, status, etc.
getCampingLocations Returns camping locations given latitude/longitude. Query based on a number of paramaters given categories (rv parks, state parks, tent sites, holiday parks, etc.), radius, status, etc.
getRestAreasLocations Returns rest areas/trucks stops locations given latitude/longitude. Query based on a number of paramaters given categories (rest area, truck stop, etc.), radius, status, etc.
getMassTransitLocations Returns Mass Transit proximity locations given latitude/longitude and type of mass transit service(s) such as bus, train, etc. This includes a broad collection of data elements, including data elements such as station accessibility, amenities, hours of operation, exit types, sleeper cars, parking facilities, station/line transfers and more.
getParkingLocations Returns parking locations given latitude/longitude. This includes rate schedules, payment methods, entrance and exit locations, accessibility, images and other relevant data.
getAirports Returns closest airports given latitude/longitude.
getFamousPlaces Returns closest famous places nearby a given latitude/longitude.


Geo Trageting Ad Services (geoAD)


Traditional IP-based geographic targeting focuses on the geographic origin of the search query and not on the user's intent. While it can be effective at the national and state level, IP-based geographic targeting lacks the granular detail required to allow for effective local advertising.

geoAD is a geographic contextual based service that that define a locality of the end-point user. geoAD returns specific context for a location, including neighborhood names, nearby parks, cultural and technological attractions, bus and subway stations, and other attributes in order to define a service area for your business.

By incorporating this context into search optimization strategies or using them in search advertising, the Website for your business will get traffic that is more local in nature. Using geographically focused context allows you to attract better qualified visitors without having to focus on more competitive (and higher priced) keywords.

Contact us at geoAD@ombrosbrands.com for more information.