O AdvancedPlaceListElement é um elemento HTML que renderiza uma coleção de lugares em uma lista com base nos nomes de recursos de lugar.
O elemento de lista de lugares avançado oferece recursos avançados, incluindo a personalização de botões de ação, a configuração de atribuição de lugar e o tratamento de erros.
Tokens para apps agênticos
O token de visualização de dados agênticos permite que seu app agêntico mostre elementos do Kit de Interface do Places para os lugares em uma resposta da ferramenta de agentes Maps Experience (antigo Maps Grounding Lite) sem custo financeiro adicional. Para mais informações, consulte Token de visualização de dados de agentes.
Uso básico
Para usar o componente, adicione um elemento <gmp-advanced-place-list>
à sua página e transmita uma lista separada por espaços de nomes de recursos de lugar
pelo atributo places.
Confira um exemplo de código completo
TypeScript
async function init() { await google.maps.importLibrary('places'); await customElements.whenDefined('gmp-advanced-place-list'); const listElement = document.querySelector('gmp-advanced-place-list'); if (listElement) { listElement.addEventListener('gmp-error', (e: Event) => { const customEvent = e as CustomEvent<{ errors?: unknown }>; console.error( 'Failed to load places: ', customEvent.detail.errors ?? customEvent ); }); } } void init();
JavaScript
async function init() { await google.maps.importLibrary('places'); await customElements.whenDefined('gmp-advanced-place-list'); const listElement = document.querySelector('gmp-advanced-place-list'); if (listElement) { listElement.addEventListener('gmp-error', (e) => { const customEvent = e; console.error( 'Failed to load places: ', customEvent.detail.errors ?? customEvent ); }); } } void init();
CSS
html, body { height: 100%; margin: 0; padding: 0; font-family: Roboto, Arial, sans-serif; }
HTML
<!doctype html>
<html>
<head>
<title>Advanced Place List</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link rel="stylesheet" type="text/css" href="style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY",
v: "beta"
});
</script>
</head>
<body>
<gmp-advanced-place-list
places="places/ChIJLU7jZClu5kcR4PcOOO6p3I0 places/ChIJrRMgU7ZhLxMRxAOFkC7I8Sg places/ChIJbf8C1yFxdDkR3n12P4DkKt0 places/ChIJPTacEpBQwokRKwIlDXelxkA places/ChIJVVVViV-abZERJxqgpA43EDo">
<template slot="details-item">
<gmp-place-name></gmp-place-name>
<gmp-place-address></gmp-place-address>
<gmp-place-media query="coffee"></gmp-place-media>
</template>
</gmp-advanced-place-list>
</body>
</html>Testar amostra
Recursos avançados
Personalizar botões de ação
Adicione botões de ação como filhos dentro do elemento <template slot="details-item"> do componente Lista de Lugares Avançada. Use <gmp-place-link> para conexões de navegação
padrão e especifique explicitamente o atributo
action. Também é possível especificar o atributo slot. As ações predefinidas válidas são open-website, open-directions, open-map e call. Se
o atributo slot for omitido, o padrão será
action-main.
<gmp-advanced-place-list places="places/ChIJT7FdmYiAhYAROFOvrIxRJDU">
<template slot="details-item">
<gmp-place-name></gmp-place-name>
<gmp-place-link action="open-website" target="_blank"></gmp-place-link>
<gmp-place-link action="open-directions" slot="action-corner"></gmp-place-link>
</template>
</gmp-advanced-place-list>Configurar a atribuição de lugar
Para configurar a atribuição visual, adicione um elemento <gmp-place-attribution> para mostrar as configurações gerais de atribuição de dados da API Maps, como a origem de uma foto ou avaliação.
Ele precisa ser adicionado como um irmão direto do <template>.
As atribuições colocadas dentro do elemento <template>
serão ignoradas.
<gmp-advanced-place-list places="places/ChIJT7FdmYiAhYAROFOvrIxRJDU">
<template slot="details-item">
<gmp-place-name></gmp-place-name>
</template>
<gmp-place-attribution light-scheme-color="black" dark-scheme-color="gray"></gmp-place-attribution>
</gmp-advanced-place-list>Solucionar erros
Você pode detectar o evento gmp-error para lidar de forma adequada com cenários em que um ou mais lugares solicitados não são carregados.
const listElement = document.querySelector('gmp-advanced-place-list'); listElement.addEventListener('gmp-error', (e) => { // e.detail.errors contains an array of failure objects with specific failed Resource Names console.error('Failed to load places: ', e.detail.errors); });