geocode

Description:

geocode

Geocode library #




Introduction #
Package to make Geocode requests. It exposes two methods to translate coordinates into locations and addresses into coordinates.
It's a basic implementation of the most useful methods in the Dart language of the following API geocode.xyz.
It's free for one request per second quota. Register in the above site to get an API Key and increase the number of requests to 10 per second. These are paid plans that allow more requests per second. For more information, review the site.
Installation #
dependecies:
geocode: 1.0.3
copied to clipboard
Example #
See example/main.dart
import 'package:geocode/geocode.dart';

void main() async {
GeoCode geoCode = GeoCode();

try {
Coordinates coordinates = await geoCode.forwardGeocoding(
address: "532 S Olive St, Los Angeles, CA 90013");

print("Latitude: ${coordinates.latitude}");
print("Longitude: ${coordinates.longitude}");
} catch (e) {
print(e);
}
}
copied to clipboard
Methods #
Constructor #
Library GeoCode class constructor, includes an optional parameter to set the apiKey.
GeoCode({this.apiKey});
copied to clipboard
Reverse Geocode #
Method to translate a pair of latitude and longitude coordinates into a real address.
Future<Address> reverseGeocoding({double latitude, double longitude})
copied to clipboard
Forward Geocode #
Method to translate an address into a pair of latitude and longitudecoordinates.
Future<Coordinates> forwardGeocoding({String address})
copied to clipboard
Responses #
Reverse Geocode #



Attribute
Type
Description




elevation
double
The elevation in meters.


timezone
String
The timezone.


geoNumber
int
geocode is an alphanumeric string representing both latitude and longitude as one value. Nearby points will have similar geocodes.


streetNumber
int
The properly formated street address number to be returned.


streetAddress
String
The properly formated street address to be returned.


city
String
The properly formated city name to be returned.


countyCode
String
The properly formated country code to be returned.


countryName
String
The properly formated country name to be returned.


region
String
The properly formated region to be returned.


postal
String
The properly formated postal code to be returned.


distance
double
The distance of the result location from the input location.



Forward Geocode #



Attribute
Type
Description




latitude
double
Latitude coordinate value.


longitude
double
Longitude coordinate value.



Exceptions #

AccountOutOfCreditsException: auth has ran out of credits.
AuthTokenNotFoundException: authentication token: auth not found.
PostalCodeFormatException: postal Code is not in the proper Format.
RequestThrottledException: request Throttled.
InvalidQueryException: supply a valid query.
EmptyResultException: your request did not produce any results. Check your spelling and try again.
UnknownErrorException: unkown error.

Dependencies #
http: '>=0.13.0 <2.0.0'
copied to clipboard
License #
BSD 3-Clause License