NaturalEarthCountry Database

The CountryMap class stores the map data and exposes a query method to find the country (or equivalent) at a given latitude and longitude. Because each CountryMap instance is quite large, we recommend instantiating a single static instance in your project. The methods that you will need to use are as follows.

class CountryMap {

static CountryMap create(InputStream dataFileStream)

CountryResult findResult(float latDeg, float lonDeg)

// Additional methods exist in this class; for complete documentation, please see the Full Java Docs

}

The CountryResult class embodies the result of a query on a CountryMap instance. All of the results listed in the Returned Values Section may be accessed using an accessor whose method name consists of "get" followed by the "Key" parameter from the Returned Values tables. Those tables also specify the type of the returned value. For example, a few important accessors are:

class CountryResult {

String getNameShort()

String getEntityType()

String getIso3166A3()

// Additional methods exist in this class; for complete documentation, please see the Full Java Docs

}

The following is a complete example program demonstrating the use of the Ask Geo NaturalEarthCountry Java Library.

import com.askgeo.flt.naturalearth.CountryMap;
import com.askgeo.flt.naturalearth.CountryResult;
import java.io.FileInputStream;

public class NaturalEarthExample {
    static float[][] examplePoints = {{37f, -122f}, {42f, -89f}, {52f, -1f}, {51f, -31f}};
    static String license = "INSERT YOUR LICENSE STRING HERE";
    static String dataFilePath = "askgeo-natural-earth-country-1.1.0.dat";

    public static void main(String[] args) {
        try {
            CountryMap map = CountryMap.create(new FileInputStream(dataFilePath));
            map.authorize(license);
            for (float[] point : examplePoints) {
                CountryResult result = map.findResult(point[0], point[1]);
                if (result != null) {
                    System.out.println(" Latitude: " + point[0] +
                            ", Longitude: " + point[1] +
                            ", Short name: " + result.getNameShort() +
                            ", Formal name: " + result.getNameFormal());
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

    }
}

The CountryMap class stores the map data and exposes a query method to find the country (or equivalent) at a given latitude and longitude. Because each CountryMap instance is quite large, we recommend instantiating a single static instance in your project. The methods that you will need to use are as follows.

class CountryMap {

static CountryMap Create(Stream dataFileStream)

CountryResult FindResult(float latDeg, float lonDeg)

// Additional methods exist in this class; for complete documentation, please see the Full .NET Docs

}

The CountryResult class embodies the result of a query on a CountryMap instance. All of the results listed in the Returned Values Section may be accessed using an accessor whose method name consists of "Get" followed by the "Key" parameter from the Returned Values tables. Those tables also specify the type of the returned value. For example, a few important accessors are:

class CountryResult {

String GetNameShort()

String GetEntityType()

String GetIso3166A3()

// Additional methods exist in this class; for complete documentation, please see the Full .NET Docs

}

The following is a complete example program demonstrating the use of the Ask Geo NaturalEarthCountry .NET Library.

using System;
using System.IO;
using AskGeo.Flt;

class NaturalEarthCountry {
    static void Main(string[] args) {
        float[,] examplePoints = { { 37f, -122f }, { 42f, -89f }, { 52f, -1f }, { 51f, -31f } };
        String license = "INSERT YOUR LICENSE STRING HERE";
        String dataFilePath = @"askgeo-natural-earth-country-1.1.0.dat";
        NaturalEarthCountryMap map = NaturalEarthCountryMap.Create(new FileStream(dataFilePath, FileMode.Open));
        map.Authorize(license);

        for (int i = 0; i < examplePoints.GetLength(0); i++) {
            NaturalEarthCountryResult result = map.FindResult(examplePoints[i, 0], examplePoints[i, 1]);
            if (result != null) {
                Console.WriteLine(" Latitude: " + examplePoints[i, 0] +
                            ", Longitude: " + examplePoints[i, 1] +
                            ", Short name: " + result.GetNameShort() +
                            ", Formal name: " + result.GetNameFormal());
            }
        }
    }
}