Panoramica

Seleziona la piattaforma: Android iOS JavaScript Servizio web

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

Introduzione

L'SDK Places per Android ti consente di creare app sensibili alla posizione che rispondono contestualmente alle attività locali e ad altri luoghi vicini al dispositivo dell'utente. Ciò significa che puoi creare app avanzate in base ai luoghi che hanno qualcosa di importante per l'utente, da integrare ai semplici servizi geografici offerti dai servizi di geolocalizzazione Android.

Nota: Google Maps Platform fornisce versioni separate della libreria Places per Android, iOS, JavaScript e Servizi web. Ti consigliamo di utilizzare la versione della libreria di Places specifica per la tua piattaforma. In altre parole, se sviluppi un'app Android, devi utilizzare la versione Android di Places.

Concetti

Le seguenti interfacce forniscono i punti di ingresso principali per Places SDK for Android:

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

Per luogo si intende uno spazio fisico con un nome. Un altro modo per considerare un luogo è che può esserci qualsiasi cosa che si possa trovare su una mappa. Alcuni esempi sono attività locali, punti d'interesse e località geografiche. Nell'API, un luogo è rappresentato dall'interfaccia Place. Include informazioni come il nome e l'indirizzo del luogo, la posizione geografica, l'ID del 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, l'app deve mostrare anche tutte le attribuzioni pertinenti restituite dall'API. Consulta la documentazione sulla visualizzazione delle attribuzioni.

Scegli la versione dell'SDK

L'SDK Places per Android versione 3.3.0 supporta due versioni di SDK: l'SDK Places per Android esistente e l'SDK Places per Android (nuovo), la versione di nuova generazione dell'SDK.

La prima attività consiste nel decidere quale SDK utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già l'SDK. Per conoscere le principali differenze tra le due versioni dell'SDK, consulta Scegliere la versione dell'SDK.

Prezzi per ogni versione dell'SDK

La versione scelta dell'SDK controlla i prezzi per Place Details, Text Search and Text Photos. L'SDK Places per Android (nuovo) supporta un modello di prezzi semplificato in modo che tu paghi solo per i dati che utilizzi. Per informazioni dettagliate sui prezzi di entrambi gli SDK, consulta Utilizzo e fatturazione.

Nota: i prezzi per Place Autocomplete e Current Place sono gli stessi per entrambi gli SDK.

Panoramica dell'API

Aiuta i tuoi clienti a scoprire dove si trovano e cosa li circonda:

• Il pulsante Place Autocomplete compila automaticamente il nome e/o l'indirizzo di un luogo durante la digitazione da parte degli utenti.
• Posizione corrente restituisce un elenco di luoghi in cui è nota l'ultima posizione del dispositivo dell'utente, insieme a un'indicazione della probabilità relativa per ciascun luogo.
• Place Details consente di restituire e visualizzare informazioni più dettagliate su un luogo.
• Ricerca testo restituisce i luoghi in base a una stringa di testo di ricerca. Ricerca di testo fa parte dell'SDK Places per Android (novità).
• Place Photos restituisce immagini di alta qualità di un luogo.
• Gli ID località archiviano l'ID univoco di una o più posizioni per il recupero delle informazioni sui luoghi on demand.

Nota: Google raccoglie statistiche sull'utilizzo anonime.

Norme e termini

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