Get a Firestore document using custom types (async)
Stay organized with collections
Save and categorize content based on your preferences.
Get a Firestore document using custom types (async).
Explore further
For detailed documentation that includes this code sample, see the following:
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis content demonstrates how to retrieve a Firestore document using custom types asynchronously in Python.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication setup for Firestore is required, using Application Default Credentials for a local development environment.\u003c/p\u003e\n"],["\u003cp\u003eThe code sample illustrates how to access a document, convert it to a dictionary, and then into a custom \u003ccode\u003eCity\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eThe full documentation for this code sample can be found within the provided "Get data with Cloud Firestore" and "Getting data" links.\u003c/p\u003e\n"]]],[],null,["# Get a Firestore document using custom types (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Get data with Cloud Firestore](https://firebase.google.com/docs/firestore/query-data/get-data)\n- [Getting data](/firestore/native/docs/query-data/get-data)\n\nCode sample\n-----------\n\n### Python\n\n\nTo authenticate to Firestore, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n doc_ref = db.collection(\"cities\").document(\"BJ\")\n\n doc = await doc_ref.get()\n city = City.from_dict(doc.to_dict())\n print(city)\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=firestore)."]]