このページは Cloud Translation API によって翻訳されました。

Nearby Search（新機能）API でローカル検索を改善

このドキュメントでは、Nearby Search（新版）API の使用方法を解説します。シンプルで費用対効果の高い

ローカル検索機能

地域の情報検索エクスペリエンスで、ある場所の周辺にある重要な注目スポットをユーザーに提示ホテルや不動産を検索する際に指定することができます多くの場合、インタラクティブな地図に加え、スポット選択ツールと表示されます。表示される Google Maps Platform にはインタラクティブなエクスペリエンスを強化するためのプロダクトと機能。

ローカル検出のサンプル

ユースケース

次に、ローカル検出の統合の要素がユーザー価値を高める仕組みについて説明します。

検索 - 特定の場所の周辺地域の概要をユーザーに表示します。さまざまな種類の関連する場所を表示することで、ユーザーエクスペリエンスを強化できます。
インタラクティビティ - ユーザーが場所を選択し、データを動的に更新できるようにする

をその場所に対して相対的に表します。
可視化 - 場所のレビューや写真を提供する

歩行時間と距離を表示することでユーザーが合っているかどうかをすばやく把握できます提供します。

リファレンスアーキテクチャ

alt_text

ローカル検索

地域の情報を検索するための方法はたくさんあります。次の統合は、よく知られている Google Maps Platform API と、いくつかの新しい機能を活用したユーザーエクスペリエンスのカスタム例です。もしローカル検索に対するテンプレート化されたアプローチが必要な場合は、ウェブコンポーネントをご覧ください。

サンプルアプリケーション

サンプルのチュートリアル

サンプルアプリケーションの下の表を手順ごとに示します。および Google マップを使用した技術的な実装の説明 Platform API。

1. 場所の検索（AutocompleteSearch location）

Maps JavaScript API を読み込みます。
Places Autocomplete クエリを実行するか、地図上で場所を選択します。

予測入力のサンプル

2. Nearby Search（新版）API を使用してローカルのスポットを表示する

人気度ランキング（より関連性の高い検索結果）または距離ランキング。
includedTypes、excludedTypes: ホテルの場合は、「宿泊施設」の種類を除外し、適切な種類のみ（レストラン、カフェ、公園、観光スポットなど）を含めることができます。
includedPrimaryTypes、excludedPrimaryTypesをさらに活用結果を制御できます。
結果の数が不十分な場合や離れすぎないようにするための locationRestriction 場所、結果がゼロの場合は、事前に円 / 長方形のサイズを広げる結果を表示します

付近の場所のサンプル

ホテルを予約する際のデータフィールドがリクエストされた場合のクエリのサンプル:

基本（displayName、types、openingHours、formattedAddress）
連絡先（websiteUri、nationalPhoneNumber、internationalPhoneNumber）
優先（reviews、priceLevel、userRatingCount）

 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

データフィールドをリクエストして不動産を検索する場合のクエリのサンプル:

基本（displayName、types、openingHours、formattedAddress）

 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Dynamic Maps API と Directions API を使用してインタラクティビティを追加する

Directions API をクエリして、最新の区間とステップを取得。 * 次のセクションでは時間を使用します。

ルートのサンプル

4. インタラクション時に場所の詳細情報を表示する

説明: displayName、types、rating、userRatingCount、priceLevel。

時間: 前の Directions API クエリから取得。
レビュー: reviews[i].author、reviews[i].rating、reviews[i].text。
画像: Nearby Search（新規）API の無制限プレビュー中は、place.id を使用してPlaces Details をクエリし、photo_reference を取得してから、エクスペリエンスで 1 つずつクエリする必要があります。

場所の詳細

クエリ数と関連する費用

Maps JavaScript API: エクスペリエンスの読み込み時に 1 つの地図。
Places Autocomplete API: 文字が入力されるたびに 1 つのクエリ（予測入力ウィジェット）カスタマイズできます。
Nearby Search（新規）API: 表示される場所 20 件ごとに 1 件のクエリ。クエリレスポンスの一部である場所データに応じた課金。
ルート API: ユーザーが選択したすべての場所に対して 1 回のクエリ
Place Photo API: 1 クエリで、表示されるすべての写真に対してクエリを実行します。

まとめ

ローカル検索エクスペリエンスは、ユーザーに価値をもたらす優れた方法です。このデモ実装には多くの機能が含まれています特別な機能を備えた Google Maps Platform でそのようなエクスペリエンスを創出する Nearby Search (新) API から。

次のステップ

寄稿者

主な作成者:

Thomas Anglaret |Google マッププラットフォームソリューションエンジニア