Dokumentacja medyczna

Platforma Health Connect udostępnia różne typy danych, które w większości obejmują przypadki użycia związane z dobrym samopoczuciem i aktywnością fizyczną. Umożliwia to aplikacjom w ekosystemie Androida udostępnianie danych bez konieczności kosztownych integracji interfejsów API typu „jeden do jednego”.

Dokumentacja medyczna rozszerza tę funkcję o podstawowe dane medyczne w formacie Fast Healthcare Interoperability Resources (FHIR®). FHIR to globalna specyfikacja typu open source opisująca schemat i semantykę danych medycznych opublikowana przez HL7 (Health Level Seven International).

Funkcje dokumentacji medycznej w Health Connect:

  • Interfejs API dla aplikacji zapisujących dane medyczne.
  • Przeglądarka dla użytkowników, w której można wyświetlać dane medyczne przechowywane w Health Connect jako nowe typy danych medycznych, wraz z precyzyjnymi uprawnieniami umożliwiającymi odczyt danych w dalszych etapach.
  • Interfejs API dla aplikacji odczytujących dane medyczne na podstawie uprawnień przyznanych przez użytkownika.
Omówienie działania dokumentacji medycznej w Health Connect.
Rysunek 1. Jak dokumentacja medyczna działa z Health Connect.

Ograniczenia

Te interfejsy API są nadal w fazie rozwoju, więc mają pewne ograniczenia i niektóre komponenty nie są w pełni dostępne.

Interfejsy API do obsługi dokumentacji medycznej są oznaczone adnotacją ExperimentalPersonalHealthRecordApi, która wskazuje, że te interfejsy API są nadal w fazie rozwoju i mogą ulec zmianie.

Istnieją jednak pewne ograniczenia, a niektóre komponenty nie są w pełni dostępne:

  • Zasady Google Play dotyczące dostępu do dokumentacji medycznej są w trakcie opracowywania, a aplikacje mogą wymagać spełnienia dodatkowych wymagań, zanim zostaną opublikowane w Sklepie Play.
  • Niektóre funkcje, takie jak interfejsy API oparte na dziennikach zmian, nie zostały jeszcze opracowane w przypadku interfejsów API dokumentacji medycznej.

Rozpocznij

Dokumentacja medyczna to zestaw nowych typów rekordów w Health Connect, więc w jej przypadku obowiązuje ten sam proces, co w przypadku rozpoczęcia korzystania z Health Connect. Więcej informacji znajdziesz w artykule Pierwsze kroki z Health Connect.

Jeśli korzystasz z interfejsów API platformy dokumentacji medycznej, które były dostępne na początku, zdecydowanie zalecamy przejście na Jetpack z tych powodów:

  • Wszystkie przewodniki i przykłady kodu są napisane z myślą o Jetpacku.
  • Narzędzia ekosystemu korzystają z interfejsów API Jetpack
  • Interfejs API jest natywny dla języka Kotlin
  • Jetpack ma ulepszoną obsługę zgodności (np. interfejs Feature Availability API).

Interfejsy Medical Records API są udostępniane w Health Connect w wersji 1.1.0-beta02 w Jetpacku. Zaktualizowanie zależności Jetpack do tej wersji wymaga skompilowania aplikacji pod kątem pakietu SDK Androida 16.

Gdy skonfigurujesz aplikację i będziesz w niej pisać i odczytywać dane z dokumentacji medycznej, zapoznaj się z artykułami Zapisywanie danych medycznychOdczytywanie danych medycznych.

Interfejs użytkownika

W tej sekcji znajdziesz ogólne informacje o wrażeniach użytkowników.

Uprawnienia

Prośba o uprawnienia do odczytu lub zapisu dokumentacji medycznej działa podobnie jak w przypadku dotychczasowych ekranów uprawnień Health Connect, ale wyświetlany jest osobny ekran dokumentacji medycznej:

Ekran uprawnień dostępu do dokumentacji medycznej
Rysunek 2. Ekran uprawnień do dokumentacji medycznej

Przeglądanie danych

Health Connect umożliwia też podstawową wizualizację i przeglądanie przechowywanych danych o dokumentacji medycznej, podobnie jak w przypadku innych typów danych w tej aplikacji.

Ekran przeglądania danych dotyczących dokumentacji medycznej
Rysunek 3. Ekran przeglądania danych z dokumentacji medycznej