Georef Argentina

App · 13 actions

Look up Argentina's official geography in Georef, the national government's reference service on datos.gob.ar. Search provinces, departments, municipalities, localities and streets with their official codes and centre points, turn a written address into its official form with coordinates, find the province, department and municipality of a point, and match place names as people write them, such as 'Bs As', to their official names, one at a time or a thousand at once. No account or API key required.

Actions

ActionWhat it does
Find where a point isFind the province, department and municipality a latitude and longitude in Argentina lie in, with their official codes, to add them to data that has coordinates.
Find where several points areFind the province, department and municipality of up to 1,000 latitude and longitude points in one step, such as a column of coordinates from a spreadsheet, in the order given.
Get a place by its codeGet one province, department, municipality, census locality, locality, settlement or street by its official code, such as the INDEC codes in a public dataset: its name, category, the places it is in and its centre point.
List provincesList Argentina's 23 provinces and the City of Buenos Aires, or those matching a name however it is written ('Bs As', 'Sgo.
Normalize an addressTurn an address as written ('Av.
Normalize several addressesNormalize up to 1,000 addresses in one step, such as a column from a spreadsheet: each comes back in its official form with its coordinates, street code, department and province, in the order given, and the ones Georef could not match are listed.
Search census localitiesFind the towns and cities the national census (INDEC) counts, by name or by the province, department or municipality they are in, with each one's official code, category, the places it is in and its centre point.
Search departmentsFind Argentina's departments, the divisions of each province (called partidos in Buenos Aires province and comunas in the City of Buenos Aires), by name or province, with each one's official code, category, province and centre point.
Search localitiesFind Argentina's localities, the towns, cities and neighbourhoods people name, by name or by the province, department, municipality or census locality they are in, with each one's official code, the places it is in and its centre point.
Search municipalitiesFind Argentina's municipalities, its local governments (a municipio, or a comuna, junta or comisión in some provinces), by name or province, with each one's official code, category, province and centre point.
Search settlementsFind every named settlement in Argentina: the localities plus rural places (parajes), built up sites and Antarctic bases, by name or by the places they are in, with each one's official code, category, the places it is in and its centre point.
Search streetsFind streets in Argentina by name, type (avenue, passage, route and so on) and the province, department or census locality they are in, with each one's official code, the range of its house numbers on each side, and the places it is in.
Standardize place namesMatch up to 1,000 place names as people write them ('Bs As', 'Cba', 'Capital Federal') to the official name and code of a province, department, municipality or locality, in the order given, with how many places each name could mean.

Find where a point is

Find the province, department and municipality a latitude and longitude in Argentina lie in, with their official codes, to add them to data that has coordinates. 'Found' is false for a point outside Argentina.

Inputs

LatitudelatitudenumberRequired
The point's latitude in degrees, such as -34.6037.From -90 to 90.
LongitudelongitudenumberRequired
The point's longitude in degrees, such as -58.3816.From -180 to 180.

Outputs

department_idtext
The code of the department the point is in.
department_nametext
The name of the department the point is in.
foundtrue/false
True when the point is in Argentina; false for a point outside it, or for a row of a list that had no coordinates.
latitudenumber
The point's latitude, in degrees. Blank for a row of a list that had no coordinates.
longitudenumber
The point's longitude, in degrees. Blank for a row of a list that had no coordinates.
municipality_idtext
The code of the municipality the point is in. Blank in rural land no municipality governs.
municipality_nametext
The name of the municipality the point is in.
province_idtext
The code of the province the point is in.
province_nametext
The name of the province the point is in.
Example output
{
  "department_id": "02007",
  "department_name": "Comuna 1",
  "found": true,
  "latitude": -34.6037,
  "longitude": -58.3816,
  "municipality_id": "022007",
  "municipality_name": "Comuna 1",
  "province_id": "02",
  "province_name": "Ciudad Aut\u00f3noma de Buenos Aires"
}

Find where several points are

Find the province, department and municipality of up to 1,000 latitude and longitude points in one step, such as a column of coordinates from a spreadsheet, in the order given.

Inputs

PointspointstextRequired
Up to 1,000 points, one per line as latitude, longitude, or a list from an earlier step of pairs or of records with a latitude and longitude. A record with none, such as an address that wasn't matched, comes back not located.

Outputs

countnumber
How many points were given.
located_countnumber
How many of them are in Argentina.
not_located_countnumber
How many of them are outside Argentina or had no coordinates.
resultslist
One row per point, in the order given. A row with no coordinates keeps its place, not located.
Example output
{
  "count": 3,
  "located_count": 2,
  "not_located_count": 1,
  "results": [
    {
      "department_id": "02007",
      "department_name": "Comuna 1",
      "found": true,
      "latitude": -34.6037,
      "longitude": -58.3816,
      "municipality_id": "022007",
      "municipality_name": "Comuna 1",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires"
    },
    {
      "department_id": "10035",
      "department_name": "Bel\u00e9n",
      "found": true,
      "latitude": -27.2741,
      "longitude": -66.7529,
      "municipality_id": "100077",
      "municipality_name": "Hualfin",
      "province_id": "10",
      "province_name": "Catamarca"
    },
    {
      "department_id": null,
      "department_name": null,
      "found": false,
      "latitude": 0.0,
      "longitude": 0.0,
      "municipality_id": null,
      "municipality_name": null,
      "province_id": null,
      "province_name": null
    }
  ]
}

Get a place by its code

Get one province, department, municipality, census locality, locality, settlement or street by its official code, such as the INDEC codes in a public dataset: its name, category, the places it is in and its centre point. 'Found' is false when no place of that kind has the code.

Inputs

Kind of placeplace_kindtextRequired
What the code is for.One of: province, department, municipality, census_locality (Census locality), locality, settlement, street.
CodecodetextRequired
The official code: 2 digits for a province, 5 for a department, 6 for a municipality, 8 for a census locality, 8 or 10 for a locality or settlement, 13 for a street. A code that lost its leading zero in a spreadsheet works too.

Outputs

categorytext
The kind of place as Georef writes it: Provincia; Departamento, Partido or Comuna for a department; Municipio, Comuna, Junta or Comisión for a municipality; Localidad simple, Entidad, Paraje and so on for a locality; a street type code such as CALLE or AV.
census_locality_idtext
The code of the census locality it is in.
census_locality_nametext
The name of the census locality it is in.
department_idtext
The code of the department it is in.
department_nametext
The name of the department it is in.
first_number_leftnumber
A street's first house number on the left.
first_number_rightnumber
A street's first house number on the right.
foundtrue/false
True when Georef has a place of this kind with the code.
full_nametext
The name with its kind, such as 'Partido de La Plata'; for a street, its name with its department and province.
functiontext
What a census locality is the seat of: the capital of the country, of its province or the seat of its department. Blank when none.
idtext
The official code (INDEC's), such as 06441.
iso_codetext
A province's ISO 3166-2 code, such as AR-B.
iso_nametext
A province's name in ISO 3166-2.
last_number_leftnumber
A street's last house number on the left.
last_number_rightnumber
A street's last house number on the right.
latitudenumber
The latitude of its centre point, in degrees.
longitudenumber
The longitude of its centre point, in degrees.
municipality_idtext
The code of the municipality it is in.
municipality_nametext
The name of the municipality it is in.
nametext
The official name.
place_kindtext
The kind of place looked up: province, department, municipality, census_locality, locality, settlement or street.
province_idtext
The code of the province it is in.
province_nametext
The name of the province it is in.
sourcetext
Where the record comes from, such as IGN (the national geographic institute) or INDEC (the national statistics institute).
street_typetext
A street's type in English, such as Avenue.
Example output
{
  "category": "Partido",
  "census_locality_id": null,
  "census_locality_name": null,
  "department_id": null,
  "department_name": null,
  "first_number_left": null,
  "first_number_right": null,
  "found": true,
  "full_name": "Partido de La Plata",
  "function": null,
  "id": "06441",
  "iso_code": null,
  "iso_name": null,
  "last_number_left": null,
  "last_number_right": null,
  "latitude": -35.0038470156345,
  "longitude": -58.0177777886077,
  "municipality_id": null,
  "municipality_name": null,
  "name": "La Plata",
  "place_kind": "department",
  "province_id": "06",
  "province_name": "Buenos Aires",
  "source": "IGN",
  "street_type": null
}

List provinces

List Argentina's 23 provinces and the City of Buenos Aires, or those matching a name however it is written ('Bs As', 'Sgo. del Estero'), with each one's official code, ISO 3166-2 code, full name and centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: full_name (Full name), iso_code (ISO 3166-2 code), category, centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).

Outputs

countnumber
How many provinces this step returned.
provinceslist
The provinces. A detail left out of 'Details' is blank.
totalnumber
How many provinces match in all.
Example output
{
  "count": 2,
  "provinces": [
    {
      "category": "Provincia",
      "full_name": "Provincia de Buenos Aires",
      "id": "06",
      "iso_code": "AR-B",
      "iso_name": "Buenos Aires",
      "latitude": -36.6773920760823,
      "longitude": -60.5584771084959,
      "name": "Buenos Aires",
      "source": "IGN"
    },
    {
      "category": "Ciudad Aut\u00f3noma",
      "full_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "id": "02",
      "iso_code": "AR-C",
      "iso_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "latitude": -34.6144420654301,
      "longitude": -58.4458763250916,
      "name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "IGN"
    }
  ],
  "total": 2
}

Normalize an address

Turn an address as written ('Av. Corrientes 1234', 'Corrientes y Callao') into its official form, with the street's code, the floor, the cross streets, the department and province, and its latitude and longitude, best match first. 'Found' is false when no street matches.

Inputs

AddressaddresstextRequired
The street and house number, a corner (Corrientes y Callao) or a block between two streets (Mitre entre Belgrano y Moreno), with a floor or flat if any. Leave the town out: Georef ignores it, so put it in the fields that follow.
Provinceprovincetext
The province the address is in, or the City of Buenos Aires. Narrows the match a great deal: most street names repeat across the country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Census localitycensus_localitytext
Only places in this census locality, a town or city as the national census (INDEC) draws it. Pick one once a province is chosen, or type its name or eight-digit code.
Localitylocalitytext
Only addresses in this locality (a town or neighbourhood). Pick one once a province is chosen, or type its name or code.
Limitlimitnumber
How many candidate matches to return, best first.From 1 to 5000. Default: 10.

Outputs

census_locality_idtext
The code of the census locality it is in.
census_locality_nametext
The name of the census locality it is in.
countnumber
How many candidate matches this step returned.
cross_street_1_idtext
The code of the first cross street, if any.
cross_street_1_nametext
The name of the first cross street, if any.
cross_street_2_idtext
The code of the second cross street, if any.
cross_street_2_nametext
The name of the second cross street, if any.
department_idtext
The code of the department the street is in.
department_nametext
The name of the department the street is in.
floortext
The floor or flat read from the address, such as 2 C.
foundtrue/false
True when Georef matched the address to a street.
house_numbernumber
The house number read from the address.
house_number_unittext
What came before the number, such as nro or km. Blank when nothing did.
inputtext
The address as given.
latitudenumber
The address's estimated latitude, in degrees. Blank when Georef has too little data there to place it.
longitudenumber
The address's estimated longitude, in degrees.
matched_addresstext
The address in its official form, with its department and province, such as 'AV CORRIENTES 1234, Comuna 1, Ciudad Autónoma de Buenos Aires'.
matcheslist
Every candidate match, best first. The fields beside this list are the first one's.
parsed_astext
How Georef read the address: 'Street and number', 'Corner of two streets' or 'Between two streets'.
province_idtext
The code of the province the street is in.
province_nametext
The name of the province the street is in.
sourcetext
Where the street data comes from, such as INDEC.
street_categorytext
The street's type as Georef writes it, such as AV.
street_idtext
The street's official code.
street_nametext
The street's official name.
street_typetext
The street's type in English, such as Avenue.
totalnumber
How many candidate matches Georef found in all.
Example output
{
  "census_locality_id": "02000010",
  "census_locality_name": "Ciudad Aut\u00f3noma de Buenos Aires",
  "count": 1,
  "cross_street_1_id": null,
  "cross_street_1_name": null,
  "cross_street_2_id": null,
  "cross_street_2_name": null,
  "department_id": "02007",
  "department_name": "Comuna 1",
  "floor": null,
  "found": true,
  "house_number": 1234,
  "house_number_unit": null,
  "input": "Av. Corrientes 1234",
  "latitude": -34.60385632930893,
  "longitude": -58.38419018127011,
  "matched_address": "AV CORRIENTES 1234, Comuna 1, Ciudad Aut\u00f3noma de Buenos Aires",
  "matches": [
    {
      "census_locality_id": "02000010",
      "census_locality_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "cross_street_1_id": null,
      "cross_street_1_name": null,
      "cross_street_2_id": null,
      "cross_street_2_name": null,
      "department_id": "02007",
      "department_name": "Comuna 1",
      "floor": null,
      "house_number": 1234,
      "house_number_unit": null,
      "latitude": -34.60385632930893,
      "longitude": -58.38419018127011,
      "matched_address": "AV CORRIENTES 1234, Comuna 1, Ciudad Aut\u00f3noma de Buenos Aires",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "INDEC",
      "street_category": "AV",
      "street_id": "0200701001185",
      "street_name": "AV CORRIENTES",
      "street_type": "Avenue"
    }
  ],
  "parsed_as": "Street and number",
  "province_id": "02",
  "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
  "source": "INDEC",
  "street_category": "AV",
  "street_id": "0200701001185",
  "street_name": "AV CORRIENTES",
  "street_type": "Avenue",
  "total": 1
}

Normalize several addresses

Normalize up to 1,000 addresses in one step, such as a column from a spreadsheet: each comes back in its official form with its coordinates, street code, department and province, in the order given, and the ones Georef could not match are listed.

Inputs

AddressesaddressestextRequired
Up to 1,000 addresses, one per line, or a list from an earlier step. The street and number only: the fields that follow narrow every one of them.
Provinceprovincetext
The province the address is in, or the City of Buenos Aires. Narrows the match a great deal: most street names repeat across the country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Census localitycensus_localitytext
Only places in this census locality, a town or city as the national census (INDEC) draws it. Pick one once a province is chosen, or type its name or eight-digit code.
Localitylocalitytext
Only addresses in this locality (a town or neighbourhood). Pick one once a province is chosen, or type its name or code.

Outputs

countnumber
How many addresses were given, blank rows included.
matched_countnumber
How many of them Georef matched.
not_foundlist
The addresses Georef could not match, as given.
resultslist
One row per address, in the order given, with its best match. A blank row of a list keeps its place, unmatched.
Example output
{
  "count": 3,
  "matched_count": 2,
  "not_found": [
    "Calle Inventada 99999"
  ],
  "results": [
    {
      "census_locality_id": "02000010",
      "census_locality_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "cross_street_1_id": null,
      "cross_street_1_name": null,
      "cross_street_2_id": null,
      "cross_street_2_name": null,
      "department_id": "02007",
      "department_name": "Comuna 1",
      "floor": null,
      "found": true,
      "house_number": 1234,
      "house_number_unit": null,
      "input": "Av. Corrientes 1234",
      "latitude": -34.60385632930893,
      "longitude": -58.38419018127011,
      "matched_address": "AV CORRIENTES 1234, Comuna 1, Ciudad Aut\u00f3noma de Buenos Aires",
      "parsed_as": "Street and number",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "INDEC",
      "street_category": "AV",
      "street_id": "0200701001185",
      "street_name": "AV CORRIENTES",
      "street_type": "Avenue"
    },
    {
      "census_locality_id": "14014010",
      "census_locality_name": "C\u00f3rdoba",
      "cross_street_1_id": "1401401038100",
      "cross_street_1_name": "SANTA ROSA",
      "cross_street_2_id": "1401401002060",
      "cross_street_2_name": "AV COLON",
      "department_id": "14014",
      "department_name": "Capital",
      "floor": "2ndo C",
      "found": true,
      "house_number": 260,
      "house_number_unit": "nro",
      "input": "Av. Santa Fe nro 260 2ndo C, entre Santa Rosa y Col\u00f3n",
      "latitude": -31.407777884610205,
      "longitude": -64.20051568364364,
      "matched_address": "AV SANTA FE 260 (ENTRE SANTA ROSA Y AV COLON), Capital, C\u00f3rdoba",
      "parsed_as": "Between two streets",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "INDEC",
      "street_category": "AV",
      "street_id": "1401401002460",
      "street_name": "AV SANTA FE",
      "street_type": "Avenue"
    },
    {
      "census_locality_id": null,
      "census_locality_name": null,
      "cross_street_1_id": null,
      "cross_street_1_name": null,
      "cross_street_2_id": null,
      "cross_street_2_name": null,
      "department_id": null,
      "department_name": null,
      "floor": null,
      "found": false,
      "house_number": null,
      "house_number_unit": null,
      "input": "Calle Inventada 99999",
      "latitude": null,
      "longitude": null,
      "matched_address": null,
      "parsed_as": "Street and number",
      "province_id": null,
      "province_name": null,
      "source": null,
      "street_category": null,
      "street_id": null,
      "street_name": null,
      "street_type": null
    }
  ]
}

Search census localities

Find the towns and cities the national census (INDEC) counts, by name or by the province, department or municipality they are in, with each one's official code, category, the places it is in and its centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Municipalitymunicipalitytext
Only places in this municipality, the local government: a municipio, or a comuna, junta or comisión in some provinces. Pick one once a province is chosen, or type its name or six-digit code.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: category, function (Role (capital or seat)), province, department, municipality, centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

census_localitieslist
The census localities. A detail left out of 'Details' is blank.
countnumber
How many census localities this step returned.
totalnumber
How many census localities match in all.
Example output
{
  "census_localities": [
    {
      "category": "Componente de localidad compuesta",
      "department_id": "82084",
      "department_name": "Rosario",
      "function": null,
      "id": "82084270",
      "latitude": -32.9470419146466,
      "longitude": -60.6332161913325,
      "municipality_id": "820210",
      "municipality_name": "Rosario",
      "name": "Rosario",
      "province_id": "82",
      "province_name": "Santa Fe",
      "source": "INDEC"
    }
  ],
  "count": 1,
  "total": 1
}

Search departments

Find Argentina's departments, the divisions of each province (called partidos in Buenos Aires province and comunas in the City of Buenos Aires), by name or province, with each one's official code, category, province and centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: full_name (Full name), category (Category (departamento, partido or comuna)), province, centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

countnumber
How many departments this step returned.
departmentslist
The departments. A detail left out of 'Details' is blank.
totalnumber
How many departments match in all.
Example output
{
  "count": 2,
  "departments": [
    {
      "category": "Partido",
      "full_name": "Partido de La Plata",
      "id": "06441",
      "latitude": -35.0038470156345,
      "longitude": -58.0177777886077,
      "name": "La Plata",
      "province_id": "06",
      "province_name": "Buenos Aires",
      "source": "IGN"
    },
    {
      "category": "Comuna",
      "full_name": "Comuna 1",
      "id": "02007",
      "latitude": -34.6064435423382,
      "longitude": -58.3715117424742,
      "name": "Comuna 1",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "IGN"
    }
  ],
  "total": 2
}

Search localities

Find Argentina's localities, the towns, cities and neighbourhoods people name, by name or by the province, department, municipality or census locality they are in, with each one's official code, the places it is in and its centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Municipalitymunicipalitytext
Only places in this municipality, the local government: a municipio, or a comuna, junta or comisión in some provinces. Pick one once a province is chosen, or type its name or six-digit code.
Census localitycensus_localitytext
Only places in this census locality, a town or city as the national census (INDEC) draws it. Pick one once a province is chosen, or type its name or eight-digit code.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: category, province, department, municipality, census_locality (Census locality), centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

countnumber
How many localities this step returned.
localitieslist
The localities. A detail left out of 'Details' is blank.
totalnumber
How many localities match in all.
Example output
{
  "count": 2,
  "localities": [
    {
      "category": "Componente de localidad compuesta",
      "census_locality_id": "14014010",
      "census_locality_name": "C\u00f3rdoba",
      "department_id": "14014",
      "department_name": "Capital",
      "id": "14014010",
      "latitude": -31.416804474519,
      "longitude": -64.1836065316143,
      "municipality_id": "140077",
      "municipality_name": "C\u00f3rdoba",
      "name": "C\u00f3rdoba",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "INDEC"
    },
    {
      "category": "Entidad",
      "census_locality_id": "14014010",
      "census_locality_name": "C\u00f3rdoba",
      "department_id": "14014",
      "department_name": "Capital",
      "id": "1401401001",
      "latitude": -31.3685851015486,
      "longitude": -64.0605223114939,
      "municipality_id": "140077",
      "municipality_name": "C\u00f3rdoba",
      "name": "Jard\u00edn Arenales",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "INDEC"
    }
  ],
  "total": 5
}

Search municipalities

Find Argentina's municipalities, its local governments (a municipio, or a comuna, junta or comisión in some provinces), by name or province, with each one's official code, category, province and centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: full_name (Full name), category (Category (municipio, comuna, junta or comisión)), province, centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

countnumber
How many municipalities this step returned.
municipalitieslist
The municipalities. A detail left out of 'Details' is blank.
totalnumber
How many municipalities match in all.
Example output
{
  "count": 1,
  "municipalities": [
    {
      "category": "Municipio",
      "full_name": "Municipio C\u00f3rdoba",
      "id": "140077",
      "latitude": -31.4170520006004,
      "longitude": -64.1832233454368,
      "name": "C\u00f3rdoba",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "IGN"
    }
  ],
  "total": 1
}

Search settlements

Find every named settlement in Argentina: the localities plus rural places (parajes), built up sites and Antarctic bases, by name or by the places they are in, with each one's official code, category, the places it is in and its centre point.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Municipalitymunicipalitytext
Only places in this municipality, the local government: a municipio, or a comuna, junta or comisión in some provinces. Pick one once a province is chosen, or type its name or six-digit code.
Census localitycensus_localitytext
Only places in this census locality, a town or city as the national census (INDEC) draws it. Pick one once a province is chosen, or type its name or eight-digit code.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: category, province, department, municipality, census_locality (Census locality), centre (Centre point), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

countnumber
How many settlements this step returned.
settlementslist
The settlements. A detail left out of 'Details' is blank.
totalnumber
How many settlements match in all.
Example output
{
  "count": 2,
  "settlements": [
    {
      "category": "Componente de localidad compuesta",
      "census_locality_id": "14014010",
      "census_locality_name": "C\u00f3rdoba",
      "department_id": "14014",
      "department_name": "Capital",
      "id": "14014010",
      "latitude": -31.416804474519,
      "longitude": -64.1836065316143,
      "municipality_id": "140077",
      "municipality_name": "C\u00f3rdoba",
      "name": "C\u00f3rdoba",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "INDEC"
    },
    {
      "category": "Paraje",
      "census_locality_id": null,
      "census_locality_name": null,
      "department_id": "14014",
      "department_name": "Capital",
      "id": "14014A00",
      "latitude": -31.3224071303153,
      "longitude": -64.1182670556104,
      "municipality_id": "140077",
      "municipality_name": "C\u00f3rdoba",
      "name": "El Gateado",
      "province_id": "14",
      "province_name": "C\u00f3rdoba",
      "source": "INDEC. ACA"
    }
  ],
  "total": 7
}

Search streets

Find streets in Argentina by name, type (avenue, passage, route and so on) and the province, department or census locality they are in, with each one's official code, the range of its house numbers on each side, and the places it is in.

Inputs

Namenametext
Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
Street typestreet_typetext
Only streets of this type. Leave empty for every type.One of: CALLE (Street), AV (Avenue), BV (Boulevard), PJE (Passage), PEATONAL (Pedestrian street), PASILLO (Alley), SENDERO (Path), RUTA (Road or route), AUT (Motorway).
Provinceprovincetext
Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
Departmentdepartmenttext
Only places in this department, the division of a province: a partido in Buenos Aires province, a comuna in the City of Buenos Aires, a departamento elsewhere. Pick one once a province is chosen, or type its name or five-digit code.
Census localitycensus_localitytext
Only places in this census locality, a town or city as the national census (INDEC) draws it. Pick one once a province is chosen, or type its name or eight-digit code.
Exact name onlyexact_nametrue/false
Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default: false.
Codesidstext
Only these official codes, separated by commas, or a list from an earlier step. A code that lost its leading zero in a spreadsheet works too.
Detailsdetailslist
What to include besides each code and name. Leave empty for every detail; one left out comes back blank.One or more of: full_name (Name with its place), category (Street type), house_numbers (House numbers), province, department, census_locality (Census locality), source.
Orderordertext
How to sort the results. Left empty: best match first when a name is given, by code otherwise.One of: relevance (Best match first), name (By name), id (By code).
Limitlimitnumber
How many results to return, up to 5,000.From 1 to 5000. Default: 100.
Skipoffsetnumber
How many results to skip, to read the next page. Georef pages through the first 10,000 matches. Sort by code when paging: places that share a name can repeat or go missing between pages sorted by name.From 0 to 9999. Default: 0.

Outputs

countnumber
How many streets this step returned.
streetslist
The streets. A detail left out of 'Details' is blank.
totalnumber
How many streets match in all.
Example output
{
  "count": 2,
  "streets": [
    {
      "category": "AV",
      "census_locality_id": "02000010",
      "census_locality_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "department_id": "02007",
      "department_name": "Comuna 1",
      "first_number_left": 0,
      "first_number_right": 0,
      "full_name": "AV CORRIENTES, Comuna 1, Ciudad Aut\u00f3noma de Buenos Aires",
      "id": "0200701001185",
      "last_number_left": 1800,
      "last_number_right": 1799,
      "name": "AV CORRIENTES",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "INDEC",
      "street_type": "Avenue"
    },
    {
      "category": "AV",
      "census_locality_id": "02000010",
      "census_locality_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "department_id": "02021",
      "department_name": "Comuna 3",
      "first_number_left": 1802,
      "first_number_right": 1801,
      "full_name": "AV CORRIENTES, Comuna 3, Ciudad Aut\u00f3noma de Buenos Aires",
      "id": "0202101001185",
      "last_number_left": 3400,
      "last_number_right": 3399,
      "name": "AV CORRIENTES",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "source": "INDEC",
      "street_type": "Avenue"
    }
  ],
  "total": 4
}

Standardize place names

Match up to 1,000 place names as people write them ('Bs As', 'Cba', 'Capital Federal') to the official name and code of a province, department, municipality or locality, in the order given, with how many places each name could mean.

Inputs

NamesnamestextRequired
Up to 1,000 names, one per line, or a list from an earlier step.
Kind of placeplace_kindtextRequired
What the names are names of.One of: province, department, municipality, census_locality (Census locality), locality, settlement.
Provinceprovincetext
Only match places in this province, for names many provinces share. Not used when the names are provinces.

Outputs

countnumber
How many names were given, blank rows included.
matched_countnumber
How many of them Georef matched.
not_foundlist
The names Georef could not match, as given.
place_kindtext
The kind of place the names were matched to.
resultslist
One row per name, in the order given, with its best match. A blank row of a list keeps its place, unmatched.
Example output
{
  "count": 4,
  "matched_count": 3,
  "not_found": [
    "Montevideo"
  ],
  "place_kind": "province",
  "results": [
    {
      "found": true,
      "id": "06",
      "input": "Bs As",
      "match_count": 1,
      "name": "Buenos Aires",
      "province_id": "06",
      "province_name": "Buenos Aires"
    },
    {
      "found": true,
      "id": "86",
      "input": "Sgo. del Estero",
      "match_count": 1,
      "name": "Santiago del Estero",
      "province_id": "86",
      "province_name": "Santiago del Estero"
    },
    {
      "found": true,
      "id": "02",
      "input": "CABA",
      "match_count": 1,
      "name": "Ciudad Aut\u00f3noma de Buenos Aires",
      "province_id": "02",
      "province_name": "Ciudad Aut\u00f3noma de Buenos Aires"
    },
    {
      "found": false,
      "id": null,
      "input": "Montevideo",
      "match_count": 0,
      "name": null,
      "province_id": null,
      "province_name": null
    }
  ]
}

On this page