近傍テンプレートは、Instant Apps の近傍 Web アプリ テンプレートに基づいています。 このテンプレートは、ネイティブ アプリを使用して近くの場所を特定できるようにします。距離やフィーチャ カテゴリで検索範囲を絞り込むフィルターを備えています。
要件
近傍テンプレートを使用するための要件は、次のとおりです。
- 1 つ以上の近傍 Web アプリを指定します。 これには、単一の有効なアイテム ID、複数の近傍 Web アプリを含むグループの ID、または複数のアイテム ID を含む検索クエリを使用できます。
- 近傍 Web アプリは、パブリックにしたり、セキュリティ保護したりできます。 OAuth2 を使用して ArcGIS Online 組織サイトまたは ArcGIS Enterprise ポータルのセキュアな Web アプリにアクセスするには、アプリを登録して、クライアント ID を指定します。 詳細については、「アプリの署名」をご参照ください。デフォルトでは、近傍ギャラリーにはパブリックな近傍 Web アプリのみが表示されます。 セキュアな近傍 Web アプリにアクセスするには、 [設定] > [ライセンス] > [ギャラリー] の順にクリックして、クライアント ID を入力します。
- 必要に応じて ArcGIS のルート検索サービスを使用して目的地への詳しいルート案内を表示したい場合は、[設定] > [プロパティ] > [ギャラリー] の順にクリックして API キーを入力するか、[設定] で [セキュリティ保護された Web アプリのサポート] プロパティを有効にして、ユーザーに近傍アプリへのサイン インを求める必要があります。
アプリのカスタマイズ
アプリを作成したら、アプリの設定を変更してカスタマイズできます。
AppStudio を起動し、サイド パネルで [設定] > [プロパティ] の順にクリックします。 次の表は、[Nearby のプロパティ] タブ内にあるタブの内容を、タブと目的別に示しています。 プロパティは、アプリの appinfo.json ファイル内で直接変更することもできます。 これらのうちいずれかのプロパティを変更する場合は、[適用] をクリックして変更内容を保存してから、再度アプリを起動します。
開始画面タブの内容
| プロパティ | JSON 名 | タイプ | 説明 |
|---|---|---|---|
| 背景画像 | startBackground | String (画像の URL) | 開始ページの背景に使用される画像 |
| ブランドの色 | brandColor | string (色の値) | 原色として使用する色 |
| タイトル フォント ファイル | mediumFontTTF | String (フォント ファイルの URL) | アプリ全体で使用されるカスタム タイトル フォントを設定します。このフォントは、見出し、ページ タイトルなどに使用されます。 |
| テキスト フォント ファイル | regularFontTTF | String (フォント ファイルの URL) | アプリ全体で使用されるカスタム テキスト フォントを設定します。このフォントは、写真の説明、テキストなどに使用されます。 |
| フィードバック電子メール | feedbackEmail | String (電子メール ID) | ユーザーがフィードバックを送信する電子メール アドレス。 |
| 免責事項の表示 | showDisclaimer | Boolean (true|false) | アプリのポップアップとして免責事項のテキストを表示します。このテキストは、[詳細] タブの [アクセスと使用の制限] の内容です。 |
ギャラリー タブの内容:
| プロパティ | JSON 名 | タイプ | 説明 |
|---|---|---|---|
| 近傍 Web アプリ | galleryMapsQuery | String | ギャラリーに有効な近傍 Web アプリをリストする ArcGIS クエリを入力します。 これには、id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb などの Web アプリの単一の有効なアイテム ID、group:47597bdf4b6d49fd85c0f4175a6e7b60 などの複数の Web アプリを含むグループ ID、または (id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb OR id:6efd8324a57247c79a7ec9a66a9bf581) などの複数の Web アプリのアイテム ID を使用した検索クエリを使用できます。 |
| ギャラリーに表示する合計結果 | maxNumberOfQueryResults | 数値 | ポータルのクエリから返す Web アプリの最大数を入力します。 |
| Portal の URL | portalUrl | String | 近傍 Web アプリをクエリするためのポータルの URL。 |
| セキュリティ保護された Web アプリのサポート | supportSecuredMaps | Boolean (true|false) | クエリ パラメーターに従いセキュリティ保護された Web アプリにアクセスするために、組織サイトにサイン インする機能を提供します。 |
| サイン インをスキップ | enableAnonymousAccess | Boolean (true|false) | [セキュリティ保護された Web アプリのサポート] が true に設定されている場合、このオプションを true に設定すると、サイン インしないで、ギャラリー内でパブリックに使用可能な Web アプリのみを表示する機能を使用できます。 |
| API キー | APIKey | String | 近傍テンプレートに詳細なルート案内を表示するため、API キーを入力して、ルート検索サービスへのアクセスを許可します。 API キーは、ArcGIS Developer アカウントにサイン アップする際に、そのユーザー用に作成されます。 ArcGIS アカウントをすでにお持ちの場合は、ArcGIS Developer アカウントにサイン インして、この API キーを表示するか API キーを追加作成します。 |
| ポータル並べ替えフィールド | portalSortField | String | ギャラリーに表示される Web アプリを並べ替えるために使用されます。 使用可能な値: title、created、type、owner、modified、avgRating、numRatings、numComments、numViews |
| ポータル並べ替え順序 | portalSortOrder | String | Web アプリを昇順または降順に並べるために、ギャラリーの並べ替えフィールドと一緒に使用されます。 指定できる値は asc または desc です。 |