このセクションでは GlocalSearch オブジェクトの使用法を表すサンプルを扱います。これらのサンプルで示される主要な点は、検索結果を特定の領域にスコープ設定するようにオブジェクトの中央点を設定する方法や、Google マップにプロットされる結果のソースとしてオブジェクトを使う方法があります。

• 中央点コントロール
  このサンプルは、ローカル検索オブジェクトの中央点を制御する方法を示します。
• AJAX 検索 + Google マップ
  このサンプルは、ローカル検索結果を取得して、Google マップ上にプロットする方法を示しています。
• 経路検索^New!
  各ローカル検索結果に、CSS ルールを使って表現されている、2 種類の経路検索のリンクが含まれています。デフォルトの directions リンクは、現在の検索中央点から検索結果への経路です。別の方法として、アプリケーションの側で、ユーザーが選択した場所と現在の検索結果との間の経路をリンクに表現することができます。このサンプルは、どのタイプの経路検索が表示されるかをアプリケーションでコントロールする方法を示しています。
• 静的地図画像^New!
  各ローカル検索結果に、ローカル検索結果を視覚的に表現している地図画像に解決される staticMapUrl プロパティが含まれています。検索結果のサムネイル表現を提供したいだけの場合は、このプロパティを使うのが手早く、効率的です。サンプルは、このプロパティと、関連のサポート メソッドの使用法を示しています。

このセクションでは、サーチャーの setSiteRestriction() メソッドを使って、検索結果のセットを 1 つのサイトやカスタムのサーチエンジンにスコープ設定する使い方を示したサンプルを提供しています。GwebSearch、GblogSearch、GnewsSearch の各サーチャーはいずれもこの基本的なメソッドをサポートしていますが、カスタム検索エンジンへのスコープ設定をサポートしているのは GwebSearch だけです。

• サイト制限検索
  このサンプルは、GwebSearch、GblogSearch、GnewsSearch の各オブジェクトの setSiteRestriction() メソッドの使用法を示しています。サイト制限検索では、多くの場合、検索結果セクション ヘッダーにカスタムのラベルを指定するのが有効です。検索結果にカスタムのスタイルを設定するとよい場合もあります。このいずれの関数も、setUserDefinedLabel() メソッドや setUserDefinedClassSuffix() メソッドを使うことでサポートされます。
• カスタム検索エンジン
  このサンプルは、上のサンプルをもとに、製品レビュー カスタム検索エンジンを酷使して作られたものです。setSiteRestriction() へのさまざまな呼び出しが、すべてカスタム検索エンジン ID を使って行われていることに注意してください。サンプルには、サイト制限と関係がない他のアイディアもいくつか含まれています。GSearchForm オブジェクトを使った複数の検索コントロールの駆動や、検索コントロールや検索結果のスタイルを設定し直すカスタム CSS ディレクティブの使用などです。
• カスタム検索エンジンの高度な使用
  このサンプルは、上のサンプルをもとに、カスタム検索エンジンの使い方を高度化することによって作られています。右側のサーチャーに対応する setSiteRestriction() の呼び出しで、コードで opt_refinement 引数を使うことで、カスタム検索エンジンの範囲内で 検索結果をさらに制限していることに注目してください。
• リンク済みカスタム検索エンジン^New!
  このサンプルは、カスタム検索エンジンの最新強化版である、リンク済みカスタム検索エンジンを示しています。site にオブジェクトを使い、crefUrl プロパティでカスタム検索エンジン定義ファイルの URL を指定していることに注意してください。

このセクションでは、検索結果クリッピングの使用法を表すサンプルを示します。これは、ユーザーが検索結果の下にあるリンクをクリックしたときに、その結果をアプリケーションに渡す機能です。このセクションには、この機能を実際に使ったいくつかのサンプルがあります。

• 基本的なクリッピング
  このサンプルはクリッピングの基本を示しています。このサンプルで使われる主要なメソッドは、検索コントロール オブジェクトの setOnKeepHandler() メソッドです。これにより、各検索結果の下に、クリックするとターゲット ハンドラが呼び出されるリンクが表示されます。このサンプルでは、ターゲット ハンドルは結果の .html プロパティのディープ クローンを作り、次に現在のページにそれをアタッチします。
• ブログ コメント フォーム
  このサンプルが示すメソッドは、前のサンプルのものと同じですが、この例では、サンプルはブログ スタイルのコメント フォーム環境におけるクリッピングの概念を示しています。狙いは、ユーザーによって生成されたコンテンツ (ブログ投稿やコメントなど) を、ユーザーが選択した検索結果を使って拡張する方法を示すことです。
• 電話帳
  このサンプルは .html プロパティ以外の結果プロパティの使い方を示すことによって、クリッピングの基本を拡張しています。この場合、ユーザーが検索結果をクリップするごとにスプレッドシートに行が 1 行追加され、.title や .streetAddress を使って列が形成されます。プロパティまた、前のセクションで少し触れた、クリップされた検索結果を地図上にプロットする方法も示しています。

AJAX 検索は、非常に人気が高いブログの拡張手段です。ここでは、TypePad と Blogger での AJAX 検索の使用法を示す 2 つのサンプル ブログを構築しました。

• Blogger での AJAX 検索
  このサンプルは、Blogger ベースのブログのコンテキストにおけるいくつかの AJAX 検索コンポーネントを示しています。複合コンポーネント (左側の動画ストリップ、右側の動画検索コントロールとマップ検索コントロール) は、このページのサンプルで示したテクニックを使って構築されており、ソリューション (マップ検索、動画検索、動画バー) およびウィザードとして利用可能です。右上の検索フォームについては前に触れました。これは中央列のタブのある検索コントロールを使って構築されています。検索フォームの位置は、setSearchFormRoot() を使ってサイドバーに置かれています。
• TypePad での AJAX 検索
  このサンプルは、ブログ作成ホストが少し異なったテンプレート構造を持つTypePad であること以外は前と同じです。

このセクションには、上で示したいくつかのコンセプトを 1 つのサンプルに統合した、より高度なコード サンプルへのリンクがあります。これらのサンプルを参考にして、自由に活用してください。

• ウィッシュ リスト
  これは複合検索結果クリッピングのサンプルで、結果が可変ページ コンテナに入り、検索結果が条件付きスタイル設定されるクリッピングを示しています。
• 動画クリッピング
  これはまた別の複合クリッピングのサンプルで、クリッピングされた動画の検索結果が検索コントロールの検索結果と異なるスタイルに設定される、動画検索結果のクリッピングを示しています。このサンプルでは、「leave me a note (コメントを残す)」リンクをクリックするまで、クリッピング機能が非表示にされていることに注意してください。この非表示機能では基本的な CSS テクニックを使っています。
• ローカル + ウェブ + Maps Mashup
  これはさらに複雑なクリッピング サンプルで、ローカル検索、ウェブ検索、クリッピング、Google マップの組み合わせを示しています。