Domande frequenti sul servizio web di Places

Questo documento contiene le risposte alle domande frequenti sull'API Places. Se non trovi 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 saperne di più su come porre domande, consulta la pagina di assistenza.

Cercare luoghi

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

È possibile che il luogo che stai cercando non sia stato ancora classificato. Tutti i luoghi sono classificati con il 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 luogo type al parametro keyword. Il parametro keyword viene abbinato a: nome, tipo, indirizzo e recensioni dei clienti.

Se vuoi aggiungere la categoria type alla 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 a prominence all'interno del radius fornito. Una richiesta Nearby Search può restituire fino a 60 risultati, suddivisi in tre pagine. Se un luogo si posiziona al 22° posto in prominence, verrà visualizzato nella seconda pagina dei risultati, a cui puoi accedere tramite la paginazione. Se un luogo si trova oltre la 60ª posizione in prominence, non verrà incluso nel risultato di ricerca, anche se è più vicino al centro della ricerca.

Puoi ordinare i risultati in base a distance anziché a 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 da location.

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

Perché ricevo al massimo due risultati quando filtro in base ad alcuni types?

L'API Places è progettata per restituire un elenco di establishments nelle vicinanze (qualsiasi elemento della prima tabella dei tipi di luoghi supportati) 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 una località type, ad esempio locality o political, i risultati 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 Profilo dell'attività.

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

Risoluzione dei problemi

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

"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 per il browser, verifica che i referrer consentiti siano corretti.
    • Se utilizzi una chiave API con limitazioni per il server, verifica che gli IP consentiti siano corretti.
    • Le chiavi API con restrizioni per Android o iOS non sono supportate. Utilizza una chiave API generica (senza restrizioni) o una chiave con restrizioni per browser o server.
  • La richiesta non è stata inviata come richiesta HTTPS, HTTPS è obbligatorio per tutte le richieste API Places.
  • È stato utilizzato un HTTP method errato per inviare la richiesta.