Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-13 UTC."],[[["\u003cp\u003e\u003ccode\u003eBlob.string()\u003c/code\u003e returns the contents of a blob as a String, optionally decoding it using a specified character set encoding.\u003c/p\u003e\n"],["\u003cp\u003eThis method can be used to process data stored in blobs, such as parsing JSON or text files from cloud storage.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eencoding\u003c/code\u003e parameter is optional and defaults to null, allowing you to specify character sets like 'US-ASCII', 'UTF-8', and 'UTF-16' for decoding.\u003c/p\u003e\n"],["\u003cp\u003eExamples demonstrate the use of \u003ccode\u003eBlob.string()\u003c/code\u003e to read and parse a GeoJSON file from Google Cloud Storage using both JavaScript and Python APIs.\u003c/p\u003e\n"]]],["The `Blob.string()` method retrieves the content of a blob as a string. It accepts an optional `encoding` argument (defaulting to `null`) to specify the character set for decoding, such as 'US-ASCII', 'UTF-8', or 'UTF-16'. The return type is a String. Example usages demonstrate fetching a JSON file from Google Cloud Storage using this function to get a SpatioTemporal Asset Catalog (STAC) entry as a decoded JSON.\n"],null,["Returns the contents of the blob as a String.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------|---------|\n| Blob.string`(`*encoding*`)` | String |\n\n| Argument | Type | Details |\n|--------------|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| this: `blob` | Blob | |\n| `encoding` | String, default: null | The character set encoding to use when decoding the blob. Options include, but are not limited to, 'US-ASCII', 'UTF-8', and 'UTF-16'. |\n\nExamples\n\nCode Editor (JavaScript) \n\n```javascript\n// Parse a SpatioTemporal Asset Catalog (STAC) entry from Google Cloud\n// Storage (GCS). This is a non-traditional use of ee.Blob.\nvar url = 'gs://ee-docs-demos/vector/geojson/point.json';\nvar blob = ee.Blob(url);\nvar entry = ee.Dictionary(blob.string().decodeJSON());\nprint(entry); // Point (1.00, 2.00)...\nprint(entry.get('a_field')); // \"a demo field\"\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\nColab (Python) \n\n```python\n# Parse a SpatioTemporal Asset Catalog (STAC) entry from Google Cloud\n# Storage (GCS). This is a non-traditional use of ee.Blob.\nurl = 'gs://ee-docs-demos/vector/geojson/point.json'\nblob = ee.Blob(url)\nentry = ee.Dictionary(blob.string().decodeJSON())\nprint(entry.getInfo()) # Point (1.00, 2.00)...\nprint(entry.get('a_field').getInfo()) # \"a demo field\"\n```"]]