Domande frequenti sul servizio web di Places

Questo documento contiene le risposte alle domande frequenti sull'API Places. Se non riesci a trovare la risposta alla tua domanda qui, potresti trovare utili alcune delle seguenti pagine.

L'API Places ha anche una vivace community di sviluppatori. Se hai domande sul tuo codice, ti consigliamo di pubblicarle nella community. Per ulteriori informazioni su come porre domande, consulta la pagina dell'assistenza.

Cercare luoghi

Perché alcuni luoghi non vengono restituiti quando filtro per tipo?

È possibile che il luogo che stai cercando non sia ancora stato classificato. Tutti i luoghi sono classificati come tipo generico "establishment" finché Google non dispone di dati sufficienti su un luogo per classificarlo come uno dei tipi di luoghi supportati.

Per risolvere il problema, puoi passare il type del luogo al parametro keyword. Il parametro keyword viene abbinato a: nome, tipo, indirizzo e recensioni dei clienti.

Se vuoi aggiungere autonomamente la categoria type a una scheda di un luogo, invia una modifica del luogo. Una volta approvata e pubblicata, la modifica verrà visualizzata utilizzando il filtro type corretto.

Perché alcuni luoghi nelle vicinanze non vengono restituiti?

Per impostazione predefinita, l'API Places ordina i risultati in base alla prominence all'interno del radius fornito. Una richiesta di Nearby Search può restituire fino a 60 risultati, suddivisi in tre pagine. Se un luogo si classifica al 22° posto in prominence, verrà visualizzato nella seconda pagina dei risultati, a cui puoi accedere tramite la paginazione. Se un luogo si classifica oltre il 60° posto in prominence, non verrà incluso nel risultato di ricerca, anche se è più vicino al centro della ricerca.

Puoi ordinare i risultati in base alla distance anziché alla prominence impostando il parametro rankby nella query su distance e omettendo il parametro radius. La pertinenza verrà ignorata e i luoghi verranno restituiti in ordine di distanza dalla location.

Se filtri la richiesta per tipo, alcuni risultati potrebbero essere esclusi dalla risposta. Per ulteriori informazioni, consulta la voce delle domande frequenti: Perché alcuni luoghi non vengono restituiti quando filtro per tipo?.

Perché ricevo al massimo due risultati quando filtro per alcuni types?

L'API Places è progettata per restituire un elenco di establishments (qualsiasi elemento della prima tabella dei tipi di luoghi supportati) nelle vicinanze e fino a due risultati di località (qualsiasi elemento della seconda tabella dei tipi di luoghi supportati) per aiutarti a identificare l'area per cui stai eseguendo una richiesta di Nearby Search.

Se filtri la richiesta di Nearby Search in base a un type di località, ad esempio locality o political, i risultati di establishment verranno esclusi.

Dati luogo

Come faccio ad aggiungere o modificare i luoghi?

Se sei il proprietario di un'attività, puoi aggiungere, verificare e gestire le schede della tua attività su Google Maps utilizzando il profilo dell'attività.

Se non sei il proprietario del luogo, puoi comunque suggerire modifiche.

Risoluzione dei problemi

Perché continuo a ricevere "status": "REQUEST_DENIED"?

L'"status": "REQUEST_DENIED" viene restituito dall'API Places quando:

  • Non hai attivato l'API Places nella console Google Cloud.
  • Il parametro key non è presente nella richiesta.
  • Il parametro key non corrisponde alla chiave API nella console Google Cloud.
  • La chiave API non è stata configurata correttamente nella console Google Cloud:
    • Se utilizzi una chiave API con limitazioni del browser, controlla che i referrer consentiti siano corretti.
    • Se utilizzi una chiave API con limitazioni del server, controlla che gli IP consentiti siano corretti.
    • Le chiavi API con limitazioni per Android o iOS non sono supportate. Utilizza una chiave API generica (senza limitazioni) o una chiave con limitazioni del browser o del server.
  • La richiesta non è stata inviata come richiesta HTTPS. HTTPS è obbligatorio per tutte le richieste dell'API Places.
  • È stato utilizzato il HTTP method errato per inviare la richiesta.