Add Speech Streaming usage documentation.

docs/speech-usage.rst

@@ -97,6 +97,7 @@ Great Britian.
  transcript: Hello, this is one test
  confidence: 0
 
+
 Example of using the profanity filter.
 
 .. code-block:: python
@@ -141,5 +142,69 @@ words to the vocabulary of the recognizer.
  confidence: 0.81
 
 
+Streaming Recognition
+---------------------
+
+The :meth:`~google.cloud.speech.Client.stream_recognize` method converts speech
+data to possible text alternatives on the fly.
+
+.. note::
+ Streaming recognition requests are limited to 1 minute of audio.
+
+ See: https://cloud.google.com/speech/limits#content
+
+
+ >>> from google.cloud import speech
+ >>> from google.cloud.speech.encoding import Encoding
+ >>> client = speech.Client()
+ >>> with open('hello.flac', 'rb') as content:
+ >>> sample = client.sample(content=content.read(),
+ ... encoding=Encoding.FLAC,
+ ... sample_rate=44100)
+ >>> results = client.stream_recognize(sample)
+ >>> results[0].is_final
+ False
+ >>> results[2].is_final
+ True
+ >>> results[2].alternatives[0].transcript
+ hello
+ >>> results[2].alternatives[0].confidence
+ 0.96976006031
+
+For continuous speech containing more than one word, the ``single_utterance``
+option should be disabled.
+
+See: `Single Utterance`_
+
+.. code-block:: python
+
+ >>> sample = client.sample(source_uri='gs://my-bucket/recording.flac',
+ ... encoding=Encoding.FLAC,
+ ... sample_rate=44100)
+ >>> results = client.stream_recognize(sample, single_utterance=False)
+
+
+If you would like interim results to be returned as well as the final results,
+you can set the ``interim_results`` option to ``True``.
+
+ .. code-block:: python
+
+ >>> sample = client.sample(source_uri='gs://my-bucket/recording.flac',
+ ... encoding=Encoding.FLAC,
+ ... sample_rate=44100)
+ >>> results = client.stream_recognize(sample, interim_results=True)
+ >>> print results[0].alternatives.transcript
+ 'how'
+ >>> print results[0].stability
+ 0.00999999977648
+ >>> print results[2].alternatives.transcript
+ 'hello'
+ >>> print results[2].alternatives.confidence
+ 0.96976006031
+ >>> print results[2].is_final
+ True
+
+
+.. _Single Utterance: https://cloud.google.com/speech/reference/rpc/google.cloud.speech.v1beta1#streamingrecognitionconfig
 .. _sync_recognize: https://cloud.google.com/speech/reference/rest/v1beta1/speech/syncrecognize
 .. _Speech Asynchronous Recognize: https://cloud.google.com/speech/reference/rest/v1beta1/speech/asyncrecognize