Locations

Cloud Natural Language offers you some control over where the resources for your project are processed. In particular, you can configure Cloud Natural Language to perform machine learning processing on your data only in the EU or the US.

By default Cloud Natural Language processes resources in a Globallocation, which means that Cloud Natural Language doesn't guarantee that your resources will remain within a particular location or region. If you choose the European Unionlocation, Google will perform machine learning with it only in the EU. If you choose the United Stateslocation, Google will perform machine learning with it only in the US. You and your users can access the data from any location.

Setting the location using the API

Cloud Natural Language supports a global API endpoint ( language.googleapis.com ), a European Union endpoint ( eu-language.googleapis.com ), and a United States endpoint ( us-language.googleapis.com ). To process your data in the European Union only, use the URI eu-language.googleapis.com in place of language.googleapis.com for your REST API calls. To process your data in the United States only, use the URI us-language.googleapis.com in place of language.googleapis.com for your REST API calls.

The text moderation API is also available in Australia, which can be accessed by using the URI au-language.googleapis.com in place of language.googleapis.com for your REST API calls.

Setting the location using client libraries

The client libraries access the global API endpoint ( language.googleapis.com ) by default. To store and process your data in the European Union or United States only, you need to explicitly set the endpoint. The code samples below show how to configure this setting.

  # Imports the Google Cloud client library 
 from 
  
 google.cloud 
  
 import 
 language_v1 
 client_options 
 = 
 { 
 "api_endpoint" 
 : 
 "eu-language.googleapis.com:443" 
 } 
 # Instantiates a client. 
 client 
 = 
 language_v1 
 . 
 LanguageServiceClient 
 ( 
 client_options 
 = 
 client_options 
 ) 
 

  LanguageServiceSettings 
  
 settings 
  
 = 
  
 LanguageServiceSettings 
 . 
 newBuilder 
 (). 
 setEndpoint 
 ( 
 "eu-language.googleapis.com:443" 
 ). 
 build 
 (); 
 // Initialize client that will be used to send requests. This client only needs to be created 
 // once, and can be reused for multiple requests. After completing all of your requests, call 
 // the "close" method on the client to safely clean up any remaining background resources. 
 LanguageServiceClient 
  
 client 
  
 = 
  
 LanguageServiceClient 
 . 
 create 
 ( 
 settings 
 ); 
 

  // Imports the Google Cloud client library 
 const 
  
 language 
  
 = 
  
 require 
 ( 
 ' @google-cloud/language 
' 
 ); 
 // Specifies the location of the api endpoint 
 const 
  
 clientOptions 
  
 = 
  
 { 
 apiEndpoint 
 : 
  
 'eu-language.googleapis.com' 
 }; 
 // Instantiates a client 
 const 
  
 client 
  
 = 
  
 new 
  
 language 
 . 
  LanguageServiceClient 
 
 ( 
 clientOptions 
 );