# Georef Argentina

> 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.

App · 13 actions. Web page: https://docs.lodol.com/docs/integrations/georef-argentina

## Actions

### 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 (`latitude`, number, required): The point's latitude in degrees, such as -34.6037. From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude in degrees, such as -58.3816. From -180 to 180.

**Outputs**

- `department_id` (text): The code of the department the point is in.
- `department_name` (text): The name of the department the point is in.
- `found` (true/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.
- `latitude` (number): The point's latitude, in degrees. Blank for a row of a list that had no coordinates.
- `longitude` (number): The point's longitude, in degrees. Blank for a row of a list that had no coordinates.
- `municipality_id` (text): The code of the municipality the point is in. Blank in rural land no municipality governs.
- `municipality_name` (text): The name of the municipality the point is in.
- `province_id` (text): The code of the province the point is in.
- `province_name` (text): The name of the province the point is in.

**Example output**

```json
{
  "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 (`points`, text, required): 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**

- `count` (number): How many points were given.
- `located_count` (number): How many of them are in Argentina.
- `not_located_count` (number): How many of them are outside Argentina or had no coordinates.
- `results` (list): One row per point, in the order given. A row with no coordinates keeps its place, not located.

**Example output**

```json
{
  "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_kind`, text, required): What the code is for. One of: `province`, `department`, `municipality`, `census_locality` (Census locality), `locality`, `settlement`, `street`.
- Code (`code`, text, required): 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**

- `category` (text): 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_id` (text): The code of the census locality it is in.
- `census_locality_name` (text): The name of the census locality it is in.
- `department_id` (text): The code of the department it is in.
- `department_name` (text): The name of the department it is in.
- `first_number_left` (number): A street's first house number on the left.
- `first_number_right` (number): A street's first house number on the right.
- `found` (true/false): True when Georef has a place of this kind with the code.
- `full_name` (text): The name with its kind, such as 'Partido de La Plata'; for a street, its name with its department and province.
- `function` (text): 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.
- `id` (text): The official code (INDEC's), such as 06441.
- `iso_code` (text): A province's ISO 3166-2 code, such as AR-B.
- `iso_name` (text): A province's name in ISO 3166-2.
- `last_number_left` (number): A street's last house number on the left.
- `last_number_right` (number): A street's last house number on the right.
- `latitude` (number): The latitude of its centre point, in degrees.
- `longitude` (number): The longitude of its centre point, in degrees.
- `municipality_id` (text): The code of the municipality it is in.
- `municipality_name` (text): The name of the municipality it is in.
- `name` (text): The official name.
- `place_kind` (text): The kind of place looked up: province, department, municipality, census_locality, locality, settlement or street.
- `province_id` (text): The code of the province it is in.
- `province_name` (text): The name of the province it is in.
- `source` (text): Where the record comes from, such as IGN (the national geographic institute) or INDEC (the national statistics institute).
- `street_type` (text): A street's type in English, such as Avenue.

**Example output**

```json
{
  "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 (`name`, text): 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_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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**

- `count` (number): How many provinces this step returned.
- `provinces` (list): The provinces. A detail left out of 'Details' is blank.
- `total` (number): How many provinces match in all.

**Example output**

```json
{
  "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 (`address`, text, required): 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 (`province`, text): 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 (`department`, text): 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_locality`, text): 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 (`locality`, text): Only addresses in this locality (a town or neighbourhood). Pick one once a province is chosen, or type its name or code.
- Limit (`limit`, number): How many candidate matches to return, best first. From 1 to 5000. Default: `10`.

**Outputs**

- `census_locality_id` (text): The code of the census locality it is in.
- `census_locality_name` (text): The name of the census locality it is in.
- `count` (number): How many candidate matches this step returned.
- `cross_street_1_id` (text): The code of the first cross street, if any.
- `cross_street_1_name` (text): The name of the first cross street, if any.
- `cross_street_2_id` (text): The code of the second cross street, if any.
- `cross_street_2_name` (text): The name of the second cross street, if any.
- `department_id` (text): The code of the department the street is in.
- `department_name` (text): The name of the department the street is in.
- `floor` (text): The floor or flat read from the address, such as 2 C.
- `found` (true/false): True when Georef matched the address to a street.
- `house_number` (number): The house number read from the address.
- `house_number_unit` (text): What came before the number, such as nro or km. Blank when nothing did.
- `input` (text): The address as given.
- `latitude` (number): The address's estimated latitude, in degrees. Blank when Georef has too little data there to place it.
- `longitude` (number): The address's estimated longitude, in degrees.
- `matched_address` (text): The address in its official form, with its department and province, such as 'AV CORRIENTES 1234, Comuna 1, Ciudad Autónoma de Buenos Aires'.
- `matches` (list): Every candidate match, best first. The fields beside this list are the first one's.
- `parsed_as` (text): How Georef read the address: 'Street and number', 'Corner of two streets' or 'Between two streets'.
- `province_id` (text): The code of the province the street is in.
- `province_name` (text): The name of the province the street is in.
- `source` (text): Where the street data comes from, such as INDEC.
- `street_category` (text): The street's type as Georef writes it, such as AV.
- `street_id` (text): The street's official code.
- `street_name` (text): The street's official name.
- `street_type` (text): The street's type in English, such as Avenue.
- `total` (number): How many candidate matches Georef found in all.

**Example output**

```json
{
  "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 (`addresses`, text, required): 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 (`province`, text): 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 (`department`, text): 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_locality`, text): 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 (`locality`, text): Only addresses in this locality (a town or neighbourhood). Pick one once a province is chosen, or type its name or code.

**Outputs**

- `count` (number): How many addresses were given, blank rows included.
- `matched_count` (number): How many of them Georef matched.
- `not_found` (list): The addresses Georef could not match, as given.
- `results` (list): One row per address, in the order given, with its best match. A blank row of a list keeps its place, unmatched.

**Example output**

```json
{
  "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 (`name`, text): Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department (`department`, text): 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 (`municipality`, text): 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_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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_localities` (list): The census localities. A detail left out of 'Details' is blank.
- `count` (number): How many census localities this step returned.
- `total` (number): How many census localities match in all.

**Example output**

```json
{
  "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 (`name`, text): Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Exact name only (`exact_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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**

- `count` (number): How many departments this step returned.
- `departments` (list): The departments. A detail left out of 'Details' is blank.
- `total` (number): How many departments match in all.

**Example output**

```json
{
  "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 (`name`, text): Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department (`department`, text): 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 (`municipality`, text): 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_locality`, text): 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_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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**

- `count` (number): How many localities this step returned.
- `localities` (list): The localities. A detail left out of 'Details' is blank.
- `total` (number): How many localities match in all.

**Example output**

```json
{
  "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 (`name`, text): Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Exact name only (`exact_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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**

- `count` (number): How many municipalities this step returned.
- `municipalities` (list): The municipalities. A detail left out of 'Details' is blank.
- `total` (number): How many municipalities match in all.

**Example output**

```json
{
  "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 (`name`, text): Words in the name, spelled any way: accents, capitals and common abbreviations such as 'Sgo.' are matched. Leave empty to list them all.
- Province (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department (`department`, text): 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 (`municipality`, text): 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_locality`, text): 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_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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**

- `count` (number): How many settlements this step returned.
- `settlements` (list): The settlements. A detail left out of 'Details' is blank.
- `total` (number): How many settlements match in all.

**Example output**

```json
{
  "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 (`name`, text): 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_type`, text): 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 (`province`, text): Only places in this province, or in the City of Buenos Aires. Leave empty for the whole country.
- Department (`department`, text): 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_locality`, text): 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_name`, true/false): Only places named exactly what is typed in 'Name' (accents and capitals aside), not every name containing its words. Default: `false`.
- Codes (`ids`, text): 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 (`details`, list): 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 (`order`, text): 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 (`limit`, number): How many results to return, up to 5,000. From 1 to 5000. Default: `100`.
- Skip (`offset`, number): 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**

- `count` (number): How many streets this step returned.
- `streets` (list): The streets. A detail left out of 'Details' is blank.
- `total` (number): How many streets match in all.

**Example output**

```json
{
  "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 (`names`, text, required): Up to 1,000 names, one per line, or a list from an earlier step.
- Kind of place (`place_kind`, text, required): What the names are names of. One of: `province`, `department`, `municipality`, `census_locality` (Census locality), `locality`, `settlement`.
- Province (`province`, text): Only match places in this province, for names many provinces share. Not used when the names are provinces.

**Outputs**

- `count` (number): How many names were given, blank rows included.
- `matched_count` (number): How many of them Georef matched.
- `not_found` (list): The names Georef could not match, as given.
- `place_kind` (text): The kind of place the names were matched to.
- `results` (list): One row per name, in the order given, with its best match. A blank row of a list keeps its place, unmatched.

**Example output**

```json
{
  "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
    }
  ]
}
```
