Documentation mentions deprecated methods

[MrAmericanMike]

Not much, just reporting this so the documentation can be updated.

On the README.md there are 2 methods for using the library mentioned loader.load() and loader.loadCallback() but both methods are deprecated.

[wangela]

If you would like to upvote the priority of this issue, please comment below or react with 👍 so we can see what is popular when we triage.

@MrAmericanMike Thank you for opening this issue. 🙏
Please check out these other resources that might help you get to a resolution in the meantime:

• Check the issue tracker - bugs and feature requests for Google Maps Platform APIs and SDKs
• Open a support case - Get 1:1 support in Cloud Console.
• Discord - chat with other developers
• StackOverflow - use the google-maps tag

This is an automated message, feel free to ignore.

[higgjd]

@MrAmericanMike I can see that this has deprecated too. Do you happen to know what I can use instead of .load?

[MrAmericanMike]

@MrAmericanMike I can see that this has deprecated too. Do you happen to know what I can use instead of .load?

Yes the one that works is using importLibrary Also mentioned in the documentation. That one works fine.

// Promise for a specific library
loader
  .importLibrary('maps')
  .then(({Map}) => {
    new Map(document.getElementById("map"), mapOptions);
  })
  .catch((e) => {
    // do something
  });

[chrisjshull]

Yes, importLibrary is now recommended over load.

[higgjd]

Great thank you both!

[owaisahmed5300]

Yes, but what if we need to load multiple libraries at once? When I call import Library multiple times I get error:

Google Maps already loaded outside @googlemaps/js-api-loader.This may result in undesirable behavior as options and script parameters may not match.

[owaisahmed5300]

There should be a way to load multiple, maybe importLibrary should accept an array of Library names.

[chrisjshull]

It is intended to be safe to call importLibrary() multiple times. Can you file a new bug to track that (preferably with sample code that exhibits the issue)?

[owaisahmed5300]

@chrisjshull When calling multiple times importLibrary 1 by 1 with await()

// For example,
maps = await loader.importLibrary('maps');
marker = await loader.importLibrary('marker');

Previously we'd load function and we can easily pass multiple libraries directly to Loader Class Constructor but now after load function is deprecated and importLibrary() is recommended we cannot pass the multiple libraries without getting warning.

Warning: "Google Maps already loaded outside @googlemaps/js-api-loader.This may result in undesirable behavior as options and script parameters may not match."

Solved using Promise.all(): #809

[chrisjshull]

Ah, thanks. I'll comment there.