GoogleのPlace API(新版)についてまとめる

概要

Google Place API(New)で改善した点

• 以前は大雑把なAPIの種類で課金されていた
• SKU(GogleMapsPlatformの課金単位)単位で課金されることによって、不要な機能やデータを取得しなくて済むようになった
• 上記によって、APIのコスト最適化が図れる

API(New)の種類と取得できる情報

APIの種類と取得できる情報

Place Details:

プレイスIDを使用して、場所の詳細情報を取得。

Place Photo:

プレイスIDを使用して、場所の写真を取得。

Nearby Search:

指定された場所の周辺にある場所を検索し、リストと基本的な情報を取得。

Text Search:

テキスト検索で場所を検索し、リストと基本的な情報を取得。

Autocomplete:

リクエストに応じて場所の候補とクエリ予測を返す。

APIの課金方法

• 新版のAPIはFieldMaskヘッダーを使用してレスポンスで返すフィルドのリストを指定する
• リクエストに適用される一番高いSKUに基づいて請求される
• FieldMaskの値によって課金グレードが変わるイメージ

---

PlaceDetail APIの例

下記のフィールドのいずれかのみのリクエスト時はIDs Onlyとしてみなされる

• SKU:Place Details(IDs Only)
  • attributions
  • id
  • name
  • photos

---

下記のフィールドのいずれかのみリクエスト時はLocation Onlyとしてみなされる

• SKU:Place Details(Location Only)
  • addressComponents
  • adrFormatAddress
  • formattedAddress
  • location
  • plusCode
  • shortFormattedAddress
  • types
  • viewport

---

下記のフィールドのいずれかのみリクエスト時はBasicとしてみなされる

• SKU: Place Details (Basic)
  • accessibilityOptions
  • businessStatus
  • containingPlaces
  • displayName
  • googleMapsLinks
  • googleMapsUri
  • iconBackgroundColor
  • iconMaskBaseUri
  • primaryType
  • primaryTypeDisplayName
  • pureServiceAreaBusiness
  • subDestinations
  • utcOffsetMinutes

---

下記のフィールドのいずれかのみリクエスト時はAdvancedとしてみなされる

• SKU: Place Details (Advanced)
  • currentOpeningHours
  • currentSecondaryOpeningHours
  • internationalPhoneNumber
  • nationalPhoneNumber
  • priceLevel
  • priceRange
  • rating
  • regularOpeningHours
  • regularSecondaryOpeningHours
  • userRatingCount
  • websiteUri

---

下記のフィールドのいずれかのみリクエスト時はPreferredとしてみなされる

• SKU: Place Details (Preferred)
  • allowsDogs
  • curbsidePickup
  • delivery
  • dineIn
  • editorialSummary
  • evChargeOptions
  • fuelOptions
  • goodForChildren
  • goodForGroups
  • goodForWatchingSports
  • liveMusic
  • menuForChildren
  • parkingOptions
  • paymentOptions
  • outdoorSeating
  • reservable
  • restroom
  • reviews
  • routingSummaries
  • servesBeer
  • servesBreakfast
  • servesBrunch
  • servesCocktails
  • servesCoffee
  • servesDessert
  • servesDinner
  • servesLunch
  • servesVegetarianFood
  • servesWine

とりあえずPlaceDetailsのSKUについてまとめました

他のAPIについては下記の参考からお確かめください

参考