このページでは、Google Maps Platform に関して、現在非推奨となっているすべてのサービスと機能を紹介します。これには、マップ、ルート、プレイスのサービスが含まれます。
非推奨について
サービス、機能、またはバージョンの非推奨期間は、非推奨が発表された日から開始されます。非推奨期間中（通常は 12 か月）も、対象となるサービス、機能、バージョンを引き続きご利用いただけます。非推奨期間が終了すると、対象のサービスや機能、バージョンは廃止され、利用できなくなります。
モニタリング対象メールアドレスを持つプロジェクト オーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。大規模アップデート、サービス終了などの変更に関する最新情報をご確認いただきますようお願いいたします。
SDK バージョンでの非推奨の機能
SDK と Maps JavaScript API の場合、非推奨となる機能はバージョンの可用性に関係しています。新しいメジャー バージョンに、既存のバージョンとの互換性を損なう変更（機能のサポート終了など）が含まれる場合、非推奨となる各機能の最大サポート バージョンがリリースノートに記載されます。サポート対象の最大 SDK バージョンが利用可能な間は、非推奨の機能を引き続きご利用いただけます。SDK の次のメジャー バージョンにアップグレードするには、現在のコードから非推奨の機能を削除するか、代替機能に置き換える必要があります。
使用可能な Maps JavaScript API バージョンの詳細をご確認ください（リリースと提供終了は四半期ごとに実施されます）。
Maps SDK for Android、 Maps SDK for iOS、 Places SDK for Android、Places SDK for iOS とのバージョン依存関係を管理する方法をご確認ください。
非推奨期間中のサービスと機能
このセクションでは、現在、非推奨となっているすべてのサービスと機能を一覧表示します。
ローカル コンテキスト ライブラリ、Maps JavaScript API（v3.51.2 より非推奨）
ローカル コンテキスト ライブラリは、ベータ版機能として提供してまいりましたが、導入数が限られていたため、v3.51.2 より非推奨となります。ローカル コンテキスト ライブラリの機能は別途お知らせがあるまでご利用いただけますが、新しいプロジェクトへの追加は推奨されません。
ローカル コンテキスト ライブラリのようなエクスペリエンスの構築に関心をお持ちの方は、Quick Builder の「Neighborhood Discovery」ソリューションを検討されるか、Maps JavaScript API のプレイス ライブラリを活用されることをおすすめします。プレイス ライブラリについては、コード例と Codelab をご用意しています。
Places SDK for Android のプレイス互換性ライブラリ（2022 年 3 月 31 日時点）
Places SDK for Android のプレイス互換性ライブラリの全バージョンは、2022 年 3 月 31 日をもって非推奨となりました。Places SDK for Android v2.6.0（com.google.android.libraries.places:places-compat:2.6.0 として依存関係で指定）のプレイス互換性ライブラリの開発は凍結する予定です。
この日以降、このライブラリの新しいバージョンはリリースされなくなります。バージョン 2.6.0 以降の Places SDK for Android で機能やバグの修正にアクセスする唯一の方法は、Places SDK for Android を使用することです。
プレイス互換性ライブラリは、従来の SDK（Play 開発者サービスで利用可能）からスタンドアロンの Places SDK for Android への移行を容易にするため、2019 年 1 月に導入されました。
移行ガイドに沿って、Places SDK for Android を直接使用します。プレイス互換ライブラリと Places SDK for Android では、一部のステータス コード、メソッド名、オートコンプリート クラス名が異なります。Places SDK for Android のバージョンへの依存関係の指定と維持については、バージョンに関するドキュメントをご覧ください。
現時点では、プレイス互換性ライブラリを廃止する予定はありません。 ただし、使用可能なバージョンのプレイス互換性ライブラリを引き続き使用する場合は、古いバージョンの SDK のサポートに関する制限にご注意ください。
Places API、Places Library、Maps JavaScript API でサポートされていない Place Search クエリ（2022 年 3 月 31 日～2023 年 3 月 31 日）
Places API、Places Library、Maps JavaScript API の Text Search、Nearby Search、Find Place でサポートされていない Place Search クエリは 2022 年 3 月 31 日をもって非推奨となり、2023 年 3 月 31 日よりエラー応答 INVALID_REQUEST が返されるようになります。
Places API、Places Library、Maps JavaScript API は、場所の検索に使用する Text Search、Nearby Search、Find Place の 3 つのメソッドをサポートしています。各メソッドは、パラメータがサポートされる組み合わせで指定されていれば、そのリクエストを受け入れ、サポートされない組み合わせで指定されていれば、そのほとんどのリクエストを拒否します。
サポートされないパラメータが指定されている一部の組み合わせについては、現在リクエストは適切に拒否されていません。
queryパラメータが空または欠落している Text Search リクエストで、サポートされているtypeパラメータの指定がない。query=*が指定された Text Search リクエスト。keyword=*が指定された Nearby Search リクエスト。name=*が指定された Nearby Search リクエスト。input=*が指定された Find Place リクエスト。
これらのサポートされていない Place Search リクエストは、次のいずれかに置き換えてください。
Nearby Search リクエストを
keyword（またはname）パラメータを指定せずに使用すると、付近の施設を検索できます。サポートされているいずれかの場所タイプ（表 1: 場所タイプを参照）と組み合わせたtypeパラメータも使用することをおすすめします。これにより、queryパラメータが空または欠落している Text Search リクエストの現在の動作に最も近い動作となります。Geocoding API リクエストを
latlngパラメータを指定して使用すると、最も近い住所を検索できます。これにより、次のリクエストの現在の動作に最も近い動作となります。query=*が指定された Text Search リクエスト。keyword=*が指定された Nearby Search リクエスト。name=*が指定された Nearby Search リクエスト。input=*が指定された Find Place リクエスト。
コンテンツ セキュリティ ポリシーの更新（2022 年 3 月 21 日～2023 年 5 月）
コンテンツ セキュリティ ポリシー（CSP）を使用し、Maps JavaScript API で googleapis.com が指定されていないウェブサイトのサポートは v3.49 をもって終了となり、v3.50 以降よりサポートされなくなります。最後のサポート バージョン v3.49 は、2023 年第 2 四半期に廃止されます。それ以降、googleapis.com の指定がない CSP ディレクティブを使用するリクエストはすべて Maps JavaScript API で拒否されます。
ウェブサイトのサービス中断を避けるためには、CSP で googleapis.com を指定してください。現在使用可能な Maps JavaScript API のバージョンはすべて CSP をサポートしています。
Google Maps Platform ゲームサービス（2021 年 10 月 18 日～2022 年 12 月 31 日）
Google Maps Platform ゲームサービスは 2021 年 10 月 18 日をもって非推奨となり、2022 年 12 月 31 日に廃止されます。非推奨の期間中、主要なバグとシステム障害に対するサポートおよび修正には引き続き対応する予定です。ゲームサービス移行ガイドで、プロジェクトの次のステップを計画するうえで役立つリソースをご確認ください。
古い場所 ID（2021 年 3 月 16 日～2022 年 3 月 30 日）
2022 年 3 月 30 日をもって、すべての Google Maps Platform API で、古い場所 ID を使用できなくなります。2022 年 3 月 30 日以降、古い場所 ID を使用して実行されたリクエストは拒否され、エラーコード INVALID_REQUEST が返されます。ユーザー エクスペリエンスの質の低下を防ぐため、2022 年 3 月 30 日までに、12 か月以上前の場所 ID をすべて更新してください。
google.load の Maps モジュール（2020 年 10 月 13 日～2021 年 10 月 13 日）
google.load に「Maps」モジュールを提供するサービスは 2020 年 10 月 13 日をもって非推奨となり、2021 年 10 月 13 日に提供が終了します。これ以降、google.load で「Maps」モジュールの読み込みをリクエストした場合はエラーとなり、マップは読み込まれません。詳しくは 移行ガイド をご覧ください。
Places SDK for iOS で新たに GMSPlaceField マクロを使用（NS_OPTIONSv4.0.0 以降）
Places SDK for iOSv4.0.0 以降、
GMSPlaceField では、Swift サポートを向上させるため、NS_ENUM の代わりに NS_OPTIONS マクロが使用されるようになります。詳しくは、GMSPlaceField で NS_OPTIONS を使用する をご覧ください。
GMSPlaceField を NS_ENUM として使用し続けるためには、依存関係で v3.10.0 以前を指定します。
Places SDK for iOS のメソッド: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0～v4.0.0)
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner ヘルパー メソッドは、v3.10.0 で非推奨になっており、v4.0.0 以降ではサポート対象外です。代わりに locationBias または locationRestriction を使用してください。
initWithBounds:filter メソッドは、v3.10.0 で非推奨になっており、v4.0.0 以降ではサポート対象外です。代わりに、GMSAutocompleteFetcher で initWithFilter: を使用してください。
これらの非推奨のメソッドがサポートされる最大バージョンは v3.10.0 です。
代替メソッドについては、付録 1 をご覧ください。
Place Autocomplete の GMSCoordinateBounds（v3.9.0～v4.0.0）
Places SDK for iOS Autocomplete サービスの GMSCoordinateBounds を使用するいくつかのプロパティ / パラメータは、v3.9.0 をもって非推奨になり、v4.0.0 以降でサポート対象外になります。非推奨のプロパティ / パラメータがサポートされる最大バージョンは v3.10.0 です。
GMSAutocompleteViewController の境界
GMSAutocompleteViewController の次のプロパティは非推奨です。
GMSAutocompleteViewController.autocompleteBoundsGMSAutocompleteViewController.autocompleteBoundsMode
同等の機能として、GMSAutocompleteFilter.locationBias または GMSAutocompleteFilter.locationRestriction と GMSAutocompleteViewController.autocompleteFilter を使用してください。これらの代替プロパティがある Places SDK for iOS の最小バージョンは v3.8.0 です。
findAutocompletePredictionsFromQuery と autocompleteQuery の境界
boundsパラメータとboundsModeパラメータ:
同等の機能として、GMSAutocompleteFilter.locationBias または GMSAutocompleteFilter.locationRestriction と findAutocompletePredictionsFromQuery:filter:sessionToken:callback を使用してください。これらの代替プロパティがある Places SDK for iOS の最小バージョンは v3.8.0 です。
代替メソッドについては、付録 1 をご覧ください。
Places フィールドの GMSPlace.openNowStatus（v3.0.0～v4.0.0）
Places SDK for iOS の Places フィールド / プロパティの GMSPlace.openNowStatus は、v3.0.0 をもって非推奨になり、v4.0.0 でサポート対象外になります。この非推奨フィールドがサポートされる最大バージョンは v3.10.0 です。
代わりに、関数の GMSPlace.isOpen または GMSPlace.isOpenAtDate を使用してください。これらの代替の関数を使用する Places SDK for iOS の最小バージョンは v3.3.0 です。
Places フィールド: permanently_closed（2020 年 5 月 26 日に非推奨）
Places API と Places Library の Maps JavaScript API の Places フィールドの permanently_closed は、非推奨です。使用しないでください。代わりに、business_status（Places API）または business_status（Places Library）を使用して、ビジネスの営業状況を取得してください。business_status を使用する Places Library の Maps JavaScript API の最小バージョンは v3.40 です。
Places フィールドの open_now、utc_offset（2019 年 11 月 20 日に非推奨）
Places Library の Maps JavaScript API の Places フィールド open_now と utc_offset は、2019 年 11 月 20 日をもって非推奨となります。使用しないでください。
これらのフィールドは、Places Library の Maps JavaScript API でのみ非推奨となっています。
- Place Details で、
open_nowフィールドがPlaceResult.opening_hours.isOpen()に置き換えられました。Nearby Search と Text Search では、openNow:trueリクエスト パラメータを使用して現在営業中のスポットを検索します。Find Place に相当する機能は提供されていません。この値を取得するには、Place Details リクエストを実行する必要があります。 - Place Details で、
utc_offsetフィールドがPlaceResult.utc_offset_minutesに置き換えられました。
詳しくは、Places フィールドの移行をご覧ください。
Maps JavaScript API: google.maps.event.addDomListener() と google.maps.event.addDomListenerOnce()（2022 年 4 月 7 日に非推奨）
Maps JavaScript API の [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) と [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) の関数は非推奨のため使用せず、代わりに、標準の addEventListener() メソッドを使用してください。
これらのメソッドは引き続き機能し、廃止される予定はありません。
非推奨期間が終了したサービスと機能
このセクションでは、廃止されたサービスと機能の一覧表示します。 以下のサービスと機能は利用できなくなりました。
Maps JavaScript API v2（2010 年 5 月 19 日～2021 年 5 月 26 日）
Maps JavaScript API バージョン 2 は、2021 年 5 月 26 日をもってご利用いただけなくなりました。その結果、サイト上の v2 のマップは機能しなくなり、JavaScript エラーが返されます。サイト上でマップを引き続き使用するには、Maps JavaScript API v3 に移行してください。詳しくは、Maps JavaScript API アプリケーションを v2 から v3 にアップグレードをご覧ください。
Places フィールド: reference、id、alt_id、scope（2019 年 9 月 3 日～2020 年 8 月 10 日）
2020 年 8 月 10 日以降、Places フィールド id、alt_id、scope は利用できなくなります。Places フィールド reference は非推奨です。使用しないでください。
idレスポンス フィールドがplace_idレスポンス フィールドに置き換えられました。referenceレスポンス フィールドはplace_idレスポンスに置き換えられているため、使用しないでください。alt_idフィールドとscopeフィールドは 2018 年 7 月に廃止された Place Add サービスでのみ使用されていたため、これらと同様の機能はありません。
詳しくは、Place フィールドの移行をご覧ください。
Maps SDK for iOS 5.0 の iOS バージョン 10、ARMv7 32 ビット アーキテクチャ
Maps SDK for iOS バージョン 5.0 をもって、iOS 10 と ARMv7 32 ビット アーキテクチャはサポート対象外になりました。
Places SDK for iOS
Places SDK for iOS 5.0 のリリースに伴い、GMSCoordinateBounds は廃止され、GMSPlacesViewportInfo に置き換えられます。
Fusion Tables レイヤ（試験運用版）（2018 年 12 月 3 日～2019 年 12 月 3 日）
Maps JavaScript API の Fusion Tables レイヤは 2019 年 12 月 3 日に提供が終了し、バージョン 3.38 ではご利用いただけなくなりました（Fusion Tables をサポートしている最後のバージョンは 3.37）。詳細
Places SDK for Android、Places SDK for iOS（2019 年 1 月 29 日～2019 年 7 月 29 日）
2019 年 1 月 29 日より、既存のバージョンの Places SDK に代わり、アップグレード版の Places SDK for Android および Places SDK for iOS がリリースされています。Places SDK for iOS、Places SDK for Android、Place Picker の現行バージョンは 2019 年 1 月 29 日をもって非推奨となり、2019 年 7 月 29 日に提供が終了しました。
- 最新バージョンの Places SDK for iOS に更新してください。
- 最新バージョンの Places SDK for Android に更新してください。
- Place Picker は、2019 年 7 月 29 日をもってご利用いただけなくなりました。
Place Add および Place Delete（2017 年 6 月 30 日～2018 年 6 月 30 日）
2018 年 6 月 30 日をもって Place Add 機能と Place Delete 機能の提供が終了し、ご利用いただけなくなりました。
付録 1: Places SDK for iOS 非推奨 API の代替機能一覧
以下は、非推奨の各メソッドまたはプロパティの代わりに使用するメソッドの一覧です。
代替プロパティがある Places SDK for iOS の最小バージョンは v3.8.0 です。