--- title: "Country" language: "en" type: "Entity" summary: "Countries and their dependent territories." canonical_url: "https://reference.wolfram.com/language/ref/entity/Country.html" source: "Wolfram Language Documentation" related_guides: - title: "Entity Types" link: "https://reference.wolfram.com/language/guide/EntityTypes.en.md" --- # Country Countries and their dependent territories. [Related Interpreter](https://reference.wolfram.com/language/ref/interpreter/Country.en.md) Entity["Country", name] or Entity[...] represents an entity of type "Country". Entity[...][prop] gives the value of a specified property. Entity[...][{propi, …}] gives the value of a list of properties. Entity[...][prop, {quali -> vali, …}] gives the value of a specified property modified by qualifier rules quali -> vali. Entity[...][Dated[prop, date]] gives the value of a property associated with a particular date specification. EntityClass["Country", {propi -> speci, …}] represents a class of entities with values of propi defined by speci. ## Sample Entities * Entity["Country", "UnitedStates"]Entity["Country", "Chile"]Entity["Country", "China"]Entity["Country", "France"]Entity["Country", "Nigeria"]Entity["Country", "Norway"]Entity["Country", "Japan"]Entity["Country", "Indonesia"]Entity["Country", "Liechtenstein"]Entity["Country", "NewZealand"]**…** ## Sample Entity Classes * EntityClass["Country", "AsiaPacific"]EntityClass["Country", "EastAfrica"]EntityClass["Country", "EuropeSovereign"]EntityClass["Country", "FormerEthiopiaMembers"]EntityClass["Country", "GroupOf24"]EntityClass["Country", "ILO"]EntityClass["Country", "IMF"]EntityClass["Country", "InternationalDevelopmentAssociation"]EntityClass["Country", "SouthernEurope"]**…** ## Properties | | | | -------------------------------------------------------------- | ----------------------------------------------------------------------- | | ActiveHomeListingCount | active home listings | | AdjustedNetNationalIncome | adjusted net national income | | AdjustmentSeasonalBorrowings | seasonal bank borrowings from Fed, plus adjustments | | AdministrativeDivisions | regions | | AdultPopulation | adult population | | AdultsObese | obese adults | | AggravatedAssault | number of aggravated assaults | | AggravatedAssaultRate | rate of aggravated assault | | AggregateHomeValue | aggregate home value | | AggregateHomeValue15To24 | aggregate home value, householder 15 to 24 years | | AggregateHomeValue25To34 | aggregate home value, householder 25 to 34 years | | AggregateHomeValue35To64 | aggregate home value, householder 35 to 64 years | | AggregateHomeValue65 | aggregate home value, householder 65 years and over | | AggregateHouseholdIncome | aggregate household income | | AggregateWeeklyHoursIndex | aggregate weekly hours index | | AgriculturalIrrigatedLandFraction | agricultural irrigated land fraction | | AgriculturalLandFraction | agricultural land fraction | | AgriculturalProductionIndex | agricultural production index | | AgriculturalProductionPerCapitaIndex | agricultural production per capita index | | AgriculturalProducts | agricultural products | | AgricultureConsumption | consumption | | AgricultureConsumptionPerCapita | consumption per capita | | AgricultureHarvestArea | harvest area | | AgricultureHarvestAreaPerCapita | harvest area per capita | | AgricultureProduction | production | | AgricultureProductionPerCapita | production per capita | | AgricultureYield | average yield | | AgricultureYieldPerCapita | yield per capita | | AirArrivals | arrivals by air | | AircraftCarriers | aircraft carriers | | AirForce | air force | | Airports | airports | | AirTransport | air transport | | Alcohol ... | | AllPrimaryFuels | total primary energy | | AlternateNames | alternate names | | AMRadioStations | AM radio stations | | AnnualAnnulments | annual annulments | | AnnualBirths | annual births | | AnnualDeaths | annual deaths | | AnnualDivorces | annual divorces | | AnnualHIVAIDSDeaths | annual HIV/AIDS deaths | | AnnualMarriages | annual marriages | | AntenatalCareCoverage | antenatal care coverage | | ArableLandArea | annual‐crop land area | «693 rows removed» | VehiclesInUseMotorcyclesPerKilometersOfRoads | motorcycles in use per road length | | VehiclesInUseMotorcyclesPerThousandPeople | motorcycles in use per population | | VehiclesInUsePassengerCars | passenger cars in use | | VehiclesInUsePassengerCarsPerKilometersOfRoads | passenger cars in use per road length | | VehiclesInUsePassengerCarsPerThousandPeople | passenger cars in use per population | | VehiclesInUseTotal | total vehicles in use | | VehiclesInUseTotalPerKilometersOfRoads | total vehicles in use per road length | | VehiclesInUseTotalPerThousandPeople | total vehicles in use per population | | VehiclesInUseTrucksAndVans | trucks and vans in use | | VehiclesInUseTrucksAndVansPerKilometersOfRoads | trucks and vans in use per road length | | VehiclesInUseTrucksAndVansPerThousandPeople | trucks and vans in use per population | | ViolentCrimeRate | total rate of violent crime | | ViolentCrimeTotal | total number of violent crimes | | VulnerableEmployment | vulnerable employment | | VulnerableEmploymentFraction | vulnerable employment fraction | | WageAndSalariedWorkers | wage and salaried workers | | WageAndSalariedWorkersFraction | wage and salaried workers fraction | | WagesCostIndex | wage cost index | | WaterArea | water area | | WaterArrivals | arrivals by sea | | WaterProductivity | water productivity | | WaterwayLength | waterway length | | Workforce | employment | | WPI | wholesale price index | ## Details * ``"Country"`` entities include countries, dependent territories and other special areas defined by the ISO 3166-1 standard. * ``"Country"`` entity classes include groups of entities with shared geographic, linguistic, demographic or other characteristics, as well as memberships in various international organizations. * Some properties are available for the ``"Country"`` entity type as a whole and can be given using the form ``EntityValue["Country", property]``. Such properties include: | | | | ----------------------------- | ------------------------------------------------------------------ | | "Properties" | the list of available properties | | "PropertyCanonicalNames" | the standard names of available properties | | "SampleEntities" | a sample list of available entities (typically of length 10) | | "SampleEntityClasses" | a sample list of available entity classes (typically of length 10) | | "EntityCount" | number of entities available | | "Entities" | the list of available entities | | "EntityCanonicalNames" | the standard names of available entities | | "EntityClasses" | the list of available entity classes | | "EntityClassCanonicalNames" | the standard names of available entity classes | | "PropertyClasses" | the list of available property classes | | "PropertyClassCanonicalNames" | the standard names of available property classes | | "PropertyCount" | number of properties available | * The following annotations can be used in the third argument of ``EntityValue["Country", property, annotation]`` : | | | | --- | --- | | "Source" | source information for the property | | "Date" | the date associated with the entity-property value (if any) | | "EntityAssociation" | an association of entities and entity-property values | | "PropertyAssociation" | an association of properties and entity-property values | | "EntityPropertyAssociation" | an association in which the specified entities are keys, and values are a nested association of properties and entity-property values | | "PropertyEntityAssociation" | an association in which the specified properties are keys, and values are a nested association of entities and entity-property values | | "Dataset" | a dataset in which the specified entities are keys, and values are an association of property names and entity-property values | * The following annotations can be used in the second argument of ``EntityValue[property, annotation]`` : | | | | ------------------------ | --------------------------------------------------------------- | | "Qualifiers" | the list of possible qualifiers for the property | | "QualifierValues" | the list of possible values that can be given to each qualifier | | "DefaultQualifierValues" | the list of default values for the property's qualifiers | | "Description" | a brief textual description of the property | | "Definition" | a detailed textual definition of the property | | "PhysicalQuantity" | the physical quantity associated with the entity-property value | | "Unit" | the unit associated with the entity-property value | * A qualifier value of ``Automatic`` indicates that an applicable format of values can be used; e.g. for the ``"Date"`` qualifier, this includes a proper date or date span. --- ## Examples (25) ### Basic Examples (3) Use ctrl+= for entity discovery: ```wl In[1]:= [image] Out[1]= Entity["Country", "Belarus"] ``` --- Find a property value for an entity: ```wl In[1]:= Entity["Country", "France"]["Population"] Out[1]= Quantity[66438822, "People"] ``` --- Retrieve a dataset of all available properties for an entity: ```wl In[1]:= Entity["Country", "Peru"]["Dataset"]//DeleteMissing Out[1]= Dataset[<>] ``` ### Scope (22) Find the members of the G7: ```wl In[1]:= EntityClass["Country", "GroupOf7"]//EntityList Out[1]= {Entity["Country", "Canada"], Entity["Country", "France"], Entity["Country", "Germany"], Entity["Country", "Italy"], Entity["Country", "Japan"], Entity["Country", "UnitedKingdom"], Entity["Country", "UnitedStates"]} ``` --- Find the GDPs of members of the G7: ```wl In[1]:= EntityClass["Country", "GroupOf7"]["GDP", "EntityAssociation"] Out[1]= <|Entity["Country", "Canada"] -> Quantity[1.65304279525504*^12, "USDollars"/"Years"], Entity["Country", "France"] -> Quantity[2.58250130721642*^12, "USDollars"/"Years"], Entity["Country", "Germany"] -> Quantity[3.6774391297766*^12, "USDollars"/"Yea ... untry", "Japan"] -> Quantity[4.87213694550759*^12, "USDollars"/"Years"], Entity["Country", "UnitedKingdom"] -> Quantity[2.62243395960416*^12, "USDollars"/"Years"], Entity["Country", "UnitedStates"] -> Quantity[1.9390604*^13, "USDollars"/"Years"]|> ``` --- Logarithmic rank plot of populations of all countries: ```wl In[1]:= ListLogPlot[Reverse[Sort[EntityValue["Country", "Population"]]]] Out[1]= [image] ``` --- A log-log scatter plot of GDP against population for all countries, with tooltips for country names: ```wl In[1]:= ListLogLogPlot[Tooltip[#[[1 ;; 2]], #[[3]]]& /@ EntityValue["Country", {"GDP", "Population", "Name"}]] Out[1]= [image] ``` --- Find the GDP of France in 1970: ```wl In[1]:= Entity["Country", "France"][Dated["GDP", 1970]] Out[1]= Quantity[1.469269989370497*^11, "USDollars"/"Years"] ``` Plot the GDP of France from 1970 to 2005: ```wl In[2]:= DateListPlot[Entity["Country", "France"][EntityProperty["Country", "GDP", {"CurrencyUnit" -> "CurrentUSDollar", "Date" -> Interval[{DateObject[{1970}], DateObject[{2005}]}]}]]] Out[2]= [image] ``` --- Basic iconic shape of France: ```wl In[1]:= Entity["Country", "France"]["Shape"] Out[1]= [image] ``` --- Generate a world map using a Mollweide projection: ```wl In[1]:= GeoGraphics[{EdgeForm[Black], Polygon@EntityList["Country"]}, GeoProjection -> "Mollweide"] Out[1]= [image] ``` --- Find the list of all ordinary countries and dependencies: ```wl In[1]:= EntityList["Country"]//Short Out[1]//Short= {Entity["Country", "Afghanistan"], Entity["Country", "AlandIslands"], Entity["Country", "Albania"], Entity["Country", "Algeria"], Entity["Country", "AmericanSamoa"], Entity["Country", "Andorra"], Entity["Country", "Angola"], Entity["Country", "Angu ... ty["Country", "Venezuela"], Entity["Country", "Vietnam"], Entity["Country", "WallisFutuna"], Entity["Country", "WestBank"], Entity["Country", "WesternSahara"], Entity["Country", "Yemen"], Entity["Country", "Zambia"], Entity["Country", "Zimbabwe"]} ``` --- Find the countries in South America: ```wl In[1]:= EntityClass["Country", "Continent" -> "SouthAmerica"]//EntityList Out[1]= {Entity["Country", "Argentina"], Entity["Country", "Bolivia"], Entity["Country", "Brazil"], Entity["Country", "Chile"], Entity["Country", "Colombia"], Entity["Country", "Ecuador"], Entity["Country", "FalklandIslands"], Entity["Country", "FrenchGuiana"], Entity["Country", "Guyana"], Entity["Country", "Paraguay"], Entity["Country", "Peru"], Entity["Country", "Suriname"], Entity["Country", "Uruguay"], Entity["Country", "Venezuela"]} ``` --- Find all supported country groups: ```wl In[1]:= EntityValue["Country", "EntityClasses"]//Shallow Out[1]//Shallow= {EntityClass["Country", "Africa"], EntityClass["Country", "AfricanCaribbeanAndPacificGroup"], EntityClass["Country", "AfricanDevelopmentBank"], EntityClass["Country", "AfricanUnion"], EntityClass["Country", "AgencyForTheProhibitionOfNuclearWeaponsI ... lass["Country", "AgencyOfCulturalAndTechnicalCooperation"], EntityClass["Country", "AllianceOfSmallIslandStates"], EntityClass["Country", "Americas"], EntityClass["Country", "AndeanCommunityOfNations"], EntityClass["Country", "Antarctica"], «327»} ``` --- Find members of the East African Community: ```wl In[1]:= EntityClass["Country", "EastAfricanCommunity"]//EntityList Out[1]= {Entity["Country", "Burundi"], Entity["Country", "Kenya"], Entity["Country", "Rwanda"], Entity["Country", "SouthSudan"], Entity["Country", "Tanzania"], Entity["Country", "Uganda"]} ``` --- Find the number of members in the United Nations: ```wl In[1]:= Length[EntityClass["Country", "UnitedNations"]//EntityList] Out[1]= 193 ``` --- Find countries that are in the United Nations but not the Universal Postal Union: ```wl In[1]:= Complement[EntityClass["Country", "UnitedNations"]//EntityList, EntityClass["Country", "UniversalPostalUnion"]//EntityList] Out[1]= {Entity["Country", "Andorra"], Entity["Country", "MarshallIslands"], Entity["Country", "Micronesia"], Entity["Country", "Palau"]} ``` --- Find the populations of all countries in the G7: ```wl In[1]:= EntityClass["Country", "GroupOf7"]["Population", "EntityAssociation"] Out[1]= <|Entity["Country", "Canada"] -> Quantity[39299105, "People"], Entity["Country", "France"] -> Quantity[66438822, "People"], Entity["Country", "Germany"] -> Quantity[84548231, "People"], Entity["Country", "Italy"] -> Quantity[59499453, "People"], Entity["Country", "Japan"] -> Quantity[124370947, "People"], Entity["Country", "UnitedKingdom"] -> Quantity[68682962, "People"], Entity["Country", "UnitedStates"] -> Quantity[343477335, "People"]|> ``` Find the total population: ```wl In[2]:= EntityClass["Country", "GroupOf7"]["Population", Total] Out[2]= Quantity[786316855, "People"] ``` --- Names for the United States: ```wl In[1]:= Entity["Country", "UnitedStates"][{"Name", "FullName", "AlternateNames"}, "PropertyAssociation"] Out[1]= <|"Name" -> "United States", "FullName" -> "United States of America", "AlternateNames" -> {"United States of America", "America", "US", "USA", "U.S.", "U.S.A."}|> ``` --- The name for Germany in German: ```wl In[1]:= Entity["Country", "Germany"]["NativeNames"] Out[1]= {"Deutschland"} ``` #### Geo Computation (6) The basic shape of Australia: ```wl In[1]:= Entity["Country", "Australia"]["Shape"] Out[1]= [image] ``` --- Generate a polygon boundary for Australia: ```wl In[1]:= Graphics[{Gray, Entity["Country", "Australia"]["Polygon"]}] Out[1]= [image] ``` The "schematic boundary" has a lower resolution: ```wl In[2]:= Graphics[{Gray, Entity["Country", "Australia"]["SchematicPolygon"]}] Out[2]= [image] ``` --- Combine the polygons for all countries in South America: ```wl In[1]:= GeoGraphics[{EdgeForm[Black], Polygon@EntityClass["Country", "SouthAmerica"]}] Out[1]= [image] ``` --- Show countries in South America colored by their arable land fractions: ```wl In[1]:= GeoRegionValuePlot[EntityClass["Country", "SouthAmerica"] -> "ArableLandFraction", GeoBackground -> None] Out[1]= [image] ``` --- In the default projection for polygons, the coordinates are literal longitude, latitude values: ```wl In[1]:= Graphics[{Gray, Entity["Country", "UnitedStates"]["Polygon"]}, Frame -> True] Out[1]= [image] ``` --- Show all countries in schematic form: ```wl In[1]:= Graphics[{Gray, EntityValue["Country", "SchematicPolygon"]}] Out[1]= [image] ``` ## See Also * [`AdministrativeDivision`](https://reference.wolfram.com/language/ref/entity/AdministrativeDivision.en.md) * [`City`](https://reference.wolfram.com/language/ref/entity/City.en.md) * [`Neighborhood`](https://reference.wolfram.com/language/ref/entity/Neighborhood.en.md) * [`MetropolitanArea`](https://reference.wolfram.com/language/ref/entity/MetropolitanArea.en.md) * [`GivenName`](https://reference.wolfram.com/language/ref/entity/GivenName.en.md) * [`Surname`](https://reference.wolfram.com/language/ref/entity/Surname.en.md) * [`PersonTitle`](https://reference.wolfram.com/language/ref/entity/PersonTitle.en.md) * [`Religion`](https://reference.wolfram.com/language/ref/entity/Religion.en.md) * [`Country`](https://reference.wolfram.com/language/ref/interpreter/Country.en.md) * [`CountryClass`](https://reference.wolfram.com/language/ref/interpreter/CountryClass.en.md) * [`ComputedCountry`](https://reference.wolfram.com/language/ref/interpreter/ComputedCountry.en.md) * [`Country`](https://reference.wolfram.com/language/ref/textcontent/Country.en.md) ## Related Guides * [Entity Types](https://reference.wolfram.com/language/guide/EntityTypes.en.md) ## History * [Introduced in 2019 (12.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn120.en.md)