Methods

Method detail for: getGeoFallbackByCoord

This request requires you to submit a latitude and longitude coordinate pair. The API will atttempt to determine if the given location is within a neighborhood. If so, it will return the neighborhood name, the city and the state within which that neighborhood resides. The API will search for valid neighborhoods in this order: Neighborhood, Macro Neighborhood, Sub Neighborhood. If the point does not reside within a neighborhood, the API will attempt to locate the census Place within which the point is located. If the point does not reside within a US Census defined Place, the API will return the MCD within which the point is located.

Valid Datasets

DatasetDataset DetailsMethod Parameters
Maponics Neighborhood Boundaries North AmericaClick To ViewClick To View

When calling this dataset using this method, use these parameters:

Maponics +Residential BoundariesClick To ViewClick To View

When calling this dataset using this method, use these parameters:

  • lat*
  • lon*
  • (Note: Items marked with * are required)

Sample Request and Return Data

<?xml version="1.0" encoding="UTF-8" ?> <data> <auth> <loginname>your_username</loginname> <key>your_api_key</key> </auth> <request> <dataset>Z</dataset> <method>getGeoAttByAddress</method> <parameters> <lat>40.713734</lat> <lon>-74.011683</lon> </parameters> </request> </data>
{ "data":{ "auth":{ "loginname":"your_username", "key":"your_api_key" }, "request":[ { "dataset":"", "method":"getGeoFallbackByCoord", "count":"false", "context":"", "returnType":"json", "parameters":{ "lat":"40.713734", "lon":"-74.011683" } } ] } }
(In this response, a valid neighborhood was located, and it was of type 'N'. Other responses would be sent, based on the lat/lon of the original request) <?xml version="1.0" encoding="UTF-8" ?> <data> <resultcode>0</resultcode> <message>Return OK</message> <requestid>4464</requestid> <request> <item> <neighborhd>Tribeca</neighborhd> <state>NY</state> <nbr_type>N</nbr_type> <city>New York</city> </item> </request> </data>
[ { "resultcode":0, "message":"Return OK", "requestid":"01-1459" }, [ { "neighborhd":"Tribeca", "state":"NY", "objectType":"Neighborhood", "city":"New York" } ] ]