api.maponics.com logo

Documentation > Public Methods > Method Detail: 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.

To see the parameters that are required by a specific dataset when calling this method, please select the dataset from the list below:

  Required parameters for this dataset/method combination

Sample Request XML

Please remember that this is merely a static example of an API request. For a real-world API request, the dataset code would reflect the actual dataset called, and the paramters would then follow from that dataset. To see a list of the required parameters for any given dataset with this method, select the dataset in the drop down list above.

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

Sample Response XML

Please remember that this is merely sample XML and the returned items shown are in no way representative of real-world data.

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