# Google Places APIをGAS（Google Apps Script）から使う方法

## 目次
1. はじめに
2. Google Places APIとは？
    1. Places APIの基本機能
    2. 利用可能な情報
3. 前提条件
    1. Google Cloud Platformプロジェクトの設定
    2. APIキーの取得
4. GAS環境の構築
    1. スクリプトエディタの起動
    2. プロジェクトの作成
5. Google Places APIの利用
    1. GASでのHTTPリクエストの実行
    2. サンプルコード
6. エラーハンドリング
7. 料金と制限
8. まとめ

## 1. はじめに
Google Places APIは、場所に関する詳細情報を取得できる強力なツールです。地名、住所、施設名などを利用したデータの取得が可能となり、地理情報関連のアプリケーションで頻繁に使用されます。本記事では、Google Apps Script（GAS）を通してGoogle Places APIを使う方法を詳しく解説します。

## 2. Google Places APIとは？
### 2-1 Places APIの基本機能
Google Places APIは、周辺情報の検索、詳細情報の取得、自動コンプリートの提案などをウェブおよびモバイルアプリケーションで提供します。

### 2-2 利用可能な情報
- 施設の名前と種類
- 場所の写真
- 営業時間
- レビューと評価

## 3. 前提条件
### 3-1 Google Cloud Platformプロジェクトの設定
Google Places APIを利用するには、まずGoogle Cloud Platform（GCP）にプロジェクトを作成し、APIを有効化する必要があります。

### 3-2 APIキーの取得
1. [Google Cloud Console](https://console.cloud.google.com/)にログインします。
2. プロジェクトを選択または作成します。
3. 「APIとサービス」から「ライブラリ」に移動し、Google Places APIを有効化します。
4. 「資格情報」タブでAPIキーを作成し、それを活用することで、安全にAPIアクセスが可能となります。

## 4. GAS環境の構築
### 4-1 スクリプトエディタの起動
1. Googleドライブを開きます。
2. 「新規」メニューから「Google Apps Script」を選択します。

### 4-2 プロジェクトの作成
新規プロジェクトの作成画面が開くので、任意の名前を付けて開始します。

## 5. Google Places APIの利用
### 5-1 GASでのHTTPリクエストの実行
GASを使ってHTTPリクエストを送信し、APIから情報を取得できます。特に`UrlFetchApp`クラスを使用します。

### 5-2 サンプルコード
以下に、Google Places APIを利用して詳細情報を取得するサンプルコードを示します。

![img](/mosaic-code.jpg)

## 6. エラーハンドリング
API使用中にエラーが発生することがあります。そのため、APIレスポンス内のステータスをチェックし、適切なエラーメッセージを表示することが重要です。

![img](/mosaic-code.jpg)

## 7. 料金と制限
Google Places APIの利用には、無料枠がありますが、使用量に応じて課金されることがあります。料金については、[Google Places APIの料金ページ](https://cloud.google.com/maps-platform/pricing?hl=ja)で確認できます。

主な制限としては、1日あたりのリクエスト数や、1分間のリクエスト数が定められています。

## 8. まとめ
Google Places APIは、場所に関する情報を取得するソリューションとして非常に有用です。GASを活用することで、簡単にこのAPIによるデータ取得が可能となります。本記事を参考に、あなただけの地理情報を活用したプロジェクトを作成してみてください。 [cv:issue_marketplace_engineer]

# Google Places APIをGAS（Google Apps Script）から使う方法

## 目次
1. はじめに
2. Google Places APIとは？
    1. Places APIの基本機能
    2. 利用可能な情報
3. 前提条件
    1. Google Cloud Platformプロジェクトの設定
    2. APIキーの取得
4. GAS環境の構築
    1. スクリプトエディタの起動
    2. プロジェクトの作成
5. Google Places APIの利用
    1. GASでのHTTPリクエストの実行
    2. サンプルコード
6. エラーハンドリング
7. 料金と制限
8. まとめ

## 1. はじめに
Google Places APIは、場所に関する詳細情報を取得できる強力なツールです。地名、住所、施設名などを利用したデータの取得が可能となり、地理情報関連のアプリケーションで頻繁に使用されます。本記事では、Google Apps Script（GAS）を通してGoogle Places APIを使う方法を詳しく解説します。

## 2. Google Places APIとは？
### 2-1 Places APIの基本機能
Google Places APIは、周辺情報の検索、詳細情報の取得、自動コンプリートの提案などをウェブおよびモバイルアプリケーションで提供します。

### 2-2 利用可能な情報
- 施設の名前と種類
- 場所の写真
- 営業時間
- レビューと評価

## 3. 前提条件
### 3-1 Google Cloud Platformプロジェクトの設定
Google Places APIを利用するには、まずGoogle Cloud Platform（GCP）にプロジェクトを作成し、APIを有効化する必要があります。

### 3-2 APIキーの取得
1. [Google Cloud Console](https://console.cloud.google.com/)にログインします。
2. プロジェクトを選択または作成します。
3. 「APIとサービス」から「ライブラリ」に移動し、Google Places APIを有効化します。
4. 「資格情報」タブでAPIキーを作成し、それを活用することで、安全にAPIアクセスが可能となります。

## 4. GAS環境の構築
### 4-1 スクリプトエディタの起動
1. Googleドライブを開きます。
2. 「新規」メニューから「Google Apps Script」を選択します。

### 4-2 プロジェクトの作成
新規プロジェクトの作成画面が開くので、任意の名前を付けて開始します。

## 5. Google Places APIの利用
### 5-1 GASでのHTTPリクエストの実行
GASを使ってHTTPリクエストを送信し、APIから情報を取得できます。特に`UrlFetchApp`クラスを使用します。

### 5-2 サンプルコード
以下に、Google Places APIを利用して詳細情報を取得するサンプルコードを示します。

```javascript
function getPlaceDetails() {
  var apiKey = 'YOUR_API_KEY';
  var placeId = 'ChIJa147K9HX3IAR-lwiGIQv9i4'; // Replace with target place ID
  var url = `https://maps.googleapis.com/maps/api/place/details/json?placeid=${placeId}&key=${apiKey}`;

  var response = UrlFetchApp.fetch(url);
  var json = JSON.parse(response.getContentText());

  Logger.log(json);
}
```

## 6. エラーハンドリング
API使用中にエラーが発生することがあります。そのため、APIレスポンス内のステータスをチェックし、適切なエラーメッセージを表示することが重要です。

```javascript
function handleError(response) {
  var jsonResponse = JSON.parse(response.getContentText());
  if (jsonResponse.status !== "OK") {
    Logger.log("Error: " + jsonResponse.status);
    return;
  }
  Logger.log("Success: " + jsonResponse.result.name);
}
```

## 7. 料金と制限
Google Places APIの利用には、無料枠がありますが、使用量に応じて課金されることがあります。料金については、[Google Places APIの料金ページ](https://cloud.google.com/maps-platform/pricing?hl=ja)で確認できます。

主な制限としては、1日あたりのリクエスト数や、1分間のリクエスト数が定められています。

## 8. まとめ
Google Places APIは、場所に関する情報を取得するソリューションとして非常に有用です。GASを活用することで、簡単にこのAPIによるデータ取得が可能となります。本記事を参考に、あなただけの地理情報を活用したプロジェクトを作成してみてください。 

Google Places APIをGAS（Google Apps Script）から使う方法

目次

続きを読むには単価診断を受けてください（30秒）