resas-api 0.1.6 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 14469c889832f3c2a1f719ca9866df60c9e04c27
-  data.tar.gz: 573c7392719009bbead1c9961fd7c4e12325dd3c
+  metadata.gz: 33a1a7f2b35f48975f3b6ea00abdacab9f57a315
+  data.tar.gz: 513daf4bb44df639585d9e68ab0fcac7129f5e0d
 SHA512:
-  metadata.gz: 5a9f0e6ebf98a95082b544a8ed292e48380456608eb723f1231ddfe9e912fb0e8d1a67a4547c65d8a6749e77ed2443c235f61e99176170884b9c5ea3b4896087
-  data.tar.gz: 1b5dc9f6c13cd34df1448e4467035543e3e78843d303d4a324d4824a2b32ccb38169b3f7d86c972aa69c8898cbb602c748602d45c446da5708d460592957f37e
+  metadata.gz: 3e19f18c647aed0008bbf680c20f90f37dc932121921dbca7f426942c5a28271d3f46aee57ba703c0d5ff0e8338486de4fe55b69bd7cbc257fcb6b95cb131700
+  data.tar.gz: 5075330f32f5233e4bc0551ef7d4a6ee557a61506cbe5697b1381afcf61a3cf44e4cefa22813ae2eb122ec366c5231333044cafcea63cefb9e679ef0e64f4c99

data/README.md

@@ -12,7 +12,7 @@ gem 'resas-api'
 
 を指定してください。
 
-また、環境変数 RESAS_API_ACCESS_KEY に、[https://opendata.resas-portal.go.jp/form.html]より取得したAPIキーを指定してください。
+また、環境変数 RESAS_API_ACCESS_KEY に、[https://opendata.resas-portal.go.jp/form.html](https://opendata.resas-portal.go.jp/form.html) より取得したAPIキーを指定してください。
 
 ## Usage
 
@@ -32,8 +32,10 @@ res.body
 
 ## Contributing
 
-バグの報告、プルリクエストは[https://github.com/nard-tech/resas-api]までどうぞ。
+バグの報告、プルリクエストは[GitHub nard-tech/resas-api](https://github.com/nard-tech/resas-api)へどうぞ。
+
 Bug reports and pull requests are welcome on GitHub at https://github.com/nard-tech/resas-api.
+
 This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 

data/Rakefile

@@ -1,6 +1,8 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
+load File.expand_path( '../lib/resas/api/tasks/make_methods.rake', __FILE__ )
+
 RSpec::Core::RakeTask.new(:spec)
 
 task :default => :spec

data/lib/resas/api.rb

@@ -1,23 +1,42 @@
-require 'resas/api/version'
-require 'resas/api/client'
-require 'resas/api/client/path'
-require 'resas/api/client/response'
-require 'resas/api/client/response/body'
-require 'resas/api/client/response/body/result'
+require 'nard/appi'
 
+require_relative 'api/version'
+require_relative 'api/api_ext/default_configuration'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
 module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
   module Api
 
-    class << self
-      attr_accessor :api_version
-    end
+    include Nard::Appi::ApiExt::Version
+    include Nard::Appi::ApiExt::Client
+    include Nard::Appi::ApiExt::Configuration
 
-    self.api_version = 'v1-rc.1'
+    include ApiExt::DefaultConfiguration
 
+    include Nard::Appi::ApiExt::Initializer
+
+    # クライアントのオブジェクトを返すメソッド
+    # @param options [Hash] オプション
     # @return [Resas::Api::Client]
-    def self.client
-      @client ||= Resas::Api::Client.instance
+    def self.client( options = {} )
+      super( Resas::Api, options )
+    end
+
+    def self.method_missing( method, *args, &block )
+      return super unless client.respond_to?( method )
+      client.send( method, *args, &block )
+    end
+
+    def self.respond_to?( method, include_all = false )
+      return client.respond_to?( method, include_all ) || super
     end
 
   end
 end
+
+require_relative 'api/client'

data/lib/resas/api/api_ext/default_configuration.rb

@@ -0,0 +1,54 @@
+require 'faraday'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    module ApiExt
+
+      # RESAS API への接続の設定を扱うモジュール
+      # @note
+      #   Constants:
+      #     OPTIONS_KEYS
+      #     DEFAULT_ACCESS_KEY, DEFAULT_BASE_URL, DEFAULT_FORMAT, DEFAULT_API_VERSION, DEFAULT_ADAPTER
+      module DefaultConfiguration
+
+        include Nard::Appi::ApiExt::DefaultConfiguration
+
+        default(
+          # APIキー
+          # @see {https://opendata.resas-portal.go.jp/form.html}
+          # @return [String]
+          access_key: ENV[ 'RESAS_API_ACCESS_KEY' ],
+
+          # RESAS API エンドポイント
+          # @return [String]
+          # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+          base_url: 'https://opendata.resas-portal.go.jp',
+
+          # API から取得する値のフォーマット
+          # @return [String]
+          format: :json,
+
+          # 接続先の RESAS API のバージョン
+          # @return [String]
+          # @note Default: v1-rc.1
+          # @note この Gem のバージョンではない！ Gem のバージョンは、Resas::Api::VERSION または Resas::Api.gem_version で取得する。
+          # @todo [Future] API の仕様が大幅に変更された場合の場合分け
+          api_version: 'v1-rc.1',
+
+          # Faraday で使用する HTTP クライアントの種類
+          # @return [Net::HTTP] (Default)
+          adapter: Faraday.default_adapter
+        )
+
+      end
+
+    end
+  end
+end

data/lib/resas/api/client.rb

@@ -1,38 +1,43 @@
+require 'nard/appi/client'
+
+require 'active_support'
+require 'active_support/core_ext'
 require 'uri'
-require 'net/http'
-require 'singleton'
 
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
 module Resas
-  module Api
-    class Client
-
-      include Singleton
 
-      API_ENDPOINT = 'https://opendata.resas-portal.go.jp'
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
 
-      def initialize
-        uri = ::URI.parse( API_ENDPOINT )
+    # RESAS API へアクセスするクライアントのクラス
+    # @note 実際の通信には Gem 'Faraday' を利用する。
+    class Client < Nard::Appi::Client
 
-        @http = Net::HTTP.new( uri.host, uri.port )
-        @http.use_ssl = ( uri.scheme == 'https' )
+      filenames = [
+        :connection,
+        :request,
+        :endpoint,
+      ]
 
-        @header = { 'X-API-KEY' => ENV[ 'RESAS_API_ACCESS_KEY' ], 'Content-Type' => 'application/json' }
-        # @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      filenames.each do | filename |
+        require File.expand_path( "../client_ext/#{ filename }", __FILE__ )
+        include Resas::Api::ClientExt.const_get( filename.capitalize )
       end
 
-      def get( *args )
-        api_version = Resas::Api.api_version
-        response = @http.get( Resas::Api::Client::Path.get( api_version, *args ), @header )
-        Resas::Api::Client::Response.new( response )
+      def initialize( options = {} )
+        super( Resas::Api, options )
       end
 
-      # @return [URI::HTTP]
-      def path( *args )
-        api_version = Resas::Api.api_version
-        URI.join( API_ENDPOINT, Resas::Api::Client::Path.get( api_version, *args ) )
+      # API のエンドポイント（APIのバージョンを含む）
+      # @return [URI::HTTPS]
+      def base_endpoint
+        URI.join( base_url, "/api/#{ api_version }" )
       end
 
     end
-
   end
 end

data/lib/resas/api/client/util/base_normalizer.rb

@@ -0,0 +1,36 @@
+require 'nard/appi/client/util/base_normalizer'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    class Client
+
+      # RESAS API を扱うための補助的な機能を格納する名前空間
+      module Util
+
+        # API へ送る情報を処理するクラス（基底クラス）
+        class BaseNormalizer < Nard::Appi::Client::Util::BaseNormalizer
+
+          private
+
+          def normalize_key( key )
+            key.to_s.camelize( :lower )
+          end
+
+          def normalize_value( value )
+            [ value ].flatten.join( ',' )
+          end
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/resas/api/client/util/path_settings_normalizer.rb

@@ -0,0 +1,37 @@
+require_relative './base_normalizer'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    class Client
+
+      # RESAS API を扱うための補助的な機能を格納する名前空間
+      module Util
+
+        # RESAS API のパスを処理するクラス
+        class PathSettingsNormalizer < BaseNormalizer
+
+          attr_reader :full
+
+          private
+
+          def set_special_options( options )
+            @full = normalize_boolean_option( options, :full, default: true )
+          end
+
+          def special_options
+            [ @full ]
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/resas/api/client/util/request_settings_normalizer.rb

@@ -0,0 +1,39 @@
+require_relative './base_normalizer'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    class Client
+
+      # RESAS API を扱うための補助的な機能を格納する名前空間
+      module Util
+
+        # RESAS API へのリクエストを処理するクラス
+        class RequestSettingsNormalizer < BaseNormalizer
+
+          attr_reader :parse_json, :generate_instance
+
+          private
+
+          def set_special_options( options )
+            @parse_json = normalize_boolean_option( options, :parse_json, default: true )
+            @generate_instance = normalize_boolean_option( options, :generate_instance, default: false )
+          end
+
+          def special_options
+            [ @parse_json, @generate_instance ]
+          end
+
+        end
+
+      end
+
+    end
+  end
+end

data/lib/resas/api/client_ext/connection.rb

@@ -0,0 +1,56 @@
+require 'faraday'
+require 'faraday_middleware'
+
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    module ClientExt
+
+      # Gem 'Faraday' を用いて RESAS API へ接続する機能を格納するモジュール
+      module Connection
+
+        private
+
+        # @return [Faraday::Connection]
+        def connection( parse_json:, generate_instance: )
+          # @note
+          # {https://github.com/lostisland/faraday_middleware/wiki}
+          # Important: same as with Rack middleware, the order of middleware on a Faraday stack is significant. General guidelines:
+          # 1. put request middleware first, in order of importance;
+          # 2. put response middleware second, [in the reverse order of importance];
+          # 3. ensure that the adapter is always last.
+          Faraday::Connection.new( options_for_connection ) do | con |
+            con.request :json
+
+            # URL をエンコードする
+            con.use Faraday::Request::UrlEncoded
+
+            # 結果のJSONをパースする
+            con.response :json if parse_json
+
+            # アダプターを選択する
+            con.adapter( adapter )
+          end
+        end
+
+        # @return [Hash]
+        def options_for_connection
+          {
+            headers: {
+              'X-API-KEY' => access_key,
+              'Content-Type' => "application/#{ format };charset=UTF-8"
+            },
+            url: base_endpoint,
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/resas/api/client_ext/endpoint.rb

@@ -0,0 +1,414 @@
+# RESAS (Regional Economy Society Analyzing System) に関する機能を格納する名前空間
+# @see {https://resas.go.jp/}
+module Resas
+
+  # RESAS API を扱うための Gem - トップの名前空間
+  # @see {https://opendata.resas-portal.go.jp/}
+  # @see {https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html}
+  module Api
+
+    module ClientExt
+
+      # 各 API のエンドポイントに直接アクセスするためのメソッドを格納するモジュール
+      # @see API概要 > 一覧 (https://opendata.resas-portal.go.jp/docs/api/v1-rc.1/index.html)
+      module Endpoint
+
+        # @!group 共通 > 都道府県、市区町村
+
+        # 都道府県一覧 (prefectures)
+        def prefectures( params = {} )
+          get( 'prefectures', params )
+        end
+
+        # 市区町村一覧 (cities)
+        def cities( params = {} )
+          get( 'cities', params )
+        end
+
+        # 旧市区町村一覧 (oldCities)
+        def old_cities( params = {} )
+          get( 'oldCities', params )
+        end
+
+        # @!group 共通 > 産業 (industries)
+
+        # 産業大分類 (industries/broad)
+        def industries_broad( params = {} )
+          get( 'industries/broad', params )
+        end
+
+        # 産業中分類 (industries/middle)
+        def industries_middle( params = {} )
+          get( 'industries/middle', params )
+        end
+
+        # 産業小分類 (industries/narrow)
+        def industries_narrow( params = {} )
+          get( 'industries/narrow', params )
+        end
+
+        # @!group 共通 > 職業 (jobs)
+
+        # 職業大分類 (jobs/broad)
+        def jobs_broad( params = {} )
+          get( 'jobs/broad', params )
+        end
+
+        # 職業中分類 (jobs/middle)
+        def jobs_middle( params = {} )
+          get( 'jobs/middle', params )
+        end
+
+        # @!group 共通 > 特許 (patents)
+
+        # 特許 技術分野 (patents/broad)
+        def patents_broad( params = {} )
+          get( 'patents/broad', params )
+        end
+
+        # 特許 技術テーマ (patents/middle)
+        def patents_middle( params = {} )
+          get( 'patents/middle', params )
+        end
+
+        # 特許権者の所在地 (patents/locations)
+        def patents_locations( params = {} )
+          get( 'patents/locations', params )
+        end
+
+        # @!group 共通 > 世界の地域・国 (regions)
+
+        # 取引地域 (regions/broad)
+        def regions_broad( params = {} )
+          get( 'regions/broad', params )
+        end
+
+        # 取引国 (regions/middle)
+        def regions_middle( params = {} )
+          get( 'regions/middle', params )
+        end
+
+        # @!group 共通 > 輸出入花火図 (tradeInfoItemTypes)
+
+        # 品目 大分類 (tradeInfoItemTypes/broad)
+        def trade_info_item_types_broad( params = {} )
+          get( 'tradeInfoItemTypes/broad', params )
+        end
+
+        # 品目 中分類 (tradeInfoItemTypes/middle)
+        def trade_info_item_types_middle( params = {} )
+          get( 'tradeInfoItemTypes/middle', params )
+        end
+
+        # 品目 小分類 (tradeInfoItemTypes/narrow)
+        def trade_info_item_types_narrow( params = {} )
+          get( 'tradeInfoItemTypes/narrow', params )
+        end
+
+        # @!group 共通 > その他
+
+        # 税関 (customs)
+        def customs( params = {} )
+          get( 'customs', params )
+        end
+
+        # 農業部門 (regions/agricultureDepartments)
+        def regions_agriculture_departments( params = {} )
+          get( 'regions/agricultureDepartments', params )
+        end
+
+        # @!group 産業 (industry)
+
+        # 特許一覧 (industry/patent/list)
+        def industry_patent_list( params = {} )
+          get( 'industry/patent/list', params )
+        end
+
+        # 国、税関別輸出入 (industry/export/fromTo)
+        def industry_export_from_to( params = {} )
+          get( 'industry/export/fromTo', params )
+        end
+
+        # 海外への企業進出動向向 (industry/globalmarket/perPref)
+        def industry_global_market_per_pref( params = {} )
+          get( 'industry/globalmarket/perPref', params )
+        end
+
+        # 産業別特化係数 (industry/power/forIndustry)
+        def industry_power_for_industry( params = {} )
+          get( 'industry/power/forIndustry', params )
+        end
+
+        # 地域別特化係数 (industry/power/forArea)
+        def industry_power_for_area( params = {} )
+          get( 'industry/power/forArea', params )
+        end
+
+        # 製造業事業所単位分析_継続・参入・退出事業所別の推移 (industry/power/forManufacturerEstablishments)
+        def industry_power_for_manufacturer_establishments( params = {} )
+          get( 'industry/power/forManufacturerEstablishments', params )
+        end
+
+        # @!group 農林水産業 > 農業 (agriculture)
+
+        # 農産物の出荷先別販売金額構成 (agriculture/sales/shipValue)
+        def agriculture_sales_ship_value( params = {} )
+          get( 'agriculture/sales/shipValue', params )
+        end
+
+        # 農産物の出荷先別経営体数割合 (agriculture/sales/shipRatio)
+        def agriculture_sales_ship_ratio( params = {} )
+          get( 'agriculture/sales/shipRatio', params )
+        end
+
+        # 経営耕地面積 (agriculture/land/forStacked)
+        def agriculture_land_for_stacked( params = {} )
+          get( 'agriculture/land/forStacked', params )
+        end
+
+        # 経営耕地面積規模別の経営体割合 (agriculture/land/Ratio)
+        def agriculture_land_ratio( params = {} )
+          get( 'agriculture/land/Ratio', params )
+        end
+
+        # 農地流動化率 (agriculture/land/forMobility)
+        def agriculture_land_for_mobility( params = {} )
+          get( 'agriculture/land/forMobility', params )
+        end
+
+        # 耕作放棄地率 (agriculture/land/forAbandonment)
+        def agriculture_land_for_abandonment( params = {} )
+          get( 'agriculture/land/forAbandonment', params )
+        end
+
+        # 農業部門別販売金額 (agriculture/all/forStacked)
+        def agriculture_all_for_stacked( params = {} )
+          get( 'agriculture/all/forStacked', params )
+        end
+
+        # 年間延べ農作業日数 (agriculture/crops/workingDays)
+        def agriculture_crops_working_days( params = {} )
+          get( 'agriculture/crops/workingDays', params )
+        end
+
+        # 農産物販売金額（人日あたり） (agriculture/crops/sales)
+        def agriculture_crops_sales( params = {} )
+          get( 'agriculture/crops/sales', params )
+        end
+
+        # 農業経営者・農業就業人口の年齢構成 (agriculture/crops/farmersAgeStructure)
+        def agriculture_crops_farmers_age_structure( params = {} )
+          get( 'agriculture/crops/farmersAgeStructure', params )
+        end
+
+        # 農業経営者・農業就業人口の平均年齢 (agriculture/crops/farmersAverageAge)
+        def agriculture_crops_farmers_average_age( params = {} )
+          get( 'agriculture/crops/farmersAverageAge', params )
+        end
+
+        # 農業生産関連事業の実施状況（経営体数） (agriculture/crops/relatedBusiness)
+        def agriculture_crops_related_business( params = {} )
+          get( 'agriculture/crops/relatedBusiness', params )
+        end
+
+        # 農業経営体の法人化率 (agriculture/crops/averageOfCorporate)
+        def agriculture_crops_average_of_corporate( params = {} )
+          get( 'agriculture/crops/averageOfCorporate', params )
+        end
+
+        # @!group 農林水産業 > 林業 (forestry)
+
+        # 林業総収入（総額） (forestry/income/forStacked)
+        def forestry_income_for_stacked( params = {} )
+          get( 'forestry/income/forStacked', params )
+        end
+
+        # 林産物販売金額（経営体あたり） (forestry/income/forSales)
+        def forestry_income_for_sales( params = {} )
+          get( 'forestry/income/forSales', params )
+        end
+
+        # 林作業請負収入（経営体あたり） (forestry/income/forContractRevenue)
+        def forestry_income_for_contract_revenue( params = {} )
+          get( 'forestry/income/forContractRevenue', params )
+        end
+
+        # 林産物販売金額帯別の経営体割合 (forestry/income/forSalesRatio)
+        def forestry_income_for_sales_ratio( params = {} )
+          get( 'forestry/income/forSalesRatio', params )
+        end
+
+        # 林作業請負収入金額帯別の経営体割合 (forestry/income/forContractRevenueRatio)
+        def forestry_income_for_contract_revenue_ratio( params = {} )
+          get( 'forestry/income/forContractRevenueRatio', params )
+        end
+
+        # 主要林業部門別延べ経営体数 (forestry/income/allPortfolio)
+        def forestry_income_all_portfolio( params = {} )
+          get( 'forestry/income/allPortfolio', params )
+        end
+
+        # 主要林業部門別延べ経営体数構成 (forestry/income/allForStacked)
+        def forestry_income_all_for_stacked( params = {} )
+          get( 'forestry/income/allForStacked', params )
+        end
+
+        # @!group 農林水産業 > 水産業 (fishery)
+
+        # 主要海面漁業種類別延べ経営体数構成 (fishery/sea/staple)
+        def fishery_sea_staple( params = {} )
+          get( 'fishery/sea/staple', params )
+        end
+
+        # 海面漁獲物等販売金額（総額） (fishery/sea/totalSales)
+        def fishery_sea_total_sales( params = {} )
+          get( 'fishery/sea/totalSales', params )
+        end
+
+        # 海面漁獲物等販売金額（経営体あたり） (fishery/sea/managementUnitSales)
+        def fishery_sea_management_unit_sales( params = {} )
+          get( 'fishery/sea/managementUnitSales', params )
+        end
+
+        # 海面漁獲物等販売金額帯別の経営体割合 (fishery/sea/sales)
+        def fishery_sea_sales( params = {} )
+          get( 'fishery/sea/sales', params )
+        end
+
+        # 海面漁獲物等出荷先別販売金額構成 (fishery/sea/shipValue)
+        def fishery_sea_ship_value( params = {} )
+          get( 'fishery/sea/shipValue', params )
+        end
+
+        # 海面漁獲物等出荷先別経営体数割合 (fishery/sea/shipRatio)
+        def fishery_sea_ship_ratio( params = {} )
+          get( 'fishery/sea/shipRatio', params )
+        end
+
+        # 海面養殖販売金額（総額） (fishery/sea/aquacultureTotalSales)
+        def fishery_sea_aquaculture_total_sales( params = {} )
+          get( 'fishery/sea/aquacultureTotalSales', params )
+        end
+
+        # 海面養殖販売金額（経営体あたり） (fishery/sea/aquacultureManagementUnitSales)
+        def fishery_sea_aquaculture_management_unit_sales( params = {} )
+          get( 'fishery/sea/aquacultureManagementUnitSales', params )
+        end
+
+        # 海面養殖販売金額帯別の経営体割合 (fishery/sea/aquacultureSales)
+        def fishery_sea_aquaculture_sales( params = {} )
+          get( 'fishery/sea/aquacultureSales', params )
+        end
+
+        # @!group 観光 (tourism)
+
+        # 指定地域への国籍別訪問者数 (tourism/foreigners/forFrom)
+        def tourism_foreigners_for_from( params = {} )
+          get( 'tourism/foreigners/forFrom', params )
+        end
+
+        # 指定国籍からの訪問者数 (tourism/foreigners/forTo)
+        def tourism_foreigners_for_to( params = {} )
+          get( 'tourism/foreigners/forTo', params )
+        end
+
+        # @!group 人口 (population)
+
+        # 人口の自然増減 (population/nature)
+        def population_nature( params = {} )
+          get( 'population/nature', params )
+        end
+
+        # 人口構成 (population/composition/perYear)
+        def population_composition_per_year( params = {} )
+          get( 'population/composition/perYear', params )
+        end
+
+        # 人口ピラミッド (population/composition/pyramid)
+        def population_composition_pyramid( params = {} )
+          get( 'population/composition/pyramid', params )
+        end
+
+        # 人口増減率 (population/sum/perYear)
+        def population_sum_per_year( params = {} )
+          get( 'population/sum/perYear', params )
+        end
+
+        # 出生数・死亡数／転入数・転出数 (population/sum/estimate)
+        def population_sum_estimate( params = {} )
+          get( 'population/sum/estimate', params )
+        end
+
+        # 将来人口推計 (population/future/cities)
+        def population_future_cities( params = {} )
+          get( 'population/future/cities', params )
+        end
+
+        # @!group 自治体比較 (municipality)
+
+        # 企業数 (municipality/company/perYear)
+        def municipality_company_per_year( params = {} )
+          get( 'municipality/company/perYear', params )
+        end
+
+        # 事業所数 (municipality/plant/perYear)
+        def municipality_plant_per_year( params = {} )
+          get( 'municipality/plant/perYear', params )
+        end
+
+        # 創業比率 (municipality/foundation/perYear)
+        def municipality_foundation_per_year( params = {} )
+          get( 'municipality/foundation/perYear', params )
+        end
+
+        # 一人当たり地方税 (municipality/taxes/perYear)
+        def municipality_taxes_per_year( params = {} )
+          get( 'municipality/taxes/perYear', params )
+        end
+
+        # 有効求人倍率 (municipality/job/perYear)
+        def municipality_job_per_year( params = {} )
+          get( 'municipality/job/perYear', params )
+        end
+
+        # 製造品出荷額 (municipality/manufacture/perYear)
+        def municipality_manufacture_per_year( params = {} )
+          get( 'municipality/manufacture/perYear', params )
+        end
+
+        # 従業者数（事業所単位） (municipality/employee/perYear)
+        def municipality_employee_per_year( params = {} )
+          get( 'municipality/employee/perYear', params )
+        end
+
+        # 付加価値額（企業単位） (municipality/value/perYear)
+        def municipality_value_per_year( params = {} )
+          get( 'municipality/value/perYear', params )
+        end
+
+        # 労働生産性（企業単位） (municipality/labor/perYear)
+        def municipality_labor_per_year( params = {} )
+          get( 'municipality/labor/perYear', params )
+        end
+
+        # 黒字赤字企業比率 (municipality/surplus/perYear)
+        def municipality_surplus_per_year( params = {} )
+          get( 'municipality/surplus/perYear', params )
+        end
+
+        # 一人当たり賃金 (municipality/wages/perYear)
+        def municipality_wages_per_year( params = {} )
+          get( 'municipality/wages/perYear', params )
+        end
+
+        # 年間商品販売額 (municipality/sales/perYear)
+        def municipality_sales_per_year( params = {} )
+          get( 'municipality/sales/perYear', params )
+        end
+
+        # @!endgroup
+
+      end
+    end
+  end
+end