StreetViewService クラス
google.maps.StreetViewService
クラス
StreetViewService
オブジェクトは、ストリートビュー データの検索を行います。
const {StreetViewService} = await google.maps.importLibrary("streetView")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
StreetViewService |
StreetViewService() パラメータ: なし
ストリートビュー サービスに保存されているデータへのインターフェースを提供する StreetViewService を作成します。 |
メソッド | |
---|---|
getPanorama |
getPanorama(request[, callback]) パラメータ:
戻り値:
Promise<StreetViewResponse> 指定されたストリートビューのクエリ リクエストに一致するパノラマの StreetViewPanoramaData を取得します。StreetViewPanoramaData は指定されたコールバックに渡されます。 |
StreetViewStatus 定数
google.maps.StreetViewStatus
定数
ストリートビュー リクエストの完了時に StreetViewService
から返されるステータス。これらは、値で指定することも、定数の名を使用して指定することもできます。たとえば、'OK'
や google.maps.StreetViewStatus.OK
などです。
const {StreetViewStatus} = await google.maps.importLibrary("streetView")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
OK |
リクエストは正常に実行されました。 |
UNKNOWN_ERROR |
リクエストを正常に処理できませんでした。失敗の正確な理由は不明です。 |
ZERO_RESULTS |
検索条件に一致するパノラマは見つかりませんでした。 |
StreetViewLocationRequest インターフェース
google.maps.StreetViewLocationRequest
インターフェース
getPanorama
とともに送信されるストリートビュー リクエスト。StreetViewLocationRequest
を使用すると、指定した場所のストリートビュー パノラマを検索できます。
プロパティ | |
---|---|
location optional |
タイプ:
LatLng|LatLngLiteral optional ストリートビュー パノラマを検索する場所を指定します。 |
preference optional |
タイプ:
StreetViewPreference optional 指定された場所に最も近い位置にあるパノラマや、半径内で最適なパノラマなど、半径内でどのようなパノラマを優先して検索するかを設定します。 |
radius optional |
タイプ:
number optional デフォルト:
50 パノラマを検索する半径(メートル単位)を設定します。 |
|
タイプ:
StreetViewSource optional デフォルト:
StreetViewSource.DEFAULT 検索するパノラマのソースを指定します。これにより、屋外のパノラマのみを検索するように制限できます。 |
sources optional |
タイプ:
Iterable<StreetViewSource> optional デフォルト: [
StreetViewSource.DEFAULT ]検索するパノラマのソースを指定します。これにより、屋外のパノラマのみを検索するように制限できます。複数のソースを設定すると、それらのソースの交差として評価されます。 |
StreetViewPanoRequest インターフェース
google.maps.StreetViewPanoRequest
インターフェース
StreetViewPanoRequest
は getPanorama
とともに使用され、指定された ID のパノラマを検索します。
プロパティ | |
---|---|
pano optional |
タイプ:
string optional 検索するパノラマ ID を指定します。 |
StreetViewResponse インターフェース
google.maps.StreetViewResponse
インターフェース
StreetViewService.getPanorama
からの Promise に対するレスポンスが解決されました。
プロパティ | |
---|---|
data |
パノラマの表現。 |
StreetViewLocation インターフェース
google.maps.StreetViewLocation
インターフェース
ストリートビュー パノラマの位置の表現。
プロパティ | |
---|---|
pano |
タイプ:
string パノラマの一意の識別子。これはセッションの存続中は不変ですが、異なるセッション間では変わる可能性があります。 |
description optional |
タイプ:
string optional 位置を説明するローカライズされた文字列。 |
latLng optional |
タイプ:
LatLng optional パノラマの LatLng。 |
shortDescription optional |
タイプ:
string optional 場所の簡単な説明。 |
StreetViewPreference 定数
google.maps.StreetViewPreference
定数
リクエストされた場所に最も近いストリートビュー パノラマや、ユーザーが閲覧する可能性が高いと見込まれるパノラマを検索結果に優先的に表示するオプション。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'best'
や、google.maps.StreetViewPreference.BEST
です。
const {StreetViewPreference} = await google.maps.importLibrary("streetView")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BEST |
ユーザーが閲覧する可能性が高いと判断されるストリートビュー パノラマを返します。最適な結果は、ユーザー調査と、認識されたスポット、画像の品質、指定された場所からの距離などのパラメータに基づいてアルゴリズムによって決定されます。 |
NEAREST |
指定された場所から最も距離が近いストリートビュー パノラマを返します。これは限られた範囲内でのみ有効です。推奨される半径は 1 km 以下です。 |
StreetViewSource 定数
google.maps.StreetViewSource
定数
ストリートビューの検索を特定のソースに制限するための ID。これらの値は文字列として指定します。たとえば、'outdoor'
です。
const {StreetViewSource} = await google.maps.importLibrary("streetView")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
DEFAULT |
ストリートビューのデフォルトのソースを使用します。検索対象が特定のソースに限定されません。 |
GOOGLE |
ストリートビューの検索を Google の公式コレクションに限定します。 |
OUTDOOR |
ストリートビューの検索を屋外のパノラマのみに限定します。屋内コレクションは検索結果に含まれません。また、検索結果には、屋内か屋外かを判断できるパノラマのみが返されます。たとえば、屋内と屋外のどちらであるか不明なため、フォトスフィアは返されません。 |
StreetViewPanoramaData インターフェース
google.maps.StreetViewPanoramaData
インターフェース
registerPanoProvider
を使用して定義されたプロバイダから返されたパノラマの表現。
プロパティ | |
---|---|
tiles |
タイプ:
StreetViewTileData このパノラマのカスタム タイルを指定します。 |
copyright optional |
タイプ:
string optional このパノラマの著作権テキストを指定します。 |
imageDate optional |
タイプ:
string optional このパノラマの画像が撮影された年と月を指定します。日付文字列は YYYY-MM の形式です。 |
links optional |
タイプ:
Array<StreetViewLink> optional 隣接するパノラマへのナビゲーション リンクを指定します。 |
location optional |
タイプ:
StreetViewLocation optional このパノラマの位置メタデータを指定します。 |
StreetViewLink インターフェース
google.maps.StreetViewLink
インターフェース
隣接するストリートビュー パノラマへの参照のコレクション。
プロパティ | |
---|---|
description optional |
タイプ:
string optional リンクを説明するローカライズされた文字列。 |
heading optional |
タイプ:
number optional リンクの見出し。 |
pano optional |
タイプ:
string optional パノラマの一意の識別子。この ID はセッション内では一定ですが、セッションが変わると変更されます。 |