# Address Converter (Latitude and Longitude)

Convert addresses to latitudes and longitudes.

- Template page: [https://www.octoparse.com/template/address-converter-latitude-and-longitude](https://www.octoparse.com/template/address-converter-latitude-and-longitude)
- Categories: Directories
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from detail pages.

## Output

The current workflow extracts 3 fields, including `Address`, `Latitude`, `Longitude`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Addresses (up to 10,000) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Addresses (up to 10,000)

Required. Enter a list of addresses that you need to convert to longitudes & latitudes. Use Enter Key to seperate each address. Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=50000.

## How to Use

### Address Converter (Latitude and Longitude)

Converts a list of street addresses into latitude and longitude coordinates using [GPS Coordinates](https://www.gps-coordinates.net/gps-coordinates-converter).

**Input**
- **Addresses** (Required) – One address per line. Up to 10,000 entries per run.

**Output Fields**
- `Address`
- `Latitude`
- `Longitude`

Example:
```json
{
  "Address": "48 W 22nd St New York, NY 10010",
  "Latitude": "40.741686",
  "Longitude": "-73.9925668"
}
```

**How to Use**
1. Open the template in Octoparse and click **Try it!**.
2. Fill in the **Addresses** field (up to 10,000 lines).
3. Run the task locally or in the cloud.
4. Export the results (rows containing `Address`, `Latitude`, `Longitude`) as needed.

**Limits**
- Maximum 10,000 addresses per run.

## Notes

Please contact us if you have any questions about this template or if you would like to have a template customized.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Tabelog Store list and details Scraper](https://www.octoparse.com/template/tabelog-store-list-detail-scraper)
- [Google Maps Listing and Details Page Scraper (Cloud)](https://www.octoparse.com/template/google-maps-listing-and-details-page-scraper)
- [Etsy Product Scraper (by URL)](https://www.octoparse.com/template/etsy-product-scraper-by-url)
- [Local.ch Lead Scraper (for Switzerland)](https://www.octoparse.com/template/local-lead-scraper)
- [Naver Land Real Estate Scraper](https://www.octoparse.com/template/naver-land-real-estate-scraper)

## Input Schema

```json
{
  "title": "Address Converter (Latitude and Longitude) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "addresses": {
      "title": "Addresses (up to 10,000)",
      "description": "Enter a list of addresses that you need to convert to longitudes & latitudes. Use Enter Key to seperate each address.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 50000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "addresses"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "addresses": [
    "Poe, Vihula küla, Haljala vald, Lääne-Viru maakond",
    "Metsamõisa, Järsi küla, Tapa vald, Lääne-Viru maakond",
    "Vihula mõis/1, Vihula küla, Haljala vald, Lääne-Viru maakond",
    "Mõisa, Sagadi küla, Haljala vald, Lääne-Viru maakond",
    "Kalurite sadam, Lemsi küla, Kihnu vald, Pärnu maakond"
  ]
}
```

Example 2

```json
{
  "addresses": [
    "Poe, Vihula küla, Haljala vald, Lääne-Viru maakond",
    "Metsamõisa, Järsi küla, Tapa vald, Lääne-Viru maakond",
    "Vihula mõis/1, Vihula küla, Haljala vald, Lääne-Viru maakond",
    "Mõisa, Sagadi küla, Haljala vald, Lääne-Viru maakond",
    "Kalurite sadam, Lemsi küla, Kihnu vald, Pärnu maakond"
  ]
}
```

Example 3

```json
{
  "addresses": [
    "[\"الموقع\",\"https://maps.app.goo.gl/XskbtWbNW7CND57s5\",\"https://goo.gl/maps/ohyUdher4V5PrkNE7\",\"https://maps.app.goo.gl/ZLDzd37CDSpsecL78\",\"https://maps.app.goo.gl/2VBEqWekiZRrotLa7\",\"https://maps.app.goo.gl/ZndSCKtAFUixTuXt6\",\"https://maps.app.goo.gl/unXa379jxQwsFdaJ6\",\"https://maps.app.goo.gl/UmFE94mhjabSgkKJ9\",\"https://maps.app.goo.gl/AiC1UG79zby6JaD78\",\"https://maps.app.goo.gl/YKwQWosycBwNpNDb9\",\"https://maps.app.goo.gl/NKEqRpKaGrKnNzuz7\",\"https://maps.app.goo.gl/1BKGviNZNvHbBop28\",\"https://goo.gl/maps/mV2ppCQqBFMwmgjo9\",\"https://maps.app.goo.gl/M9CV5adqCFfG3eHn7\",\"https://goo.gl/maps/2QR4iLz41kLxp3Mk9\",\"https://goo.gl/maps/hSGkmk1tKwou5g1a6\",\"https://maps.app.goo.gl/HcifFJcxbixuTUy76\",\"https://maps.app.goo.gl/YZA9EGR6jgQso5Y47\",\"https://goo.gl/maps/MRYwpRx1k6hikk1u6\",\"https://goo.gl/maps/AoC7HdYb5o6iKXBv8\",\"https://goo.gl/maps/9uCauANEQT4ZS5iV9\",\"https://goo.gl/maps/8UuVRUf9JZc6sXX39\",\"https://maps.app.goo.gl/QJR3wKXpDsJ7Twr37\",\"https://maps.app.goo.gl/z2mXgmcSfRsVyec59\",\"https://goo.gl/maps/EJPzjaBgS9WGgTLRA\",\"https://goo.gl/maps/4hDWaJU666H8SnLSA\",\"https://maps.app.goo.gl/GRYaXpRhjcpnpDMh8 \",\"https://maps.app.goo.gl/YyChHSztQicuoYCWA\",\"https://maps.app.goo.gl/eeaHA4WJ9Ykh32Ff6 \",\"https://maps.app.goo.gl/bRt8K3XYQoxSwqtr8  \",\"https://maps.app.goo.gl/AmbEqHqGxSBg3tkf8 \",\"https://maps.app.goo.gl/5Ty4Bf77p8hP6uCQ9 \",\"https://maps.app.goo.gl/ifuYBMbiWxBQ1fkYA \",\"https://maps.app.goo.gl/R7UCKQ4HbNb7kVZv8 \",\"https://maps.app.goo.gl/zbMtpqWQxPYx4FK49 \",\"https://maps.app.goo.gl/SBYPnCdUsWY8nbwm6 \",\"https://maps.app.goo.gl/vgHFqwqGVtRAfwKq7 \",\"https://maps.app.goo.gl/JDxj6YDHPc23u9ph8 \",\"https://maps.app.goo.gl/YGSGPYiS6QTMrHgb6 \",\"https://maps.app.goo.gl/bLLJdtTJDQpFaFGh6\",\"https://maps.app.goo.gl/EAPiruygn7NcsnKz5\",\"https://maps.app.goo.gl/BJKpd3wFaNYF6wGV9\",\"https://maps.app.goo.gl/sRSrXUUfZuPKfMsJA\",\"https://maps.app.goo.gl/1gi4QS9rxz3nBHJZ6\"]"
  ]
}
```

Example 4

```json
{
  "addresses": [
    "[\"[\\\"98 quetzal zibata\\\"]\"]"
  ]
}
```

Example 5

```json
{
  "addresses": [
    "[\"https://www.google.com/search?q=30, C. SILICIO 30, 28850, TORREJON DE ARDOZ, Madrid, Spain\"]"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Address": {
      "type": "string",
      "description": ""
    },
    "Latitude": {
      "type": "string",
      "description": ""
    },
    "Longitude": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Address Converter (Latitude and Longitude) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Address": "Poe, Vihula küla, Haljala vald, Lääne-Viru maakond",
  "Latitude": "59.5479946",
  "Longitude": "26.1850005"
}
```

Example 2

```json
{
  "Address": "Paasiku mõis, Paasiku küla, Anija vald, Harju maakond",
  "Latitude": "59.349389",
  "Longitude": "25.3012494"
}
```

Example 3

```json
{
  "Address": "[\"الموقع\",\"https://maps.app.goo.gl/XskbtWbNW7CND57s5\",\"https://goo.gl/maps/ohyUdher4V5PrkNE7\",\"https://maps.app.goo.gl/ZLDzd37CDSpsecL78\",\"https://maps.app.goo.gl/2VBEqWekiZRrotLa7\",\"https://maps.app.goo.gl/ZndSCKtAFUixTuXt6\",\"https://maps.app.goo.gl/unXa379jxQwsFdaJ6\",\"https://maps.app.goo.gl/UmFE94mhjabSgkKJ9\",\"https://maps.app.goo.gl/AiC1UG79zby6JaD78\",\"https://maps.app.goo.gl/YKwQWosycBwNpNDb9\",\"https://maps.app.goo.gl/NKEqRpKaGrKnNzuz7\",\"https://maps.app.goo.gl/1BKGviNZNvHbBop28\",\"https://goo.gl/maps/mV2ppCQqBFMwmgjo9\",\"https://maps.app.goo.gl/M9CV5adqCFfG3eHn7\",\"https://goo.gl/maps/2QR4iLz41kLxp3Mk9\",\"https://goo.gl/maps/hSGkmk1tKwou5g1a6\",\"https://maps.app.goo.gl/HcifFJcxbixuTUy76\",\"https://maps.app.goo.gl/YZA9EGR6jgQso5Y47\",\"https://goo.gl/maps/MRYwpRx1k6hikk1u6\",\"https://goo.gl/maps/AoC7HdYb5o6iKXBv8\",\"https://goo.gl/maps/9uCauANEQT4ZS5iV9\",\"https://goo.gl/maps/8UuVRUf9JZc6sXX39\",\"https://maps.app.goo.gl/QJR3wKXpDsJ7Twr37\",\"https://maps.app.goo.gl/z2mXgmcSfRsVyec59\",\"https://goo.gl/maps/EJPzjaBgS9WGgTLRA\",\"https://goo.gl/maps/4hDWaJU666H8SnLSA\",\"https://maps.app.goo.gl/GRYaXpRhjcpnpDMh8 \",\"https://maps.app.goo.gl/YyChHSztQicuoYCWA\",\"https://maps.app.goo.gl/eeaHA4WJ9Ykh32Ff6 \",\"https://maps.app.goo.gl/bRt8K3XYQoxSwqtr8  \",\"https://maps.app.goo.gl/AmbEqHqGxSBg3tkf8 \",\"https://maps.app.goo.gl/5Ty4Bf77p8hP6uCQ9 \",\"https://maps.app.goo.gl/ifuYBMbiWxBQ1fkYA \",\"https://maps.app.goo.gl/R7UCKQ4HbNb7kVZv8 \",\"https://maps.app.goo.gl/zbMtpqWQxPYx4FK49 \",\"https://maps.app.goo.gl/SBYPnCdUsWY8nbwm6 \",\"https://maps.app.goo.gl/vgHFqwqGVtRAfwKq7 \",\"https://maps.app.goo.gl/JDxj6YDHPc23u9ph8 \",\"https://maps.app.goo.gl/YGSGPYiS6QTMrHgb6 \",\"https://maps.app.goo.gl/bLLJdtTJDQpFaFGh6\",\"https://maps.app.goo.gl/EAPiruygn7NcsnKz5\",\"https://maps.app.goo.gl/BJKpd3wFaNYF6wGV9\",\"https://maps.app.goo.gl/sRSrXUUfZuPKfMsJA\",\"https://maps.app.goo.gl/1gi4QS9rxz3nBHJZ6\"]",
  "Latitude": "",
  "Longitude": ""
}
```

Example 4

```json
{
  "Address": "[\"[\\\"98 quetzal zibata\\\"]\"]",
  "Latitude": "",
  "Longitude": ""
}
```

Example 5

```json
{
  "Address": "[\"https://www.google.com/search?q=30, C. SILICIO 30, 28850, TORREJON DE ARDOZ, Madrid, Spain\"]",
  "Latitude": "",
  "Longitude": ""
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "address-converter-latitude-and-longitude",
  "taskName": "Address Converter (Latitude and Longitude)",
  "parameters": "{\"addresses\":[\"Poe, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Metsamõisa, Järsi küla, Tapa vald, Lääne-Viru maakond\",\"Vihula mõis/1, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Mõisa, Sagadi küla, Haljala vald, Lääne-Viru maakond\",\"Kalurite sadam, Lemsi küla, Kihnu vald, Pärnu maakond\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"addresses\":[\"Poe, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Metsamõisa, Järsi küla, Tapa vald, Lääne-Viru maakond\",\"Vihula mõis/1, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Mõisa, Sagadi küla, Haljala vald, Lääne-Viru maakond\",\"Kalurite sadam, Lemsi küla, Kihnu vald, Pärnu maakond\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "address-converter-latitude-and-longitude",
        "taskName": "Address Converter (Latitude and Longitude)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "address-converter-latitude-and-longitude",
  "taskName": "Address Converter (Latitude and Longitude)",
  "parameters": "{\"addresses\":[\"Poe, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Metsamõisa, Järsi küla, Tapa vald, Lääne-Viru maakond\",\"Vihula mõis/1, Vihula küla, Haljala vald, Lääne-Viru maakond\",\"Mõisa, Sagadi küla, Haljala vald, Lääne-Viru maakond\",\"Kalurite sadam, Lemsi küla, Kihnu vald, Pärnu maakond\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `address-converter-latitude-and-longitude`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/address-converter-latitude-and-longitude.json)
- [Manifest](https://www.octoparse.com/templates/address-converter-latitude-and-longitude-manifest.json)
