{
  "data": {
    "id": "GITDHS0K1DnBKj5Cf",
    "actId": "DmHPH9fVzMr9I6BsE",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-11T11:14:04.041Z",
    "finishedAt": "2026-11-11T11:15:04.260Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 60133,
      "runTimeSecs": 60.133,
      "computeUnits": 0.06681444444444444,
      "imageSizeBytes": 1665903616
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Google Earth Location Coordinate Finder Input\",\n  \"description\": \"Resolve place names, addresses, coordinates and public Google Earth URLs into precise coordinates, place IDs, terrain elevation and available place-card details.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"Choose whether to search by text or resolve Google Earth URLs. (mode=search / mode=byUrls)\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byUrls\"\n      ],\n      \"enumTitles\": [\n        \"Search by place name or address\",\n        \"Resolve Google Earth URLs\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"searchQueries\": {\n      \"title\": \"Search queries\",\n      \"type\": \"array\",\n      \"description\": \"Place names, addresses, postal codes or coordinate strings to search on Google Earth. (mode=search) Each query returns one result by default; raise 'Results per query' to collect more. Use specific queries such as 'KFC New York' for a particular branch.\",\n      \"editor\": \"stringList\",\n      \"minItems\": 1,\n      \"maxItems\": 100,\n      \"prefill\": [\n        \"Eiffel Tower\"\n      ],\n      \"example\": [\n        \"Eiffel Tower\",\n        \"1600 Pennsylvania Avenue NW, Washington, DC\",\n        \"48.8584, 2.2945\"\n      ],\n      \"items\": {\n        \"type\": \"string\",\n        \"minLength\": 1\n      }\n    },\n    \"startUrls\": {\n      \"title\": \"Google Earth URLs\",\n      \"type\": \"array\",\n      \"description\": \"Public earth.google.com/web URLs to resolve. A URL can contain a search text, a resolved view with coordinates and a data token, or both. URLs with a data token also unlock the place knowledge card (address, website, Wikipedia, photos and opening hours). (mode=byUrls)\",\n      \"editor\": \"requestListSources\",\n      \"maxItems\": 100,\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"title\": \"URL\",\n            \"type\": \"string\",\n            \"description\": \"Public earth.google.com/web URL.\"\n          }\n        }\n      }\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum records\",\n      \"type\": \"integer\",\n      \"description\": \"Global cap on the number of location records saved across all queries or URLs.\",\n      \"default\": 100,\n      \"prefill\": 1,\n      \"minimum\": 1,\n      \"maximum\": 10000\n    },\n    \"maxResultsPerQuery\": {\n      \"title\": \"Results per query\",\n      \"type\": \"integer\",\n      \"description\": \"How many Google Earth matches to save for each search query. The default of 1 keeps the exact-name match. Raise it to collect every ranked match; the 'rank' field preserves Google's original order.\",\n      \"default\": 1,\n      \"prefill\": 1,\n      \"minimum\": 1,\n      \"maximum\": 200\n    },\n    \"language\": {\n      \"title\": \"Language\",\n      \"type\": \"string\",\n      \"description\": \"Language used for place names, descriptions and details returned by Google Earth.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"en\",\n        \"ar\",\n        \"bn\",\n        \"cs\",\n        \"da\",\n        \"de\",\n        \"el\",\n        \"es\",\n        \"fa\",\n        \"fi\",\n        \"fr\",\n        \"he\",\n        \"hi\",\n        \"hu\",\n        \"id\",\n        \"it\",\n        \"ja\",\n        \"ko\",\n        \"ms\",\n        \"nl\",\n        \"no\",\n        \"pl\",\n        \"pt\",\n        \"ro\",\n        \"ru\",\n        \"sv\",\n        \"th\",\n        \"tr\",\n        \"uk\",\n        \"ur\",\n        \"vi\",\n        \"zh\"\n      ],\n      \"enumTitles\": [\n        \"English\",\n        \"Arabic\",\n        \"Bengali\",\n        \"Czech\",\n        \"Danish\",\n        \"German\",\n        \"Greek\",\n        \"Spanish\",\n        \"Persian\",\n        \"Finnish\",\n        \"French\",\n        \"Hebrew\",\n        \"Hindi\",\n        \"Hungarian\",\n        \"Indonesian\",\n        \"Italian\",\n        \"Japanese\",\n        \"Korean\",\n        \"Malay\",\n        \"Dutch\",\n        \"Norwegian\",\n        \"Polish\",\n        \"Portuguese\",\n        \"Romanian\",\n        \"Russian\",\n        \"Swedish\",\n        \"Thai\",\n        \"Turkish\",\n        \"Ukrainian\",\n        \"Urdu\",\n        \"Vietnamese\",\n        \"Chinese\"\n      ],\n      \"default\": \"en\",\n      \"prefill\": \"en\",\n      \"sectionCaption\": \"Search filters\",\n      \"sectionDescription\": \"Optional language and geographic bias for search mode.\"\n    },\n    \"searchArea\": {\n      \"title\": \"Search area (viewport)\",\n      \"type\": \"object\",\n      \"description\": \"Optional north/south/east/west bounding box that biases Google Earth's ranking toward a region. Leave it unset to search worldwide. All four bounds are recommended; missing bounds fall back to the world.\",\n      \"properties\": {\n        \"north\": {\n          \"title\": \"North latitude\",\n          \"type\": \"number\",\n          \"minimum\": -90,\n          \"maximum\": 90,\n          \"example\": 41,\n          \"description\": \"Northern latitude bound of the search area.\"\n        },\n        \"south\": {\n          \"title\": \"South latitude\",\n          \"type\": \"number\",\n          \"minimum\": -90,\n          \"maximum\": 90,\n          \"example\": 40.4,\n          \"description\": \"Southern latitude bound of the search area.\"\n        },\n        \"east\": {\n          \"title\": \"East longitude\",\n          \"type\": \"number\",\n          \"minimum\": -180,\n          \"maximum\": 180,\n          \"example\": -73.5,\n          \"description\": \"Eastern longitude bound of the search area.\"\n        },\n        \"west\": {\n          \"title\": \"West longitude\",\n          \"type\": \"number\",\n          \"minimum\": -180,\n          \"maximum\": 180,\n          \"example\": -74.3,\n          \"description\": \"Western longitude bound of the search area.\"\n        }\n      },\n      \"editor\": \"json\"\n    },\n    \"includeAddress\": {\n      \"title\": \"Match addresses\",\n      \"type\": \"boolean\",\n      \"description\": \"Add a street address when Google's suggestion results identify the same place unambiguously. Adds one lightweight request per query.\",\n      \"default\": true,\n      \"prefill\": false,\n      \"sectionCaption\": \"Output options\",\n      \"sectionDescription\": \"Optional enrichment fields. Disable them for the fastest, smallest run.\"\n    },\n    \"includeElevation\": {\n      \"title\": \"Terrain elevation\",\n      \"type\": \"boolean\",\n      \"description\": \"Add terrain elevation in metres above sea level for every resolved coordinate, using Google Earth's public elevation service.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"includeKml\": {\n      \"title\": \"Generate KML\",\n      \"type\": \"boolean\",\n      \"description\": \"Add a ready-to-import KML Placemark string to every record. Useful for opening the results in Google Earth, QGIS or other GIS tools.\",\n      \"default\": false,\n      \"prefill\": false\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Google Earth Location Coordinate Finder\n\nResolve place names, street addresses, postal codes, coordinate strings and public Google Earth URLs into precise latitude/longitude, Google place IDs, terrain elevation, matched addresses, place-card details and ready-to-import KML.\n\nThe actor talks to the same public Google Earth web endpoints that earth.google.com uses in a browser. You do not need a Google Maps API key, a Google Cloud account, cookies or a proxy setup.\n\n## What this actor does\n\n- **Search by text** - one query returns Google Earth's best match by default, and you can raise the per-query limit to collect every ranked match.\n- **Search a region** - optional north/south/east/west bounds bias Google Earth's ranking to a city or country, so a generic query like `KFC` returns local branches.\n- **Switch language** - place names, descriptions and details come back in the language you select.\n- **Resolve Earth URLs** - paste public `earth.google.com/web` URLs. Search URLs are resolved; resolved view URLs with a `data=` token also unlock the place knowledge card.\n- **Terrain elevation** - every coordinate can be enriched with ground elevation in metres above sea level.\n- **Address matching** - Google's suggestion results are matched to search results when the match is unambiguous.\n- **Place-card details** - for resolved URLs with a feature token: long description, full address, plus code, official website, Wikipedia link, photos and opening hours.\n- **KML output** - optionally include a KML Placemark string on every record for QGIS, Google Earth or another GIS tool.\n- **No empty fields** - values Google does not provide are omitted, never emitted as `null`, `\"\"`, `[]` or a sentinel.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search` for text queries, `byUrls` for Google Earth URLs. |\n| `searchQueries` | string list | `[\"Eiffel Tower\"]` prefill | Place names, addresses, postal codes or `lat,lon` strings. (mode=search) |\n| `startUrls` | URL list | - | Public earth.google.com/web URLs. (mode=byUrls) |\n| `maxItems` | integer | 100 | Global cap on saved records. The daily prefill uses 1. |\n| `maxResultsPerQuery` | integer | 1 | Matches saved per query (1-200). The `rank` field keeps Google's original order. |\n| `language` | select | `en` | Language for names, descriptions and details. |\n| `searchArea` | object | world | Optional `{north, south, east, west}` bounds for search. |\n| `includeAddress` | boolean | true | Match a street address when Google's suggestions are unambiguous. |\n| `includeElevation` | boolean | true | Add `elevation_meters` (terrain elevation above sea level). |\n| `includeKml` | boolean | false | Add a generated `kml` Placemark string. |\n\nThe smallest daily run is the prefill: one English query, one result, address/elevation/KML enrichment off. It makes a single search request and returns one record.\n\nOlder task inputs that used `query`, `queries`, `maxResults`, `minDelayBetweenRequests` or `maxDelayBetweenRequests` still run: those keys are read in code and mapped to the current fields or pacing. They are not shown in the input form.\n\n### Example: landmarks\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"Eiffel Tower\", \"Statue of Liberty\", \"Taj Mahal\"],\n  \"maxResultsPerQuery\": 1,\n  \"includeElevation\": true\n}\n```\n\n### Example: all matches for a chain\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"KFC\"],\n  \"searchArea\": {\"north\": 41.0, \"south\": 40.4, \"east\": -73.5, \"west\": -74.3},\n  \"maxResultsPerQuery\": 50,\n  \"maxItems\": 100\n}\n```\n\n### Example: resolved Google Earth URL\n\n```json\n{\n  \"mode\": \"byUrls\",\n  \"startUrls\": [\n    {\"url\": \"https://earth.google.com/web/search/Eiffel+Tower/@48.8583701,2.2944813,146.9105192a,533.29335005d,35y,0h,0t,0r/data=CjoaDAoIL20vMDJqODEYAiImCiQJME-ZgofyPUARME-ZgofyPcAZ26Y5nC09S0AhQYot7SnSTMBCAggBQgIIAEoNCP___________wEQAA\"}\n  ],\n  \"includeElevation\": true,\n  \"includeKml\": true\n}\n```\n\n## Output per location\n\nLegacy fields are unchanged:\n\n- `search_query` - the query text, or the source URL in `byUrls` mode\n- `place_name` - the resolved place name\n- `latitude`, `longitude` - the resolved coordinates (WGS84)\n- `description` - Google Earth's short description, e.g. `Tower in Paris, France`\n- `google_place_id` - Google's place identifier (`0x...:0x...`)\n- `data_source` - `search_api` for a search response, `url_fallback` for a URL-derived record\n- `url` - a Google Earth URL for the resolved location\n- `scraped_at` - ISO 8601 UTC timestamp\n\nNew fields are added beside them:\n\n- `elevation_meters` - terrain elevation above sea level, when available\n- `address` - matched street address, when unambiguous\n- `rank` - original position in Google's result list\n- `language` - language used for the response\n- `record_type` - `location`\n- `kml` - generated KML Placemark, when `includeKml` is on\n\nFor `byUrls` records with a feature token, the place knowledge card can also add:\n\n- `feature_id` - Google Knowledge Graph id (`/m/...` or `/g/...`)\n- `description_long` - the longer place description\n- `plus_code`, `plus_code_local`\n- `website`, `website_domain`\n- `wikipedia_url`\n- `photos` - Google-hosted photo URLs\n- `opening_hours` - day-to-hours object\n- `google_maps_url`\n- `camera_altitude_meters`, `camera_distance_meters`, `field_of_view_degrees`, `heading_degrees`, `tilt_degrees`, `roll_degrees`, `camera_text` - camera values read from the URL\n\n## Use cases\n\n- **GIS data collection** - bulk-resolve place names into coordinates and elevation for maps and terrain models.\n- **Travel research** - get exact coordinates, addresses and opening hours for landmarks and venues.\n- **Location intelligence** - attach Google place IDs and coordinates to a list of business names or addresses.\n- **Dataset enrichment** - add latitude, longitude, elevation and a place ID to records that only have a name.\n- **Franchise mapping** - resolve many branches of the same chain, optionally biased to a city or region.\n- **KML handoff** - export a ready-to-import Placemark for each record.\n\n## FAQ\n\n**Do I need a Google Maps API key?** No. The actor uses the public endpoints behind earth.google.com and never asks you for a key.\n\n**Why did a query return no record?** Google Earth could not resolve that text to a location. A typo, a very vague query, an unsupported script, or a temporary rate limit can all cause this. The run summary reports how many inputs were unresolved.\n\n**Why does one query return only one record?** That is the default. Set `maxResultsPerQuery` above 1 to collect every ranked match. Google Earth itself may return fewer matches than you ask for.\n\n**Why is `address` missing on some records?** An address is added only when Google's suggestion results identify the same place unambiguously. Common names such as `KFC` can match many branches, so the actor omits the address instead of guessing.\n\n**Why can't I see website, photos or opening hours for a search result?** Google Earth's search response exposes coordinates, place IDs and short descriptions. The full place card requires a feature id, which Google only exposes in a resolved view URL. Use `mode=byUrls` with a resolved Earth URL to get the full card.\n\n**What is the difference between `search_api` and `url_fallback`?** `search_api` means the record came from Google Earth's search response. `url_fallback` means the record came from a URL you supplied (a resolved view, a coordinate URL, or a search URL resolved through the API).\n\n**Are the coordinates survey-grade?** No. They are the coordinates Google Earth resolves for the place, typically accurate to a few metres for landmarks but not a survey measurement.\n\n**Does this work in any language?** The 32 most common Google Earth interface languages are available. Google may fall back to English for places that have no localized name.\n\n**Is this affiliated with Google?** No. This is an independent, third-party actor that reads Google Earth's public location search and place card data. It is not operated by or affiliated with Google.\n\n## Limitations\n\n- Google Earth may cap the number of matches for a broad query; the actor stops when the source stops returning a next page.\n- Place-card details (website, photos, hours, plus code) are only available for resolved URLs that contain a feature token, or when Google exposes a matching card.\n- Some official venue websites block automated link checks. Their URLs are still the real website URLs Google publishes.\n- Coordinates and names can change over time as Google updates its data.\n- Broad queries are ranked by Google Earth, not by the actor. Use a specific query or `searchArea` for predictable local results.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "google-earth-location-coordinate-finder",
      "title": "Google Earth Location Coordinate Finder",
      "description": "Resolve place names, addresses, coordinates and public Google Earth URLs into precise coordinates, place IDs, terrain elevation, addresses, place-card details and KML. Multiple matches, locales, regional search and URL lookup. No API key.",
      "version": "1.1",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Google Earth Location Coordinate Finder\n\nResolve place names, street addresses, postal codes, coordinate strings and public Google Earth URLs into precise latitude/longitude, Google place IDs, terrain elevation, matched addresses, place-card details and ready-to-import KML.\n\nThe actor talks to the same public Google Earth web endpoints that earth.google.com uses in a browser. You do not need a Google Maps API key, a Google Cloud account, cookies or a proxy setup.\n\n## What this actor does\n\n- **Search by text** - one query returns Google Earth's best match by default, and you can raise the per-query limit to collect every ranked match.\n- **Search a region** - optional north/south/east/west bounds bias Google Earth's ranking to a city or country, so a generic query like `KFC` returns local branches.\n- **Switch language** - place names, descriptions and details come back in the language you select.\n- **Resolve Earth URLs** - paste public `earth.google.com/web` URLs. Search URLs are resolved; resolved view URLs with a `data=` token also unlock the place knowledge card.\n- **Terrain elevation** - every coordinate can be enriched with ground elevation in metres above sea level.\n- **Address matching** - Google's suggestion results are matched to search results when the match is unambiguous.\n- **Place-card details** - for resolved URLs with a feature token: long description, full address, plus code, official website, Wikipedia link, photos and opening hours.\n- **KML output** - optionally include a KML Placemark string on every record for QGIS, Google Earth or another GIS tool.\n- **No empty fields** - values Google does not provide are omitted, never emitted as `null`, `\"\"`, `[]` or a sentinel.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search` for text queries, `byUrls` for Google Earth URLs. |\n| `searchQueries` | string list | `[\"Eiffel Tower\"]` prefill | Place names, addresses, postal codes or `lat,lon` strings. (mode=search) |\n| `startUrls` | URL list | - | Public earth.google.com/web URLs. (mode=byUrls) |\n| `maxItems` | integer | 100 | Global cap on saved records. The daily prefill uses 1. |\n| `maxResultsPerQuery` | integer | 1 | Matches saved per query (1-200). The `rank` field keeps Google's original order. |\n| `language` | select | `en` | Language for names, descriptions and details. |\n| `searchArea` | object | world | Optional `{north, south, east, west}` bounds for search. |\n| `includeAddress` | boolean | true | Match a street address when Google's suggestions are unambiguous. |\n| `includeElevation` | boolean | true | Add `elevation_meters` (terrain elevation above sea level). |\n| `includeKml` | boolean | false | Add a generated `kml` Placemark string. |\n\nThe smallest daily run is the prefill: one English query, one result, address/elevation/KML enrichment off. It makes a single search request and returns one record.\n\nOlder task inputs that used `query`, `queries`, `maxResults`, `minDelayBetweenRequests` or `maxDelayBetweenRequests` still run: those keys are read in code and mapped to the current fields or pacing. They are not shown in the input form.\n\n### Example: landmarks\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"Eiffel Tower\", \"Statue of Liberty\", \"Taj Mahal\"],\n  \"maxResultsPerQuery\": 1,\n  \"includeElevation\": true\n}\n```\n\n### Example: all matches for a chain\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"KFC\"],\n  \"searchArea\": {\"north\": 41.0, \"south\": 40.4, \"east\": -73.5, \"west\": -74.3},\n  \"maxResultsPerQuery\": 50,\n  \"maxItems\": 100\n}\n```\n\n### Example: resolved Google Earth URL\n\n```json\n{\n  \"mode\": \"byUrls\",\n  \"startUrls\": [\n    {\"url\": \"https://earth.google.com/web/search/Eiffel+Tower/@48.8583701,2.2944813,146.9105192a,533.29335005d,35y,0h,0t,0r/data=CjoaDAoIL20vMDJqODEYAiImCiQJME-ZgofyPUARME-ZgofyPcAZ26Y5nC09S0AhQYot7SnSTMBCAggBQgIIAEoNCP___________wEQAA\"}\n  ],\n  \"includeElevation\": true,\n  \"includeKml\": true\n}\n```\n\n## Output per location\n\nLegacy fields are unchanged:\n\n- `search_query` - the query text, or the source URL in `byUrls` mode\n- `place_name` - the resolved place name\n- `latitude`, `longitude` - the resolved coordinates (WGS84)\n- `description` - Google Earth's short description, e.g. `Tower in Paris, France`\n- `google_place_id` - Google's place identifier (`0x...:0x...`)\n- `data_source` - `search_api` for a search response, `url_fallback` for a URL-derived record\n- `url` - a Google Earth URL for the resolved location\n- `scraped_at` - ISO 8601 UTC timestamp\n\nNew fields are added beside them:\n\n- `elevation_meters` - terrain elevation above sea level, when available\n- `address` - matched street address, when unambiguous\n- `rank` - original position in Google's result list\n- `language` - language used for the response\n- `record_type` - `location`\n- `kml` - generated KML Placemark, when `includeKml` is on\n\nFor `byUrls` records with a feature token, the place knowledge card can also add:\n\n- `feature_id` - Google Knowledge Graph id (`/m/...` or `/g/...`)\n- `description_long` - the longer place description\n- `plus_code`, `plus_code_local`\n- `website`, `website_domain`\n- `wikipedia_url`\n- `photos` - Google-hosted photo URLs\n- `opening_hours` - day-to-hours object\n- `google_maps_url`\n- `camera_altitude_meters`, `camera_distance_meters`, `field_of_view_degrees`, `heading_degrees`, `tilt_degrees`, `roll_degrees`, `camera_text` - camera values read from the URL\n\n## Use cases\n\n- **GIS data collection** - bulk-resolve place names into coordinates and elevation for maps and terrain models.\n- **Travel research** - get exact coordinates, addresses and opening hours for landmarks and venues.\n- **Location intelligence** - attach Google place IDs and coordinates to a list of business names or addresses.\n- **Dataset enrichment** - add latitude, longitude, elevation and a place ID to records that only have a name.\n- **Franchise mapping** - resolve many branches of the same chain, optionally biased to a city or region.\n- **KML handoff** - export a ready-to-import Placemark for each record.\n\n## FAQ\n\n**Do I need a Google Maps API key?** No. The actor uses the public endpoints behind earth.google.com and never asks you for a key.\n\n**Why did a query return no record?** Google Earth could not resolve that text to a location. A typo, a very vague query, an unsupported script, or a temporary rate limit can all cause this. The run summary reports how many inputs were unresolved.\n\n**Why does one query return only one record?** That is the default. Set `maxResultsPerQuery` above 1 to collect every ranked match. Google Earth itself may return fewer matches than you ask for.\n\n**Why is `address` missing on some records?** An address is added only when Google's suggestion results identify the same place unambiguously. Common names such as `KFC` can match many branches, so the actor omits the address instead of guessing.\n\n**Why can't I see website, photos or opening hours for a search result?** Google Earth's search response exposes coordinates, place IDs and short descriptions. The full place card requires a feature id, which Google only exposes in a resolved view URL. Use `mode=byUrls` with a resolved Earth URL to get the full card.\n\n**What is the difference between `search_api` and `url_fallback`?** `search_api` means the record came from Google Earth's search response. `url_fallback` means the record came from a URL you supplied (a resolved view, a coordinate URL, or a search URL resolved through the API).\n\n**Are the coordinates survey-grade?** No. They are the coordinates Google Earth resolves for the place, typically accurate to a few metres for landmarks but not a survey measurement.\n\n**Does this work in any language?** The 32 most common Google Earth interface languages are available. Google may fall back to English for places that have no localized name.\n\n**Is this affiliated with Google?** No. This is an independent, third-party actor that reads Google Earth's public location search and place card data. It is not operated by or affiliated with Google.\n\n## Limitations\n\n- Google Earth may cap the number of matches for a broad query; the actor stops when the source stops returning a next page.\n- Place-card details (website, photos, hours, plus code) are only available for resolved URLs that contain a feature token, or when Google exposes a matching card.\n- Some official venue websites block automated link checks. Their URLs are still the real website URLs Google publishes.\n- Coordinates and names can change over time as Google updates its data.\n- Broad queries are ranked by Google Earth, not by the actor. Use a specific query or `searchArea` for predictable local results.\n",
      "input": {
        "title": "Google Earth Location Coordinate Finder Input",
        "description": "Resolve place names, addresses, coordinates and public Google Earth URLs into precise coordinates, place IDs, terrain elevation and available place-card details.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "Choose whether to search by text or resolve Google Earth URLs. (mode=search / mode=byUrls)",
            "editor": "select",
            "enum": [
              "search",
              "byUrls"
            ],
            "enumTitles": [
              "Search by place name or address",
              "Resolve Google Earth URLs"
            ],
            "default": "search",
            "prefill": "search"
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Place names, addresses, postal codes or coordinate strings to search on Google Earth. (mode=search) Each query returns one result by default; raise 'Results per query' to collect more. Use specific queries such as 'KFC New York' for a particular branch.",
            "editor": "stringList",
            "minItems": 1,
            "maxItems": 100,
            "prefill": [
              "Eiffel Tower"
            ],
            "example": [
              "Eiffel Tower",
              "1600 Pennsylvania Avenue NW, Washington, DC",
              "48.8584, 2.2945"
            ],
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "startUrls": {
            "title": "Google Earth URLs",
            "type": "array",
            "description": "Public earth.google.com/web URLs to resolve. A URL can contain a search text, a resolved view with coordinates and a data token, or both. URLs with a data token also unlock the place knowledge card (address, website, Wikipedia, photos and opening hours). (mode=byUrls)",
            "editor": "requestListSources",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "Public earth.google.com/web URL."
                }
              }
            }
          },
          "maxItems": {
            "title": "Maximum records",
            "type": "integer",
            "description": "Global cap on the number of location records saved across all queries or URLs.",
            "default": 100,
            "prefill": 1,
            "minimum": 1,
            "maximum": 10000
          },
          "maxResultsPerQuery": {
            "title": "Results per query",
            "type": "integer",
            "description": "How many Google Earth matches to save for each search query. The default of 1 keeps the exact-name match. Raise it to collect every ranked match; the 'rank' field preserves Google's original order.",
            "default": 1,
            "prefill": 1,
            "minimum": 1,
            "maximum": 200
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language used for place names, descriptions and details returned by Google Earth.",
            "editor": "select",
            "enum": [
              "en",
              "ar",
              "bn",
              "cs",
              "da",
              "de",
              "el",
              "es",
              "fa",
              "fi",
              "fr",
              "he",
              "hi",
              "hu",
              "id",
              "it",
              "ja",
              "ko",
              "ms",
              "nl",
              "no",
              "pl",
              "pt",
              "ro",
              "ru",
              "sv",
              "th",
              "tr",
              "uk",
              "ur",
              "vi",
              "zh"
            ],
            "enumTitles": [
              "English",
              "Arabic",
              "Bengali",
              "Czech",
              "Danish",
              "German",
              "Greek",
              "Spanish",
              "Persian",
              "Finnish",
              "French",
              "Hebrew",
              "Hindi",
              "Hungarian",
              "Indonesian",
              "Italian",
              "Japanese",
              "Korean",
              "Malay",
              "Dutch",
              "Norwegian",
              "Polish",
              "Portuguese",
              "Romanian",
              "Russian",
              "Swedish",
              "Thai",
              "Turkish",
              "Ukrainian",
              "Urdu",
              "Vietnamese",
              "Chinese"
            ],
            "default": "en",
            "prefill": "en",
            "sectionCaption": "Search filters",
            "sectionDescription": "Optional language and geographic bias for search mode."
          },
          "searchArea": {
            "title": "Search area (viewport)",
            "type": "object",
            "description": "Optional north/south/east/west bounding box that biases Google Earth's ranking toward a region. Leave it unset to search worldwide. All four bounds are recommended; missing bounds fall back to the world.",
            "properties": {
              "north": {
                "title": "North latitude",
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "example": 41,
                "description": "Northern latitude bound of the search area."
              },
              "south": {
                "title": "South latitude",
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "example": 40.4,
                "description": "Southern latitude bound of the search area."
              },
              "east": {
                "title": "East longitude",
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "example": -73.5,
                "description": "Eastern longitude bound of the search area."
              },
              "west": {
                "title": "West longitude",
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "example": -74.3,
                "description": "Western longitude bound of the search area."
              }
            },
            "editor": "json"
          },
          "includeAddress": {
            "title": "Match addresses",
            "type": "boolean",
            "description": "Add a street address when Google's suggestion results identify the same place unambiguously. Adds one lightweight request per query.",
            "default": true,
            "prefill": false,
            "sectionCaption": "Output options",
            "sectionDescription": "Optional enrichment fields. Disable them for the fastest, smallest run."
          },
          "includeElevation": {
            "title": "Terrain elevation",
            "type": "boolean",
            "description": "Add terrain elevation in metres above sea level for every resolved coordinate, using Google Earth's public elevation service.",
            "default": true,
            "prefill": false
          },
          "includeKml": {
            "title": "Generate KML",
            "type": "boolean",
            "description": "Add a ready-to-import KML Placemark string to every record. Useful for opening the results in Google Earth, QGIS or other GIS tools.",
            "default": false,
            "prefill": false
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Google Earth Location Coordinate Finder Output",
        "description": "Google Earth location records: place name, description, precise latitude/longitude, Google place ID, terrain elevation, matched address, optional place-card details and KML.",
        "properties": {
          "locations": {
            "type": "string",
            "title": "Google Earth locations",
            "description": "Dataset containing all resolved Google Earth locations.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "categories": [
        "TRAVEL",
        "DEVELOPER_TOOLS",
        "GIS"
      ],
      "defaultRunOptions": {
        "timeoutSecs": 3600,
        "memoryMbytes": 4096
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "title": "Google Earth Search Results",
          "views": {
            "overview": {
              "title": "Google Earth Locations",
              "description": "Overview of resolved Google Earth location data",
              "transformation": {
                "fields": [
                  "place_name",
                  "google_place_id",
                  "latitude",
                  "longitude",
                  "elevation_meters",
                  "description",
                  "address",
                  "search_query",
                  "data_source",
                  "url",
                  "scraped_at"
                ]
              },
              "display": {
                "component": "table",
                "properties": {
                  "columns": [
                    {
                      "field": "place_name",
                      "label": "Place Name",
                      "format": "text"
                    },
                    {
                      "field": "google_place_id",
                      "label": "Place ID",
                      "format": "text"
                    },
                    {
                      "field": "latitude",
                      "label": "Latitude",
                      "format": "number"
                    },
                    {
                      "field": "longitude",
                      "label": "Longitude",
                      "format": "number"
                    },
                    {
                      "field": "elevation_meters",
                      "label": "Elevation (m)",
                      "format": "number"
                    },
                    {
                      "field": "address",
                      "label": "Address",
                      "format": "text"
                    },
                    {
                      "field": "description",
                      "label": "Description",
                      "format": "text"
                    },
                    {
                      "field": "url",
                      "label": "Google Earth URL",
                      "format": "link"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "buildNumber": "1.1.1",
    "imageDigest": "ba3bdfe433ea2e985e2286b76d77de44a860d9d28fc173e353dea9a22d266c8e",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.1"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.06681444444444444
    }
  }
}