Exploring New Google Places API

Slide 1

Slide 1 text

Exploring New Google Places API KINTOテクノロジーズ⼤沼 2024/12

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

©KINTO Corporation. All rights reserved. 4 はじめに今回の発表は、Google Map PlatformのPlaces APIのアップデート情報を調べてみたことをお話しします。今年の初めにGoogle I/O 2024にてPlaces APIが新しくなったことが公表され、キャッチアップしたいと考えました。この発表で話す内容の調査は以下のライブラリを使⽤したandroidアプリで確認しています。 • Places SDK for Android v4.1.0

Slide 5

Slide 5 text

©KINTO Corporation. All rights reserved. 5 Google Places APIとは Google Places APIは、Googleの位置情報データベースを活⽤して、特定の場所や周辺エリアの情報を取得できるAPIです。 • 場所検索: 現在地や特定の条件に基づいて、レストラン、ホテル、観光地などを検索。 • 詳細情報の取得: 営業時間、電話番号、評価、レビューなどの詳細な場所情報を取得。 • オートコンプリート機能: ユーザーが⼊⼒したキーワードに基づいて、候補をリアルタイムで提案。モビリティサービスにおけるユーザー体験を向上させるためにもってこいのツールですね

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

©KINTO Corporation. All rights reserved. 9 PlacesClient.awaitFindAutocompletePredictions() パラメータ⼀覧パラメータ名 origin 結果を⽣成する際の起点（ユーザーの位置など）を指定します。 query ユーザーが検索しているクエリ⽂字列例: "Sushi" や "Tokyo Station" countries 結果を特定の国に制限するためのISO 3166-1 Alpha-2コード（例: "JP"）⼀度に複数の国を指定することも可能 locationBias バイアス（優先）位置特定の地点や地域に基づく結果を優先し、特定の地域外の候補も出す locationRestriction 制限する領域特定の地域外の候補を除外 typeFilter オートコンプリート結果を特定のプレイスタイプに制限例: TypeFilter.ESTABLISHMENT, TypeFilter.ADDRESS sessionToken セッションごとの⼀意なトークン。オートコンプリートセッション全体で⼀意のトークンを使⽤することで、料⾦の効率化と操作のトラッキングが可能。

Slide 10

Slide 10 text

©KINTO Corporation. All rights reserved. 10 val origin = LatLng(35.6868974,139.7722662) placesClient.awaitFindAutocompletePredictions { this.origin = origin locationRestriction = CircularBounds.newInstance(origin, 200.0) typesFilter = listOf(PlaceTypes.ESTABLISHMENT) this.query = query countries = listOf("JP") sessionToken = token } コードサンプル

Slide 11

Slide 11 text

Slide 12

Slide 12 text

©KINTO Corporation. All rights reserved. 12 新しいPlace Typesの追加次世代オートコンプリートでは、従来のPlace Typesに加え、さらに多くの場所タイプがサポートされており、より多様な検索が可能に。例: ただの「カフェ」だけではなく「ドッグカフェ(dog_cafe) 」タイプが加わり⽝の同伴が可能なカフェというのがわかったりただの「美術館」だけではなく「⾞椅⼦の⼊り⼝がある美術館(wheelchair_accessible_entrance)」タイプが加わりバリアフリー対応なのかなど、特定の施設をより精度⾼く検索できるようになりました。

Slide 13

Slide 13 text

©KINTO Corporation. All rights reserved. 13 • 課題例: ユーザーが外出先で適切な飲⾷店をすばやく⾒つけたい。 APIの活⽤: • Autocomplete: キーワードを⼊⼒すると、近くの候補をすばやく提⽰。 • Place Details: 各店舗の営業時間、レビュー、混雑状況を表⽰。 • Place Types: 「ヴィーガンレストラン」「ハラールレストラン」など特定条件の絞り込み。 Place Types を駆使することでどのように課題を解決できるか

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

©KINTO Corporation. All rights reserved. 16 料⾦体系の変更 API利⽤ごとの個別課⾦から、セッション単位の料⾦モデルへ刷新されました。 • セッション = ユーザーの連続的なAPI呼び出しの期間。 • 最⼤ 15 分間継続可能。旧料⾦モデルの例 • ユーザーが10回リクエスト -> 10回分課⾦。新料⾦モデルの例 • 同じ10回リクエストでも1セッション内で完結 -> 1セッション分課⾦。

Slide 17

Slide 17 text

Slide 18

Slide 18 text

©KINTO Corporation. All rights reserved. 18 placesClient.awaitFindAutocompletePredictions { this.query = query sessionToken = token } } どのようにコストを削減できるか (従来の例: 必要以上のデータ取得) 問題点: 上記のコードでは、全てのフィールドをデフォルトでリクエストしているため、不要なデータ取得によるコストが発⽣。

Slide 19

Slide 19 text

©KINTO Corporation. All rights reserved. 19 val placeFields = listOf(Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.RATING) placesClient.awaitFetchPlace( placeId = placeId, placeFields = placeFields sessionToken = token ) どのようにコストを削減できるか (改善例: 必要なデータフィールドだけを指定) コスト削減のポイント:必要最低限の情報（例: 店名、レビュー評価）だけを取得。

Slide 20

Slide 20 text

• 新しいオートコンプリートは、ユーザーの検索体験をより便利でスムーズにアプリケーションの利便性をUP • 必要なPlace.Fieldを必ず指定しリクエストすることで、コスト効率が向上まとめ