Panoramica

Seleziona la piattaforma: Android iOS JavaScript Web Service

Prima di iniziare: prima di iniziare a utilizzare l'SDK Places per Android, devi avere un progetto con un account di fatturazione e aver attivato l' API Places l' . Ti consigliamo di creare più proprietari di progetto e amministratori della fatturazione, in modo da avere sempre a disposizione qualcuno con questi ruoli per il tuo team. Per scoprire di più, consulta Configurazione in Cloud Console.

Introduzione

Places SDK per Android ti consente di creare app che rilevano la posizione e rispondono in base al contesto alle attività locali e ad altri luoghi nelle vicinanze del dispositivo dell'utente. Ciò significa che puoi creare app complete in base a luoghi che hanno un significato per l'utente, per integrare i semplici servizi basati sulla posizione offerti dai Servizi di geolocalizzazione Android.

Nota: Places SDK (nuovo) è la versione corrente di Places SDK for Android. L'SDK Places è ora legacy e non può più essere attivato. La documentazione e le guide alla migrazione legacy sono disponibili nella scheda Legacy.

Concetti

Le seguenti interfacce forniscono i punti di contatto principali per l'SDK Places per Android:

• Places fornisce accesso programmatico al database di Google di informazioni su attività e luoghi locali, nonché alla posizione attuale del dispositivo.
• Autocomplete fornisce widget predefiniti per restituire le previsioni dei luoghi in risposta alle query di ricerca degli utenti.

Un luogo è definito come uno spazio fisico che ha un nome. Un altro modo di pensare a un luogo è che si tratta di qualsiasi elemento che puoi trovare su una mappa. Alcuni esempi sono attività locali, punti d'interesse e località geografiche. Nell'API, un luogo è rappresentato dall'interfaccia Place. Sono incluse informazioni quali il nome del luogo e il suo indirizzo, la posizione geografica, l'ID luogo, il numero di telefono, il tipo di luogo, l'URL del sito web e altro ancora.

Nota: ogni volta che la tua app mostra informazioni sui luoghi provenienti dall'SDK Places per Android, deve mostrare anche tutti gli attributi pertinenti restituiti dall'API. Consulta la documentazione sulla visualizzazione delle attribuzioni.

Panoramica dell'API

Aiuta i tuoi clienti a scoprire dove si trovano e cosa c'è nelle vicinanze:

• La funzionalità Completamento automatico dei luoghi completa automaticamente il nome e/o l'indirizzo di un luogo man mano che gli utenti digitano.
• Place Details restituisce e visualizza informazioni più dettagliate su un luogo.
• La Ricerca nelle vicinanze restituisce un elenco di luoghi in base a una località e a un raggio di ricerca.
• Foto di luoghi restituisce immagini di alta qualità di un luogo.
• La ricerca di testo restituisce i luoghi in base a una stringa di testo di ricerca.
• Gli ID luogo memorizzano l'ID univoco di uno o più luoghi per il recupero delle informazioni sui luoghi su richiesta.

Nota: Google raccoglie statistiche anonime sull'utilizzo.

Norme e termini

Tutte le applicazioni che utilizzano l'SDK Places per Android devono rispettare i requisiti descritti nei Termini di servizio di Google Maps Platform, Utilizzo e fatturazione e Visualizzazione delle attribuzioni.