Fit taşıma rehberi

Google Fit API'lerinin desteği sonlandırıldı ve 2026'nın sonlarında hizmet sonlandırma planlanıyor. Google, desteğin sonlandırılmasının ardından kullanıcılarınızın hedeflerine ulaşmaya devam etmelerine yardımcı olmak için çeşitli sağlık ve sağlıklı yaşam ürünleri ve hizmetleri sunar.

Dikkat: Google Fit API'sinin (REST API dahil) desteği yalnızca 2026'nın sonuna kadar devam edecek. Bulut tabanlı entegrasyonlar için Google Health API'ye, adım takibi ve mobil öncelikli uygulamalar için ise Health Connect'e geçmenizi öneririz.

Aşağıdaki yönergeler, Google Fit API'lerini nasıl kullandığınıza bağlı olarak hangi hizmete geçeceğinizi gösterir.

API seçiminizi uygulama türünüze ve belirli veri ihtiyaçlarınıza göre yapmalısınız.

Uygulama Türüne Göre

Uygulama Türü Önerilen yol Birincil Neden
Adım İzleme Uygulaması Health Connect Çeşitli kaynaklardan toplanan adım verilerinin mobil cihazlarda okunması.
Fitness Takip Cihazları Tamamlayıcı Uygulaması Google Health API Kullanıcı entegrasyonu için OAuth gerektiren web merkezli platform.
Sağlık ve Fitness Platformu Google Health API ve Health Connect Fitbit/Google cihaz verileri için Google Health API'yi, cihaz üzerinde toplanan veriler için ise Health Connect'i kullanın.

Mevcut entegrasyonla

Mevcut Entegrasyon Önerilen yol Kullanılabilirlik
Google Fit (Android ve REST API) Google Health API Kullanılabilir
Mobil adımları okuma (Google Fit Recording API ile) ve geri yükleme Kullanılabilir
Wear OS'te Fit API Sağlık Hizmetleri Kullanılabilir
Fitbit Web API Google Health API Kullanılabilir
Mobil cihazlarda Recording API ve geri yükleme Kullanılabilir
ve geri yükleme Mevcut entegrasyonu koruma veya Google Health API'yi ekleme Kullanılabilir

Teknik karşılaştırmalar

Aşağıdaki bölümlerde, doğru taşıma yolunu seçmenize yardımcı olmak için Google Fit API'leri, Google Health API ve Health Connect arasında teknik bir karşılaştırma sunulmaktadır.

Fit API ile Google Health API karşılaştırması

Uygulamanız web tabanlı bir platformsa veya sunucudan sunucuya (S2S) etkileşim gerektiriyorsa bu yolu kullanın.

Özellik Fit API (Android/REST) Google Health API
Proje Ayarları Google Cloud Console Google Cloud projesi oluşturma
OAuth Yapılandırması Android veya web uygulaması türü Web uygulaması türü
Veri Mimarisi com.google önekli türler Birleştirilmiş Google Health API veri türleri
Uygulama Kaydı Google Cloud projesi oluşturun Google Cloud projesi oluşturma ve Google Health API'yi etkinleştirme

Fit API ve Health Connect karşılaştırması

Yerel cihaz metriklerini okuyan mobil öncelikli Android uygulamaları için bu yolu kullanın.

Özellik Android için Fit API ve geri yükleme
Kayıt Google Cloud Console Play Store projesi ve sağlık uygulamaları beyanı
Kimlik doğrulama OAuth 2.0 gerekli OAuth gerekmez (cihaz üzerindeki izinler)
Veri depolama Bulut odaklı Cihaz merkezli (cihaz üzerinde)
Kitle Eski Android geliştiricileri Modern Android mobil geliştiricileri
İzinler OAuth kapsamları Android manifest izinleri

Fit API entegrasyonları

Aşağıdaki bölümlerde, Google Fit API'lerinin her birinden geçişle ilgili yönergeler verilmektedir. Entegrasyonunuzda Google Fit uygulamasına bağlanan kullanıcı arayüzü öğeleri de varsa ek bilgiler için Fit uygulaması entegrasyonu yönergelerine bakın.

Adımları kaydetmek için Fit Recording API'yi kullanan uygulamalar

Fit Recording API, uygulamanızın abonelik oluşturarak sensör verilerinin otomatik olarak ve pil tasarrufu sağlayacak şekilde depolanmasını istemesine olanak tanır. Her abonelik, bir Android uygulamasını belirli bir fitness verisi türüne veya veri kaynağına bağlar. Step veri türü genellikle adımları kaydetmek için kullanılır.

Fit Recording API'den geçiş yapmak için aşağıdaki adımları uygulayın:

Tablo 1: Fit Recording API'den geçiş adımları
Telefon Wear
  1. Toplam adım sayısını göstermek için uygulamanıza Health Connect'i ekleyin. Toplam sayıya mobil adımlar (Android 14 veya sonraki sürümler) ile diğer uygulamalardan ve cihazlardan alınan adımlar dahildir.
  2. Uygulamanızda yerel adımlar verilerini göstermeye devam etmek için Health Connect'in Write API'sini kullanarak veri yazma özelliğini uygulayın.

Sağlık Hizmetlerini kullanın:

  • PassiveMonitoringClient
  • ExerciseClient

İkisi arasındaki farklar hakkında daha fazla bilgi için Sağlık Hizmetleri dokümanlarına bakın.

Fitness deposuna veri okumak veya yazmak için History API'yi kullanan uygulamalar

History API, uygulamanızın fitness deposunda toplu işlemler gerçekleştirmesine olanak tanır. Bu işlemler arasında geçmiş sağlık ve sağlıklı yaşam verilerinin okunması, eklenmesi, güncellenmesi ve silinmesi yer alır.

History API'den geçiş yapmak için aşağıdaki adımları uygulayın:

Tablo 2: Fit History API'den geçiş adımları
Telefon Wear

Google Health API'ye geçiş.

Geçerli değil. Health Connect'i giyilebilir cihazdan değil, mobil uygulamanızdan kullanın.

Gerçek zamanlı fitness verilerini göstermek için Sensor API'yi kullanan uygulamalar

Sensor API, uygulamanızda ham sensör verilerini gerçek zamanlı olarak okumanıza olanak tanır. Sensor API şunları yapar:

  • Cihazda ve yardımcı cihazlarda kullanılabilen veri kaynaklarını listeler.
  • Ham sensör verilerini almak için dinleyicileri kaydeder.
  • Dinleyicilerin kaydını siler, böylece artık ham sensör verileri almazlar.

Sensor API'den geçiş yapmak için aşağıdaki adımları uygulayın:

Tablo 3: Fit Sensor API'den geçiş adımları
Telefon Wear

Sensörler, Çok Kaynaklı Konum Sağlayıcı API'yi kullanma

Wear OS'te Sağlık Hizmetleri'ni kullanın:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Alternatif olarak SensorManager, FusedLocationProvider hesabını kullanın.

Aktivite özetleri sunmak için Session API'yi kullanan uygulamalar

Seanslar, kullanıcıların fitness etkinliği yaptığı zaman aralığını ifade eder.

Session API, uygulamanızın fitness mağazasında seans oluşturmasına olanak tanır.

Session API'den geçiş yapmak için aşağıdaki adımları uygulayın:

Tablo 4: Fit Session API'den geçiş adımları
Telefon Wear

Başlatma/durdurma: Geçerli değil. Uygulama, devam eden seansların durumunu dahili olarak izlemelidir.

Okuma/yazma: Google Health API'ye geçiş.

Başlatma/durdurma: Sağlık Hizmetleri'ni (ExerciseClient) kullanın.

Okuma/yazma: Health Connect'i mobil uygulamanızla birlikte kullanın.

Belirli iş akışları için şunları öneririz:

  • Seans ekleme: Geliştiriciler, Health Connect'i mobil uygulamalarıyla birlikte kullanmalı ve buna göre ExerciseSessionRecord veya SleepSessionRecord eklemelidir.

Goals API'yi kullanan uygulamalar

Hedefler, Google Fit uygulamasında kullanıcıların adımlar ve kardiyo puanı gibi metrikleri için belirleyebileceği hedeflerdir. Fit platformu, Goals API'yi kullanarak hedefleri kaydeder ve günlük aktiviteleri bu hedeflere göre takip eder.

Tablo 5: Fit Goals API için geçiş rehberi
Telefon Wear
Yerine kullanılabilecek bir API yok. Yerine kullanılabilecek bir API yok.

BLE API'yi kullanan uygulamalar

Uygulamanız, BLE API' aracılığıyla kullanılabilir Bluetooth Düşük Enerji (BLE) cihazlarını bulabilir ve sensör verilerini Google Fit platformuna ekleyebilir.

BLE API'den geçiş yapmak için aşağıdaki adımları uygulayın:

Tablo 6: Fit BLE API'den geçiş adımları
Telefon Wear
Android Bluetooth API'lerini doğrudan kullanın. Android Bluetooth API'lerini doğrudan kullanın.

Kullanımdan kaldırılan özellikler

Aşağıdaki özelliklerin doğrudan API karşılığı yoktur. Önerilen Android standart API'lerini kullanın:

  • Sensor API: Gerçek zamanlı ham veriler için Android Sensors çerçevesini veya Fused Location Provider API'yi kullanın.
  • Goals API: Yerini alacak bir API yok. Uygulama mantığınızda hedef izleme ve günlük aktivite hedeflerini yönetin.
  • Bluetooth Düşük Enerji (BLE) API'si: Donanımla iletişim kurmak için doğrudan Android Bluetooth API'lerini kullanın.

Fit uygulaması entegrasyonları

Uygulamanız veri paylaşımı için Google Fit'e bağlanıyorsa aşağıdaki bölümlerde mevcut ve yeni kullanıcıları Health Connect'e veya Google Health API'ye taşıma ile ilgili talimatları uygulayın:

Uygulamanızın mevcut kullanıcıları

Uygulamanızın kullanıcı arayüzünde kullanıcıların Google Fit'e bağlanmasına olanak tanıyan bir yöntem varsa (veya uygulamanız Google Fit ile çalışan uygulamalar listesinde yer alıyorsa) mevcut kullanıcılar için Fit uygulaması entegrasyonunuzu sürdürmeye devam edebilirsiniz.

Bu bölümü, Fit uygulaması entegrasyonunuzun desteğini ne zaman sonlandıracağınız ve kullanıcı deneyiminizi korumak için en iyi seçenekleriniz hakkında bilgilerle güncel tutacağız. Bu süre zarfında bizimle iletişime geçebilirsiniz.

Tablo 7: Fit uygulaması entegrasyonu olan mevcut kullanıcılar için öneriler
checkBunu yapın kapatBunu yapmayın
Uygulamanızda yeni bir seçenek olarak Health Connect'i veya Google Health API'yi sunun.

Daha zengin veriler ve analizler, gizlilik ve güvenlik gibi kullanıcı avantajlarına odaklanın.

Health Connect ile senkronize etme

Kullanıcılardan Google Fit ile bağlantılarını kesmelerini isteyin.

Health Connect'in bağlantısını kaldırma

Uygulamanızın yeni kullanıcıları

Uygulamanızın yeni kullanıcılarına benzer bir deneyim sunmak için Health Connect veya Google Health API ile entegrasyon oluşturmanızı öneririz.

Health Connect, kullanıcıların daha zengin bir deneyim yaşayabilmesi için yeni veri kaynaklarına ve türlerine erişim sunar. Veriler cihaz üzerinde güvenli bir şekilde saklanır. Google Health API, Fitbit ve Google cihaz verileri için web merkezli bir platform sağlar.

Tablo 8: Fit uygulaması entegrasyonlarını kullanan yeni kullanıcılara yönelik öneriler
checkBunu yapın kapatBunu yapmayın
Uygulamanızın kurulum akışına Health Connect'i veya Google Health API'yi ekleyin. Health Connect kullanıma sunulduktan sonra kullanıcıların bağlanabileceği bir uygulama olarak Fit'i sunun.