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

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

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.

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.

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.

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.