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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| Normalize an address | Turn an address as written ('Av. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
- Latitude
latitudenumberRequired - The point's latitude in degrees, such as -34.6037.From -90 to 90.
- Longitude
longitudenumberRequired - 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
- Points
pointstextRequired - 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 place
place_kindtextRequired - What the code is for.One of:
province,department,municipality,census_locality(Census locality),locality,settlement,street. - Code
codetextRequired - 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
- Name
nametext - 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 only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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
- Address
addresstextRequired - 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.
- Province
provincetext - 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.
- Department
departmenttext - 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 locality
census_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.
- Locality
localitytext - Only addresses in this locality (a town or neighbourhood). Pick one once a province is chosen, or type its name or code.
- Limit
limitnumber - 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
- Addresses
addressestextRequired - 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.
- Province
provincetext - 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.
- Department
departmenttext - 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 locality
census_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.
- Locality
localitytext - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department
departmenttext - 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.
- Municipality
municipalitytext - 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 only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Exact name only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department
departmenttext - 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.
- Municipality
municipalitytext - 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 locality
census_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 only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Exact name only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department
departmenttext - 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.
- Municipality
municipalitytext - 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 locality
census_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 only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Name
nametext - Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Street type
street_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). - Province
provincetext - Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department
departmenttext - 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 locality
census_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 only
exact_nametrue/false - Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words.Default:
false. - Codes
idstext - 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.
- Details
detailslist - 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. - Order
ordertext - 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). - Limit
limitnumber - How many results to return, up to 5,000.From 1 to 5000. Default:
100. - Skip
offsetnumber - 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
- Names
namestextRequired - Up to 1,000 names, one per line, or a list from an earlier step.
- Kind of place
place_kindtextRequired - What the names are names of.One of:
province,department,municipality,census_locality(Census locality),locality,settlement. - Province
provincetext - 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
}
]
}