Store healthcare data with the Google Cloud console
This page shows you how to use the Cloud Healthcare API and the Google Cloud console to complete the following tasks:
- Create a Cloud Healthcare API dataset.
- Create one of the following data stores inside the dataset:
- Digital Imaging and Communications in Medicine (DICOM) store
- Fast Healthcare Interoperability Resources (FHIR) store
- Health Level Seven International Version 2 (HL7v2) store
- Store DICOM or FHIR data, and view FHIR resource contents.
If you're only interested in working with one type of data store, you can skip directly to that section of the quickstart after completing the steps in Before you begin and Create a dataset.
To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:
Before you begin
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Healthcare API.
Create a dataset
Datasets contain data stores, and data stores contain healthcare data. To use the Cloud Healthcare API, you must create at least one dataset.
In the Google Cloud console, click Healthcare to go to the Datasets page.
Click
Create dataset .In the
Name field, entermy-dataset
.In the
Region field, selectus-central1
, and then clickCreate .
The new dataset appears in the list of datasets in the browser.
To complete this quickstart, choose from one of the following sections:
Store a DICOM instance
This section shows how to complete the following tasks:
- Create a DICOM store.
- Import a DICOM instance into the DICOM store.
The Cloud Healthcare API implements the DICOMweb standard to store and access medical imaging data. The Google Cloud console does not support DICOMweb transactions, such as viewing or retrieving instances.
Create a DICOM store
In the Google Cloud console, go to the Cloud Healthcare API Browser page:
Click the
my-dataset
dataset.Click
Create data store .In the
Type menu, select DICOM.In the
ID field, entermy-dicom-store
.Click
Create .
The my-dicom-store
DICOM store displays in the Data stores page in the my-dataset
dataset.
Import a DICOM instance
Sample DICOM data is available in the gs://gcs-public-data--healthcare-nih-chest-xray
Cloud Storage bucket.
In the list of data stores in your dataset, find the DICOM store that you created, and then select the
Actions menu.Select Import.
In the Import to DICOM store page, select the Advanced options menu, and then select
Override Cloud Storage path .In the
Location field under the Advanced options menu, enter the following location of the DICOM instance you are importing:gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm
Click
Import .To track the status of the import, click the
Operations tab.If you encounter any errors, click
Actions , and then click View details in Cloud Logging.
Now that you've stored a DICOM instance in the Cloud Healthcare API, continue to What's next for information on next steps, such as how to search for or retrieve DICOM images.
Store and view FHIR resources
This section shows how to complete the following tasks:
- Create a FHIR store.
- Import FHIR resources into the FHIR store.
- View the FHIR resources' data.
The Cloud Healthcare API implements the FHIR specification to store and access FHIR data. The Google Cloud console does not support certain FHIR API methods, such as creating or deleting FHIR resources, but you can use the FHIR viewer to view the contents of FHIR resources.
Create a FHIR store
Click
Browser to go to the Datasets page.Click the
my-dataset
dataset.Click
Create data store .In the
Type menu, select FHIR.In the
ID field, entermy-fhir-store
.To open the Configure your FHIR store section, click
Next .Click
R4 .Click
Create .
The my-fhir-store
FHIR store displays in the Data stores page in the my-dataset
dataset.
Import FHIR resources
Sample FHIR data is available in the gs://gcp-public-data--synthea-fhir-data-10-patients
Cloud Storage bucket. The bucket contains a directory, fhir_r4_ndjson/
,
which contains several types of FHIR resources.
In the list of data stores in your dataset, find the
my-fhir-store
FHIR store you created, and then select theActions menu.Select Import.
Select the Advanced options menu, and then select
Override Cloud Storage path .In the
Location field under the Advanced options menu, enter the following location of the FHIR resources you are importing:gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson
In the
FHIR import settings section, select Resource.Click
Import .To track the status of the import, click the
Operations tab.If you encounter any errors, click
Actions , and then click View details in Cloud Logging.
View FHIR resource contents
In the Google Cloud console, go to the FHIR viewer page.
In the FHIR store drop-down list, select the
my-dataset
dataset, and then select themy-fhir-store
FHIR store.Click the
Resource Type field. In the Properties drop-down list that appears, select Resource type, and then enter Patient.Click
Patient in the Resource type list.Select one of the Patient resources that appears. To view more information about the Patient resource, click the Elements tab, or click the JSON tab to view the Patient resource details in JSON format.
Now that you've stored and viewed a FHIR resource in the Cloud Healthcare API, continue to What's next for information on next steps.
Store HL7v2 messages
This section shows how to complete the following tasks:
- Create an HL7v2 store.
- Import HL7v2 messages into the HL7v2 store.
Create an HL7v2 store
HL7v2 stores exist inside datasets and hold HL7v2 messages.
Click
Browser to go to the Datasets page.Click the
my-dataset
dataset.Click
Create data store .In the
Type menu, select HL7v2.In the
ID field, entermy-hl7v2-store
.Click
Create .
The my-hl7v2-store
HL7v2 store displays in the Data stores page in the my-dataset
dataset.
Import HL7v2 messages
Sample HL7v2 messages are available in gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson
.
In the list of data stores in your dataset, find the HL7v2 store that you created, and then select the
Actions menu.Select Import.
In the Import to HL7v2 store page, select the Advanced options menu, and then select
Override Cloud Storage path .In the
Location field under the Advanced options menu, enter the following location of the HL7v2 messages you are importing:gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson
Click
Import .To track the status of the import, click the
Operations tab.If you encounter any errors, click
Actions , and then click View details in Cloud Logging.
Now that you've created an HL7v2 store, continue to What's next for information on next steps, such as how to ingest and view HL7v2 messages.
Clean up
To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.
If you no longer need the dataset and data store created in this quickstart, you can delete the dataset. Deleting a dataset permanently deletes the dataset and any FHIR, HL7v2, or DICOM stores it contains.
To delete a dataset, complete the following steps:
- Click
Browser to go to the Datasets page. - Click
Actions next to the dataset, and then click Delete. - Confirm your deletion.
Or you can delete the project that you created.
What's next
See the following sections for general information on the Cloud Healthcare API and how to perform tasks using HTTP requests and the Google Cloud CLI:
- Read an overview of Cloud Healthcare API concepts.
- Use the Cloud Healthcare API with
curl
or PowerShell. - Use the Cloud Healthcare API with the gcloud CLI.
DICOM
Continue to the DICOM guide to read topics such as the following:
- Creating and managing DICOM stores
- Connecting a PACS to the Cloud Healthcare API
- Using the DICOMweb standard
- Importing and exporting DICOM data using Cloud Storage
See the DICOM conformance statement for information on how the Cloud Healthcare API implements the DICOMweb standard.
FHIR
Continue to the FHIR guide to read topics such as the following:
- Creating and managing FHIR stores
- Creating and managing FHIR resources
- Importing and exporting FHIR data using Cloud Storage
See the FHIR conformance statement for information on how the Cloud Healthcare API implements the FHIR standard.
HL7v2
Continue to the HL7v2 guide to read topics such as the following: