NAME
    WWW::Google::AutoSuggest - Query the Google services to retrieve the
    query suggestions

SYNOPSIS
      use WWW::Google::AutoSuggest;
      my $AutoSuggest=WWW::Google::AutoSuggest->new();
      my @Suggestions = $AutoSuggest->search("perl");
      ###### or
      use WWW::Google::AutoSuggest;
      my $AutoSuggest=WWW::Google::AutoSuggest->new(domain=> "it" ,json=>1); #uses www.google.it instead of .com
      my $result = $AutoSuggest->search("perl");
      # $result now is a decoded JSON arrayref
      ###### or with the html tags
      use WWW::Google::AutoSuggest;
      my $AutoSuggest=WWW::Google::AutoSuggest->new(strip_html=>0);
      my @Suggestions = $AutoSuggest->search("perl");

DESCRIPTION
    WWW::Google::AutoSuggest allows you to use Google Suggest in a quick and
    easy way and returning it as decoded JSON for further inspection

ARGUMENTS
    json
          my $AutoSuggest=WWW::Google::AutoSuggest->new(json=>1);

        or

          $AutoSuggest->json(1);

        Explicitally enable the return of the decoded JSON object when
        calling "search("term")"

    strip_html
          my $AutoSuggest=WWW::Google::AutoSuggest->new(strip_html=>0);

        or

          $AutoSuggest->strip_html(0);

        Explicitally disable the stripping of the HTML contained in the
        google responses

    raw
          my $AutoSuggest=WWW::Google::AutoSuggest->new(raw=>1);

        or

          $AutoSuggest->raw(1);

        Explicitally enable the return of the response content when calling
        "search("term")"

    domain
          my $AutoSuggest=WWW::Google::AutoSuggest->new(domain=>"it");

        or

          $AutoSuggest->domain("it");

        Explicitally use the Google domain name in the request

METHODS
    new
          my $AutoSuggest=WWW::Google::AutoSuggest->new();

        Creates a new WWW::Google::AutoSuggest object

    search
          my @Suggestions = $AutoSuggest->search($query);

        Sends your $query to Google web server and fetches and parse
        suggestions for the given query. Default returns an array of that
        form

          @Suggestions = ( 'foo bar' , 'baar foo',..);

        Setting $AutoSuggest->json(1);

        will return the JSON object

AUTHOR
    mudler <mudler@dark-lab.net>

COPYRIGHT
    Copyright 2014 mudler

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    <https://metacpan.org/pod/WebService::Google::Suggest>