Quickstart using 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:

  1. Create a Cloud Healthcare API dataset.
  2. 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
  3. Store DICOM or FHIR data, and view FHIR resource contents.

If you are 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.

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.

    Go to project selector

  • Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

  • In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  • Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

  • Enable the Cloud Healthcare API.

    Enable the 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.

    1. In the Cloud Console, click Healthcare to go to the Datasets page.

      Go to Browser

    2. Click Create dataset.

    3. In the Name field, enter my-dataset.

    4. In the Region field, select us-central1, and then click Create.

    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:

    1. Create a DICOM store.
    2. Import a DICOM instance into the DICOM store.

    The Cloud Healthcare API implements the DICOMweb standard to store and access medical imaging data. The Cloud Console does not support DICOMweb transactions, such as viewing or retrieving instances.

    Create a DICOM store

    1. In the Cloud Console, go to the Cloud Healthcare API Browser page:

      Go to Browser

    1. Click the my-dataset dataset.

    2. Click Create data store.

    3. In the Type menu, select DICOM.

    4. In the ID field, enter my-dicom store.

    5. 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.

    1. In the list of data stores in your dataset, find the DICOM store that you created, and then select the Actions menu.

    2. Select Import.

    3. In the Import to DICOM store page, select the Advanced options menu, and then select Override Cloud Storage path.

    4. 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
      
    5. Click Import.

    6. 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:

    1. Create a FHIR store.
    2. Import FHIR resources into the FHIR store.
    3. View the FHIR resources' data.

    The Cloud Healthcare API implements the FHIR specification to store and access FHIR data. The 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

    1. Click Browser to go to the Datasets page.

    2. Click the my-dataset dataset.

    3. Click Create data store.

    4. In the Type menu, select FHIR.

    5. In the ID field, enter my-fhir-store.

    6. To open the Configure your FHIR store section, click Next.

    7. Click R4.

    8. 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.

    1. In the list of data stores in your dataset, find the my-fhir-store FHIR store you created, and then select the Actions menu.

    2. Select Import.

    3. Select the Advanced options menu, and then select Override Cloud Storage path.

    4. 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
      
    5. In the FHIR import settings section, select Resource.

    6. Click Import.

    7. 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

    1. In the Cloud Console, go to the FHIR viewer page.

      Go to the FHIR viewer

    1. In the FHIR store drop-down list, select the my-dataset dataset, and then select the my-fhir-store FHIR store.

    2. Click the Resource Type field. In the Properties drop-down list that appears, select Resource type, and then enter Patient.

    3. Click Patient in the Resource type list.

    4. 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.

    Create an HL7v2 store

    This section shows how to create an HL7v2 store.

    The Cloud Healthcare API HL7v2 implementation doesn't support working with HL7v2 messages. After creating the HL7v2 store in this section, continue to Creating and managing HL7v2 messages to create or ingest HL7v2 messages.

    HL7v2 stores exist inside datasets and hold HL7v2 messages.

    1. Click Browser to go to the Datasets page.

    2. Click the my-dataset dataset.

    3. Click Create data store.

    4. In the Type menu, select HL7v2.

    5. In the ID field, enter my-hl7v2-store.

    6. Click Create.

    The my-hl7v2-store HL7v2 store displays in the Data stores page in the my-dataset dataset.

    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:

    1. Click Browser to go to the Datasets page.
    2. Click Actions next to the dataset, and then click Delete.
    3. 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 gcloud command-line tool:

    DICOM

    Continue to the DICOM guide to read topics such as the following:

    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:

    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: