How to Create Java NLP Apps using Google NLP API


Natural language processing (NLP) is an AI-based technology which is used for creating apps related to speech recognition, natural-language understanding, and natural-language generation. Some of the applications related to NLP are content classification, sentiment analysis, syntactic analysis etc.

In this post, you will learn about how to get set up with a development environment for creating NLP based apps using Google Cloud NLP APIs.

Setup Eclipse-based Development Environment for Google NLP API

The steps below would help you get setup with Eclipse IDE and Java-based development environment for developing apps using Google Cloud Natural Language API.

  • Create Google Project: Create a project by logging into Google Cloud console. I created a project such as NLP-Sample. Select the project that you just created.
  • Go to Cloud NLP API Page: From Google cloud console, go to Google Natural Language API page by searching using the keyword such as “google cloud natural language API” as shown in the diagram google cloud natural language processing apiAlternatively, go to Google Cloud Natural Language API page and select the project you created in the previous step.
  • Enable Cloud NLP API: Enable the Google cloud NLP API by clicking on Enable button. The following screenshot represents ENABLE cloud natural language api - enable project
  • Create Service Account Key: Create Service account key using which you will access the Google NLP APIs from your Java programs. From Google NLP dashboard, click on “Credentials” link as shown in the left navigation. Then, click on “create credentials” and select service account nlp api - create service account keyEnter the details in the form as shown in the diagram below and submit.

    google nlp api - create service account key

    This would download the service account key in a JSON file. The service account key file looks like following:

        "type": "service_account",
        "project_id": "nlp-sample-194807",
        "private_key_id": "6fcfbf135fd46c60256453621919d60ecea5564b",
        "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEv...XXkhk=\n-----END PRIVATE KEY-----\n",
        "client_email": "",
        "client_id": "118019199276547406057",
        "auth_uri": "",
        "token_uri": "",
        "auth_provider_x509_cert_url": "",
        "client_x509_cert_url": ""
  • Create a Maven Project: Create a Maven project in Eclipse
  • Include Google Cloud NLP API Dependency in POM: Put following in pom.xml file.
  • Configure Google Application Credentials: Configure GOOGLE_APPLICATION_CREDENTIALS as environment variable whose value is the file path for service account key which gets downloaded as a result of creating credential as service-account-key.
    Configure Eclipse Project Runtime Environment Variable

    Figure . Configure Eclipse Project Runtime Environment Variable

  • Test a sample Java app related to content classification: Place following code in
    package com.vflux.nlpdemo;
    public class App 
      public static void main(String... args) throws Exception {
          String text = "The two sides also signed agreements worth around USD 50 million that includes setting up of a USD 30 million super specialty hospital after Palestinian President Mahmoud Abbas received Prime Minister Modi in an official ceremony at the presidential compound, also known as Muqata&#39;a, in Ramallah - the Palestinian seat of government. On his part, President Abbas acknowledged that the Indian leadership has always stood by peace in Palestine. Abbas said Palestine is always ready to engage in negotiations to achieve its goal of an independent state. He asked India to facilitate the peace process with Israel. We rely on India&#39;s role as an international voice of great standing and weigh through its historical role in the Non-Aligned Movement and in all international forum and its increasingly growing power on the strategic and economic levels, in a way that is conducive to just and desired peace in our region, said President Abbas. The two sides signed agreements worth USD 50 million. The agreement includes setting up of a super speciality hospital worth USD 30 million in Beit Sahur and construction of a centre for empowering women worth USD 5 million. Three agreements in the education sector worth USD 5 million and for procurement of equipment and machinery for the National Printing Press in Ramallah were also signed.";
          try (LanguageServiceClient language = LanguageServiceClient.create()) {
                // set content to the text string
                Document doc = Document.newBuilder()
                ClassifyTextRequest request = ClassifyTextRequest.newBuilder()
                // detect categories in the given text
                ClassifyTextResponse response = language.classifyText(request);
                for (ClassificationCategory category : response.getCategoriesList()) {
                  System.out.printf("Category name : %s, Confidence : %.3f\n",
                      category.getName(), category.getConfidence());
  • Run the above program and you would get the following output:
    Category name : /News, Confidence : 0.550
    Category name : /Law &amp; Government/Government, Confidence : 0.500

Further Reading / Reference


In this post, you learned about how to get set up with Google Cloud Natural Language API with Java.

Did you find this article useful? Do you have any questions or suggestions about this article in relation to setting up the development environment for Google cloud natural language API using Eclipse IDE and Java? Leave a comment and ask your questions and I shall do my best to address your queries.

Ajitesh Kumar

Ajitesh Kumar

Ajitesh is passionate about various different technologies including programming languages such as Java/JEE, Javascript, PHP, C/C++, mobile programming languages etc, and, computing fundamentals related with cloud-native technologies, application security, cloud computing platforms, mobile apps, big data etc.

He has also authored the book, Building Web Apps with Spring 5 and Angular.
Ajitesh Kumar

Leave A Reply

Time limit is exhausted. Please reload the CAPTCHA.