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.
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.
| 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. |
| 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. |
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.