Panoramica

Introduzione

Places SDK per Android ti consente di creare app che rilevano la posizione e rispondono in modo contestuale alle attività locali e ad altri luoghi nelle vicinanze del dispositivo dell'utente. Ciò significa che puoi creare app ricche 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.

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 relative ai 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.

Scegli la versione dell'SDK

Le funzionalità di Places SDK for Android disponibili nella tua app sono determinate da una combinazione del numero di versione dell'SDK (ad es. 3.5.0) specificato nella configurazione dell'app, delle API abilitate sulla chiave API e del modo in cui viene inizializzata l'app. Per ulteriori informazioni sulle differenze tra Places SDK for Android e Places SDK for Android (nuovo), consulta Scegliere la versione 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 scoprire le principali differenze tra le due versioni dell'SDK, consulta Scegliere la versione dell'SDK.

Prezzi per ogni versione dell'SDK

La versione dell'SDK che attivi controlla i prezzi per l'utilizzo dell'SDK. Il nuovo SDK Places per Android supporta un modello di prezzo semplificato, in modo da pagare solo i dati che utilizzi. Per informazioni dettagliate sui prezzi sia di Places SDK for Android sia di Places SDK for Android (nuovo), consulta Utilizzo e fatturazione.

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.
• Luogo corrente restituisce un elenco di luoghi in cui si trova il dispositivo dell'utente l'ultima volta che è stato rilevato, insieme a un'indicazione della probabilità relativa per ogni luogo.
• Place Details restituisce e visualizza informazioni più dettagliate su un luogo.
• La ricerca di testo restituisce i luoghi in base a una stringa di testo di ricerca. La ricerca di testo fa parte del nuovo SDK Places per Android.
• Foto di luoghi restituisce immagini di alta qualità di un luogo.
• Gli ID luogo memorizzano l'ID univoco di uno o più luoghi per il recupero delle informazioni sui luoghi su richiesta.

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.