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 Global location, 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 Union location, Google will perform machine learning with it only in the EU. If you choose the United States location, 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);