Error Handling Stay organized with collections Save and categorize content based on your preferences.

This page describes how to handle errors when using the Maps JavaScript API, and the Place class.

The Google Maps JavaScript API uses the following classes for errors:

• MapsNetworkError represents a network error from a web service (can include RPCStatus errors).
• MapsRequestError represents a request error from a web service (i.e. the equivalent of a 4xx code in HTTP).
• MapsServerError represents a server-side error from a web service (i.e. the equivalent of a 5xx code in HTTP).

The MapsNetworkError, MapsRequestError, and MapsServerError classes belong to the maps core library. Learn more about libraries.

Each of these classes contains the following properties:

• code
• endpoint

The code property identifies the type of error; the endpoint property identifies the endpoint that returned the error (for example PLACES_DETAILS). Since MapsNetworkError is a subclass of Error, other properties including name and message are also available.

The following snippet shows the structure of a Maps error message:

  MapsRequestError: PLACES_GET_PLACE: INVALID_ARGUMENT: Error fetching fields: The provided Place ID: ChIJN5Nz71W3j4ARhx5bwpTQEGg**** is not valid.
  [error.name     ] [error.endpoint ] [error.code     ]
                    [error.message --->                ... ]
  

The raw error includes everything in the error string; error.message includes the entire error string excluding error.name.

The following snippet demonstrates error handling when using the Place class. This example uses a try/catch block to handle each of the three error types. Similar code can be used to handle errors for any Maps JavaScript API class.

async function getPlaceDetails() {
    const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
    const { MapsNetworkError, MapsRequestError, MapsServerError } = await google.maps.importLibrary("core") as google.maps.CoreLibrary;

    // Use place ID to create a new Place instance.
    const place = new Place({
        id: 'ChIJN5Nz71W3j4ARhx5bwpTQEGg****', // Pass a bad Place ID to trigger an error.
    });

    // Error handling for fetchFields.
    try {
        // Call fetchFields, passing the desired data fields.
        await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] });
    } catch (error: any) {
        if (error && error instanceof google.maps.MapsRequestError) {
            // HTTP 4xx request error.
            console.error('fetchFields failed: MapsRequestError - check the request parameters', error);
        } else if (error && error instanceof google.maps.MapsServerError) {
            // HTTP 5xx server-side error.
            console.error('fetchFields failed: MapsServerError', error);
        } else if (error && error instanceof google.maps.MapsNetworkError) {
            // Network error.
            console.error('fetchFields failed: MapsNetworkError', error);
        }  else {
            console.error('fetchFields failed: An unknown error occurred', error);
        }
    }
    // ...
}