現在地を検索

マッピングアプリケーションを使用する主な理由の 1 つは、自分がどこにいるかを確認することです。

HERE SDK が提供するLocationEngineは、 GPS やその他のグローバル衛星ナビゲーションシステム（ GNSS ）受信機、モバイルネットワーク信号、 Wi-Fi ネットワーク信号などの複数の位置情報源と連携して正確な位置を判断する、包括的な位置情報ソリューションを実装しています。

iOS デバイス 自体が GNSS 精度に対応している場合は、 iOS デバイス のハードウェアに依存します。 サブメーターの精度は現在 iOS ではサポートされていないため、別のレシーバーが必要です。 Android デバイスでは、サブメーターの精度は、資格情報 が有効になっている場合にのみサポートされます ( 以下を参照 ) 。

必要な権限を追加

フラッター自体には、権限の処理はありません。 そのため、 Android および iOS のネイティブプロジェクト用に、生成されたファイルをいくつか調整する必要があります。

まず、 Android を使用してみましょう。

Android デバイスのアプリでのLocationEngineの使用を開始する前に、アプリ のAndroidManifest.xmlファイルに必要な権限を追加する必要があります（ _PROJECT_dir/Android/app/src/main/ にあります）。

...
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

次に、 iOS に移動します。

アプリ Info.plist のファイルに追加 します（ _PROJECT_dir/ios/Runner/に あります）。

<key>UIRequiredDeviceCapabilities</key>
<array>
   <string>location-services</string>
   <string>gps</string>
</array>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
   <string>This app needs to access your current location to display it on the map.</string>
<key>NSLocationWhenInUseUsageDescription</key>
   <string>This app needs to access your current location to display it on the map.</string>
<key>NSMotionUsageDescription</key>
   <string>Motion detection is needed to determine more accurate locations, when no GPS signal is found or used.</string>

permission_handler プラグインを使用して、ユーザーから特定の権限を要求できます。 詳細については、プラグインの公式サイトを参照してください。 または、 HERE SDK for iOS for the HERE SDK for Android and 開発者ガイド for the 開発者ガイドの「 Find Your Location 」セクションで、権限を要求するためのプラットフォーム固有のコードを見つけることもできます。

GPS などのネイティブの位置情報サービスを使用するアプリは、ユーザーの許可を要求します。 すべてのデバイスが同じ機能を提供しているわけではありません。また、特定のハードウェアの制約があるため、結果が異なる可能性があります。

を使用する前 LocationEngineに、ネイティブの位置情報サービスが有効になっているかどうかを確認することをお勧めします。 ほとんどの Android デバイスでは、ユーザーが位置情報サービスをオンにすることを選択できます。さらに、デバイスの [ 設定 ] を開き、 [ セキュリティと位置情報 ] セクションに移動することで、精度を上げることもできます。 ほとんどの iOS デバイスでは、ユーザーは [ 設定 ] > [ プライバシー ] > [ 位置情報サービス ] の順に移動して位置情報サービスがオンになっていることを確認できます。

情報収集の可否に関するユーザーの同意の処理

に LocationEngine は、 HERE SDK が使用する HERE サービスを改善するために、モバイル機器の周辺についての特定の情報を収集できる機能が含まれています。 そのような情報の例として、近くの Wi-Fi およびモバイルネットワークの信号の強度があります。

HERE SDK は ConsentEngine 、ユーザーがデータを収集することに同意したことを取得するためのフローを処理するを提供します。 さらに、現在のステータスを取得し、データを収集するかどうかを判断する前の決定を削除できます。 アプリケーションは、ユーザーがいつでもアクセスできるようにする必要があります。

ローカリゼーションの設定中です

承諾エンジンは、最大 31 の言語をサポートしています。 ダイアログが表示されたときに使用された言語は、現在のデバイスの言語設定に基づいて自動的に選択されます。 デバイスの言語がサポートされている言語でない場合は、代わりに英語が使用されます。 以下のコード スニペットでは、ローカライズされた承諾ダイアログをサポートするようにアプリケーションを設定する方法を示します。

// File: main.dart

import 'package:flutter/material.dart';
import 'package:here_sdk/consent.dart';

import 'PositioningExample.dart';

// ...

void main() {
    runApp(
        MaterialApp(
            // Add consent localization delegates.
            localizationsDelegates: HereSdkConsentLocalizations.localizationsDelegates,
            // Add supported locales.
            supportedLocales: HereSdkConsentLocalizations.supportedLocales,
            home: MyApp(),
        ),
    );
}

// ...

class MyApp extends StatefulWidget {
    @override
    PositioningExample createState() => PositioningExample();
}

ユーザーの同意を要求しています

LocationEngineを開始する前 に、前述の情報を収集するユーザーの同意が得られていることを確認する必要があります。 回答の内容に関係なく ( ユーザーがデータの収集を承諾したかどうかに関係なく ) 、承諾ダイアログが表示され、回答が提供されたことのみが該当します。 LocationEngineは、ユーザーの同意を得ずに開始しようとすると、LocationEngineStatus.USER_CONSENT_NOT_HANDLEDステータスを返します。

以下のコード スニペットは、 ConsentEngineのインスタンスを作成し、ユーザーの同意がすでに要求されているかどうかを確認します。要求されていない場合は、ユーザーに収集された情報の詳細を説明する UI ダイアログ ( 以下の図も参照 ) を呼び出します。 権限を付与または拒否することができます。

try {
  _consentEngine = ConsentEngine();
} on InstantiationException {
  throw ("Initialization of ConsentEngine failed.");
}

// ...

Future<void> _ensureUserConsentRequested() async {
  // Check if user consent has been handled.
  if (_consentEngine.userConsentState == ConsentUserReply.notHandled) {
    // Show dialog.
    await _consentEngine.requestUserConsent(context);
  }

  _updateConsentInfo();
  _startLocating();
}

マップ シーンのロード中は、requestUserConsent()を呼び出さないことをお勧めします。

のコード _updateConsentInfo() は HERE の外にあります。 基本的に、ユーザーの現在の承諾の決定が表示されます。

このダイアログには、 HERE のプライバシープラクティスについて説明した Web ページへのリンクが含まれており、 37 言語をサポートしています。 表示されているダイアログは、デバイスの言語設定に従って表示されます。サポートされていない場合は、英語で表示されます。

ユーザーの応答は、アプリケーションの使用セッション間で保持され、 userConsentState プロパティを使用して取得できます。このプロパティは Consent.UserReply 、次の値を返します。

switch (_consentEngine.userConsentState) {
  case ConsentUserReply.granted:
    //The user has previously given permission.
    break;
  case ConsentUserReply.denied:
    // The user has previously denied permission.
    break;
  case ConsentUserReply.notHandled:
    //The user has not been asked for consent.
    break;
  case ConsentUserReply.requesting:
    //The dialog is currently being shown to the user.
    break;
  default:
    throw Exception("Unknown consent state.");
}

アプリケーションは、プロパティにアクセスして、ユーザーが以前に入力した応答を参照できるようにする必要 userConsentState があります。 また、 requestUserConsent() このアプリケーションでは、メソッドを呼び出して承諾ダイアログを再度表示することで、いつでもユーザーが同意についての考え方を変更できるようにする必要があります。

Android で requestUserConsent() は、が呼び出されると、 HERE SDK に Activity ダイアログを含む新しいが表示されます。 ダイアログが閉じると、前の Activity ダイアログが再開されます。 MapView ダイアログを開く前にが表示 MapView されている場合、は再び表示されるまで一時停止されます。

// ...

// Platform class from dart:io library provides a way to check on what platform your app is running.
import 'dart:io' show Platform;

// ...

class ConsentPreferencesPage extends StatefulWidget {
  ConsentPreferencesPage({Key key, this.title}) : super(key: key);

  final String title;

  @override
  State<ConsentPreferencesPage> createState() {
    //Use different states according to the platform the app is running on.
    if (Platform.isAndroid) {
      return _ConsentPreferencesPageAndroid();
    }
    return _ConsentPreferencesPageOther();
  }

// ...

// This state shows what response the user has given to the consent, by accessing the consentEngine.userConsentState property. Additionally, it allows the user to change their mind on the consent by including a button "Manage Consent" that calls the requestUserConsent() method and displays the consent dialog again.
class _ConsentPreferencesPageAndroid extends State<ConsentPreferencesPage> with WidgetsBindingObserver {
  try {
    _consentEngine = ConsentEngine();
  } on InstantiationException {
    throw ("Initialization of ConsentEngine failed.");
  }

  String _getConsentAnswer() {
    switch (_consentEngine.userConsentState) {
      case ConsentUserReply.granted:
        //The user has previously given permission.
        return "You have granted consent to the data collection.";
      case ConsentUserReply.denied:
        // The user has previously denied permission.
      case ConsentUserReply.notHandled:
        //The user has not been asked for consent.
      case ConsentUserReply.requesting:
        //The dialog is currently being shown to the user.
        return "You have denied consent to the data collection.";
      default:
        throw Exception("Unknown consent state.");
    }
  }

  // ...

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Container(
        margin: const EdgeInsets.only(left: 25, right: 25),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Flexible(
                child: Text(
                    'The Location Engine contains functionality that can gather certain '
                        'information about the surroundings of the mobile device in order '
                        'to improve the HERE services used by the HERE SDK. An example '
                        'of such information is the strength of the nearby Wi-Fi and '
                        'mobile network signals.'
                ),
            ),
            SizedBox(height: 20),
            Flexible(
                child: Text(
                    _getConsentAnswer(),
                ),
            ),
            SizedBox(height: 20),
            PlatformButton(
                child: const Text("Manage Consent"),
                onPressed: () {
                  setState(() {
                    _consentEngine.requestUserConsent(context);
                  });
                }
            ),
          ],
        ),
      ),
    );
  }

// ...

// This state informs the user that there is currently no data collection.
class _ConsentPreferencesPageOther extends State<ConsentPreferencesPage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Container(
        margin: const EdgeInsets.only(left: 25, right: 25),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Flexible(
              child: Text('This app does not collect any data on this platform.'),
            ),
          ]
        )
      )
    );
  }
}

承諾ダイアログのカスタマイズ

LocationEngineを使用するには、ユーザーの同意を要求する必要があります。 既定では、上記の API を使用してこの問題が発生します。

ダイアログの外観と内容をカスタマイズできます。 このためには、 HERE に、アプリケーション独自にカスタマイズしたユーザーの同意ダイアログを証明するよう依頼します。 証明書を受け取ると、アプリケーションは grantUserConsent() と denyUserConsent() のメソッドを使用して HERE SDK に対するユーザーの応答を伝達できます。HERE が、アプリケーションによってカスタムダイアログを開始できることを承認した場合、requestUserConsent() の呼び出しは不要になります。 通信したユーザーの応答は HERE SDK によって保持 getUserConsentState() され、メソッドを使用して以前に指定した応答を取得できます。

特定の事前要件の下で、別の方法で承諾の決定を要求または更新することも可能です。 たとえば、ユーザーがすでに外部の Web サイトで承諾を付与している場合です。 ただし、ソリューションについては、 HERE チームと個別に話し合う必要があります。

このオプションの詳細について確認 するか、または HERE の営業担当者またはヘルプページから HERE に連絡して認定プロセスを開始してください。

LocationEngine を作成します

LocationEngine の新規作成は簡単です。

try {
  _locationEngine = LocationEngine();
} on InstantiationException {
  throw ("Initialization of LocationEngine failed.");
}

最後に確認した場所を取得

エンジンが初期化されると、少なくとも 1 回前にエンジンが始動し、少なくとも 1 つの位置を受信している限り、最後に確認された位置を取得できます。そうでない場合、null が返されます。 この情報は残ります。したがって、最後に確認された場所もアプリケーションセッション間で利用できます。

Location? myLastLocation = _locationEngine.lastKnownLocation;

if (myLastLocation != null) {
    // Log the last known location coordinates.
    print("Last known location: " + myLastLocation.coordinates.latitude.toString() + ", " + myLastLocation.coordinates.longitude.toString());
}

位置情報イベントに関する通知を受信

次に、 LocationEngine を開始する前に LocationStatusListener を登録して、エンジンのステータスの変更が通知されるようにすることをお勧めします。 そのためには LocationStatusListener 、抽象クラスを実装し、 Location Engine addLocationStatusListener() のメソッドに登録します。 さまざまなステータスの詳細については、 API リファレンス を確認してください。

class PositioningExample extends State<MyApp> implements LocationStatusListener {

  @override
  onFeaturesNotAvailable(List<LocationFeature> features) {
    for (var feature in features) {
      print("Feature not available: " + feature.toString());
    }
  }

  @override
  onStatusChanged(LocationEngineStatus locationEngineStatus) {
    print("LocationEngineStatus: " + locationEngineStatus.toString());
  }

// ...

// Add the listener.
_locationEngine.addLocationStatusListener(this);

また、リスナー onFeaturesNotAvailable() のコールバック を通じて LocationFeature 、利用できないものがあれば通知されます。 必要な機能が利用できない場合は、HERE の担当者にご連絡ください。

エンジンを始動する前に考慮すべき最後の作業は、LocationListenerを登録することです。これにより、新しいLocationが検出されたときに通知を送信するonLocationUpdated()コールバックが提供されます。 これは、前述のLocationStatusListenerと同様の方法で行うことができます。

class PositioningExample extends State<MyApp> implements LocationListener {
    @override
    onLocationUpdated(Location location) {
        print("Received location: " + location.coordinates.latitude.toString() + ", " + location.coordinates.longitude.toString());
    }

// ...

// Add the listener.
_locationEngine.addLocationListener(this);

現在の地理座標およびタイムスタンプを除き、その他 Location のすべてのフィールドはオプションです。 たとえば、受信 したオブジェクトLocation には、ベアリング角度および現在の速度に関する情報が含まれている場合がありますが、この情報は利用できることは保証されていません。 使用できない値は、として返さ nullれます。 ポジショニングに使用されるソースの種類（ エンジンの始動に使用されるLocationAccuracyによって定義されます。以下の「 Start and Stop Receiving Locations 」セクションを参照してください）と、デバイスの機能が利用可能なフィールドに影響を与えます。

それぞれのaddLocationStatusListener()メソッドおよびaddLocationListener()メソッドを呼び出して、必要なだけLocationStatusListenerおよびLocationListenerを追加できます。

受信地点の開始および停止

LocationEngineの startWithLocationAccuracy() メソッドを呼び出す準備ができました。

class PositioningExample extends State<MyApp> implements LocationListener, LocationStatusListener {
    try {
      _locationEngine = LocationEngine();
    } on InstantiationException {
      throw ("Initialization of LocationEngine failed.");
    }

    try {
      _consentEngine = ConsentEngine();
    } on InstantiationException {
      throw ("Initialization of ConsentEngine failed.");
    }

// ...

    if (_consentEngine.userConsentState == ConsentUserReply.notHandled) {
        await _consentEngine.requestUserConsent(context);
    }

    _updateConsentInfo();
    _startLocating();

// ...

void startLocating() {
    _locationEngine.addLocationListener(this);
    _locationEngine.addLocationStatusListener(this);
    _locationEngine.startWithLocationAccuracy(LocationAccuracy.bestAvailable);
}

エンジンを始動する最も簡単な方法は、上記のコード スニペットのように、定義済みのモードの 1 つLocationAccuracyを渡すことです。 使用可能なすべてのモードの詳細については、次の表を参照するか、 API リファレンス を確認してください。

LocationEngineが開始された後、最初にstop()をコールしないで、再度開始しようとすると、LocationEngineStatus.alreadyStartedが届きます。 このメソッドisStarted() を使用して、エンジンが始動しているかどうかを確認できます。 同様に、LocationEngineを開始し、最初のを停止せずに別のを開始しようとすると、LocationEngineStatus.alreadyStartedエラーが発生します。 一度に始動できるエンジンは 1 つだけです。

位置情報の更新をこれ以上受信したくない場合 stop() は、メソッドを呼び出してエンジンを停止できます。 不要になったリスナーは必ず削除してください。

void stopLocating() {
    _locationEngine.removeLocationStatusListener(this);
    _locationEngine.removeLocationListener(this);
    _locationEngine.stop();
}

一般 的に、アプリの廃棄時に、AppLifecycleStateを聴いてLocationEngineを停止することをお勧めします。 GitHub の例については、positioning_appを参照してください。

iOS デバイスで停止中に更新を一時停止します

iOS デバイスで LocationEngine は、はデフォルトで、位置情報の変更が予期されない場合に位置情報の更新を一時停止します。 これを使用すると、たとえば、デバイスが静止しているときのバッテリー寿命を改善できます。 この機能は、メソッドで制御 LocationEngine.setPauseLocationUpdatesAutomatically()できます。

バックグラウンド更新を有効化

アプリケーションがバックグラウンドで実行されているときに位置情報の更新を引き続き受信する場合は、まず必要な権限を追加してこの機能を有効にする必要があります。 Android では、 Android 10 （ API レベル 29 ）以上を対象とする場合にのみ必要です。 アプリ AndroidManifest.xml のファイルに次の権限を追加します。

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Android 14 以降をサポートする FOREGROUND_SERVICE_LOCATION には、権限も必要です。

また、 Android API レベル 29 以上の Android デバイスでアプリをバックグラウンドで実行し続ける場合は、フォアグラウンドサービスまたは同等のサービスを開始する必要があります。 バックグラウンド位置情報を要求する Android では、フォアグラウンド位置情報の権限を要求するのとは異なることに注意してください。 詳細については、 Android のドキュメントを参照してください。 アプリ のポジショニング例 では、 Android 29 以降でのバックグラウンドポジショニングのサポート方法はまだ示されていません。

iOS では、アプリ Info.plist のファイルに次のキーを追加することで、バックラウンド更新を有効にできます。

<key>UIBackgroundModes</key>
    <array>
        <string>location</string>
        <string>processing</string>
    </array>

iOS バージョン 13.0 以降では、「処理」モードが必要です。 追加する場合は、次のものも必要です。

<key>BGTaskSchedulerPermittedIdentifiers</key>
    <array>
        <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
    </array>

詳細については、 iOS のドキュメントを参照してください。

ユーザーに自動化を要求する必要があることに注意してください。 ユーザーに権限を要求する方法については、 [ 必要な権限を追加 ] セクションを参照してください。

自動化がクリアされると、すべての設定が完了します。 iOS デバイスで LocationEngine.setBackgroundLocationAllowed() は、メソッドを使用してバックグラウンドで位置情報の更新を有効または無効にできます。 また、 iOS デバイスでは、メソッドを使用 LocationEngine.setBackgroundLocationIndicatorVisible()して、アプリケーションのバックグラウンド位置情報インジケータの表示範囲を設定できます。

iOS デバイスの最終確認では、デバイスが停止しているときに、 LocationEngine.setPauseLocationUpdatesAutomatically() メソッドに渡された false 位置情報の更新が一時停止しないようにします。

AppLifecycleState また、バックグラウンド更新が有効になっている場合は、を聴くことをお勧めします。

Android デバイスで位置情報オプションを指定します

Android デバイスをターゲットにしている場合に、場所の生成時に考慮するオプションをより細かく制御するには、 LocationOptions オブジェクトを作成し、好みに合わせて設定してから、 startWithLocationOptions(locationOptions) メソッドを呼び出してエンジンを開始します。

// ...

// Create a new LocationOptions object. By default all options are enabled.
LocationOptions locationOptions = LocationOptions();

// Use WiFi and satellite (GNSS) positioning only.
locationOptions.wifiPositioningOptions.enabled = true;
locationOptions.satellitePositioningOptions.enabled = true;
locationOptions.sensorOptions.enabled = false;
locationOptions.cellularPositioningOptions.enabled = false;

// Receive a location approximately every minute, but not more often than every 30 seconds.
locationOptions.notificationOptions.smallestIntervalMilliseconds = 30000;
locationOptions.notificationOptions.desiredIntervalMilliseconds = 60000;

_locationEngine.startWithLocationOptions(locationOptions);

// ...

次の表に、使用可能 LocationAccuracy なモードの概要、 LocationOptions および Android での内部変換方法、 CLLocationAccuracy および iOS でのモードへの内部変換方法を示します。

Android デバイスでのサブメーターナビゲーション

Android デバイスをターゲットにしている場合 、LocationEngine with LocationAccuracy.subMeterNavigationモードを開始すると HERE HD GNSS Positioning が有効になります。 HD GNSS（高解像度グローバルナビゲーション衛星システム）機能を使用すると、レーンアシスタンス、ターンバイターンガイダンス、拡張現実など、さまざまな用途に高解像度のポジショニングを行うことができます。 HD GNSS はクラウドベースのソリューションで、マスマーケットのデバイスが世界中でサブメートルの精度を達成できるようにします。

HD GNSS には、使用されている Android デバイスに特別な要件があります。 この機能が動作するには、 Android バージョンのデバイスが 12 （ API 31 ）以上である必要があります。 具体的には、デバイスが以下をサポートしている必要があります。

• 生の GNSS 測定値
• GNSS キャリア位相測定（ ADR ）
• デュアル周波数 GNSS 受信機（ L5 ）

詳細については、Android のドキュメントも参照してください。

使用しているデバイスで上記の条件が満たされていることを確認する責任はユーザーにあります。 そうでない場合は、目的の精度レベルに達していない可能性があります。

上記の条件は、古いバージョンの一部の Android デバイスでも保持されます。 LocationAccuracy.SUB_METER_NAVIGATION これらのバージョンの一部ではモードを正常に使用できますが、この操作は開発およびテストの目的でのみ行う必要があります。

この機能はデフォルトでは使用できませんが、個別にアクティブ化する必要があります。 HERE HD GNSS 補正データにアクセスするには、資格情報 が必要です。 詳細については、HEREにお問い合わせください。

位置情報から正確性情報にアクセスできます

Locationオブジェクト内に存在する horizontalAccuracyInMetersフィールドは、「不確実性の半径」とも呼ばれ、68% の確率で真の地理座標が存在する可能性が高いエリアの推定値を提供します。これは、現在の位置の周囲にハローインジケータを描画するために使用されます。 下の図は、内側の緑色の円location.coordinatesに 、周囲の円を半径の精度の円horizontalAccuracyInMetersとして示し ています。 正確な地理座標は、精度円の内側（68%）または外側（32%）にあります。

同様に、高度の場合、 verticalAccuracyInMeters 値が10メートルの場合、実際の高度は 、 68%の確率で、高度-10mから高度+10mの範囲内にあると予想されます。 bearingAccuracyInDegrees およびspeedAccuracyInMetersPerSecondなどの他の精度値も同じ規則に従います。不確実性が小さいほど精度が向上します。

68% を超える確率で達成 (CEP68)

68% の確率 (CEP68) では不十分な場合、 99% の精度を達成できますか ? はい、次のとおりです。 与えられた円形誤差確率 (CEP) は自由度が 2 つのカイ （χ）２乗分布に続くため、次の式に基づいて望ましい確率を簡単に計算できます。

上の表を使用して、マップ上のハローインジケータのさまざまな確率レベルを表示できます。 たとえば、水平方向の精度が 20 メートルの場合、半径のほぼ 2 倍の確率で 99 ％を達成できます。 精度値は常に CEP68 として指定されます。つまり、次のことを意味します。

CEP99 = 2.01 x CEP68 = 2.01 x 20m = 40.2m

発見された場所の周囲に 40.2 メートルの半径を描画できるようになり ました。確率は 99% で、実際の場所はその円の内側にあります。 一方、半径 0 メートルの確率は 0% です。

法的要件

HERE SDK の位置情報機能を使用するには、前述のように、アプリケーションで HERE SDK の同意ダイアログを表示する必要があります。 ユーザーは、現在の承諾の決定を参照し、以前の承諾の決定を取り消すことができる必要があります。そうしないと、 HERE SDK の位置情報機能を使用できなくなり、代わりにプラットフォームの位置情報 API を参照する必要があります。

チュートリアル : 現在地を地図に表示

LocationIndicatorは 、マップ上のデバイスの現在位置を表すために使用されます。 インジケータが現在の位置の値で更新される前に、デフォルト Location が設定されます。デフォルトは、最後に確認された場所、または最初の位置更新が到着する前にユーザが表示する必要がある場所です。 デフォルトでは、水平精度は半径horizontalAccuracyInMetersのMapCircle で表示されます。

//Default start-up location.
static final GeoCoordinates _defaultGeoCoordinates = GeoCoordinates(52.530932, 13.384915);

// LocationIndicator object to represent device's current location.
LocationIndicator _locationIndicator;

// ...

void _addMyLocationToMap(Location myLocation) {
  if (_locationIndicator != null) {
    return;
  }
  // Set-up location indicator.
  _locationIndicator = LocationIndicator();
  // Enable a halo to indicate the horizontal accuracy.
  _locationIndicator!.isAccuracyVisualized = true;
  _locationIndicator!.locationIndicatorStyle = LocationIndicatorIndicatorStyle.pedestrian;
  _locationIndicator!.updateLocation(myLocation);
  _locationIndicator!.enable(_hereMapController!);

  // Point camera at given location.
  MapMeasure mapMeasureZoom = MapMeasure(MapMeasureKind.distance, _cameraDistanceInMeters);
  _hereMapController!.camera.lookAtPointWithMeasure(
    myLocation.coordinates,
    mapMeasureZoom,
  );

  // Update state's location.
  setState(() {
    _location = myLocation;
  });
}

// ...

    Location? location = _locationEngine.lastKnownLocation;

    if (location == null) {
        // No last known location, use default instead.
        location = Location.withCoordinates(_defaultGeoCoordinates);
        location.time = DateTime.now();
    }

    _addMyLocationToMap(location);

// ...

void _updateMyLocationOnMap(Location myLocation) {
    if (_locationIndicator == null) {
      return;
    }

    // Update location indicator's location.
    _locationIndicator?.updateLocation(myLocation);

    // Point camera at given location.
    _hereMapController?.camera.lookAtPoint(myLocation.coordinates);

    // Update state's location.
    setState(() {
        _location = myLocation;
    });
}

上記の実装に示されているように、updateLocation()を呼び出して、Locationオブジェクトを位置情報インジケータに渡すことができます。 この例では、ユーザーの現在の位置を追跡することを目的としています。そのため、マップビューポートの中心位置も更新されます。