places.get_place.js

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// ** This file is automatically generated by gapic-generator-typescript. **
// ** https://github.com/googleapis/gapic-generator-typescript **
// ** All changes to this file may be overwritten. **



'use strict';

function main(name) {
  // [START places_v1_generated_Places_GetPlace_async]
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. The resource name of a place, in the `places/{place_id}` format.
   */
  // const name = 'abc123'
  /**
   *  Optional. Place details will be displayed with the preferred language if
   *  available.
   *  Current list of supported languages:
   *  https://developers.google.com/maps/faq#languagesupport.
   */
  // const languageCode = 'abc123'
  /**
   *  Optional. The Unicode country/region code (CLDR) of the location where the
   *  request is coming from. This parameter is used to display the place
   *  details, like region-specific place name, if available. The parameter can
   *  affect results based on applicable law.
   *  For more information, see
   *  https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.
   *  Note that 3-digit region codes are not currently supported.
   */
  // const regionCode = 'abc123'
  /**
   *  Optional. A string which identifies an Autocomplete session for billing
   *  purposes. Must be a URL and filename safe base64 string with at most 36
   *  ASCII characters in length. Otherwise an INVALID_ARGUMENT error is
   *  returned.
   *  The session begins when the user starts typing a query, and concludes when
   *  they select a place and a call to Place Details or Address Validation is
   *  made. Each session can have multiple queries, followed by one Place Details
   *  or Address Validation request. The credentials used for each request within
   *  a session must belong to the same Google Cloud Console project. Once a
   *  session has concluded, the token is no longer valid; your app must generate
   *  a fresh token for each session. If the `session_token` parameter is
   *  omitted, or if you reuse a session token, the session is charged as if no
   *  session token was provided (each request is billed separately).
   *  We recommend the following guidelines:
   *  * Use session tokens for all Place Autocomplete calls.
   *  * Generate a fresh token for each session. Using a version 4 UUID is
   *    recommended.
   *  * Ensure that the credentials used for all Place Autocomplete, Place
   *    Details, and Address Validation requests within a session belong to the
   *    same Cloud Console project.
   *  * Be sure to pass a unique session token for each new session. Using the
   *    same token for more than one session will result in each request being
   *    billed individually.
   */
  // const sessionToken = 'abc123'

  // Imports the Places library
  const {PlacesClient} = require('@googlemaps/places').v1;

  // Instantiates a client
  const placesClient = new PlacesClient();

  async function callGetPlace() {
    // Construct request
    const request = {
      name,
    };

    // Run request
    const response = await placesClient.getPlace(request);
    console.log(response);
  }

  callGetPlace();
  // [END places_v1_generated_Places_GetPlace_async]
}

process.on('unhandledRejection', err => {
  console.error(err.message);
  process.exitCode = 1;
});
main(...process.argv.slice(2));