The API loader component loads the Google Maps Platform libraries necessary for Extended Components.
To use this component, make sure you sign up for Google Maps Platform and
create an API
key.
By default, the API loader component will request the beta version of the
Maps JavaScript API, giving you access to additional components <gmp-map>
and
<gmp-advanced-marker>.
However, you can set the version attribute to select a stable (General
Availability) version of the SDK such as weekly.
When loading the library with a <script> tag (referencing the CDN bundle), please refer to the instructions in the root-level Readme. You do not need to take additional steps to use this component.
When bundling your dependencies and you want to include <gmpx-api-loader> on a page:
import '@googlemaps/extended-component-library/api_loader.js';
When bundling your dependencies and you need to access the class APILoader directly (less common):
import { APILoader } from '@googlemaps/extended-component-library/api_loader.js';
| Attribute | Property | Property type | Description | Default | Reflects? |
|---|---|---|---|---|---|
apiKey |
string|undefined |
An alias for the key property. React developers should use this prop to set the API key. |
❌ | ||
auth-referrer-policy |
authReferrerPolicy |
string | undefined |
Maps JS customers can configure HTTP Referrer Restrictions in the Cloud Console to limit which URLs are allowed to use a particular API Key. This parameter can limit the amount of data sent to Google Maps when evaluating HTTP Referrer Restrictions. Please see the documentation for more information. | ✅ | |
key |
key |
string | undefined |
(Required) A valid Google Maps Platform API key. If you don't have one already sign up for Google Maps Platform and create an API key. React developers are encouraged to use the apiKey property instead, as key is a reserved word.You can learn more about API keys in the Google Maps Platform documentation. |
✅ | |
language |
language |
string | undefined |
The language code; defaults to the user's preferred language setting as specified in the browser when displaying textual information. Read more on localization. | ✅ | |
region |
region |
string | undefined |
The region code to use. This alters the map's behavior based on a given country or territory. Read more on region codes. | ✅ | |
solution-channel |
solutionChannel |
string | undefined |
To understand usage and ways to improve our solutions, Google includes the solution_channel query parameter in API calls to gather information about code usage. You may opt out at any time by setting this attribute to an empty string. Read more in the documentation. |
✅ | |
version |
version |
string |
The release channel or version numbers. See the documentation for more information. | 'beta' |
✅ |
Retrieves a reference to the specified Maps JavaScript API library.
Libraries are loaded dynamically from the Maps JavaScript
API.
If an instance of the API is not already available, one will be configured
and loaded based on a <gmpx-api-loader> element in the document.
Returns: ReturnType<typeof google.maps.importLibrary>
Parameters:
| Name | Optional? | Type | Description |
|---|---|---|---|
library |
string |
Name of the library. Full list of libraries can be found in the documentation. | |
consumer |
optional | HTMLElement |
Optionally specify the custom element requesting the library to provide more helpful console warnings when a library cannot be loaded. |
The API Loader component can go anywhere in your web page. For example, you can include it at the beginning of the html <body> where it's easy to notice in source code:
<body>
<gmpx-api-loader key="MY_API_KEY"></gmpx-api-loader>
<!-- Other page content or components -->
</body>