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 pagine che seguono.

L'API Places ha anche una vivace community di sviluppatori. Se hai domande sul tuo codice, ti consigliamo di pubblicarle nella community. Puoi trovare maggiori informazioni su come porre domande nella pagina 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 di tipo generico "establishment" finché Google non dispone di dati sufficienti su un luogo per classificarlo come uno dei tipi di luoghi supportati.

Come soluzione alternativa, puoi passare il luogo type al parametro keyword. Il parametro keyword viene associato a: nome, tipo, indirizzo e recensioni dei clienti.

Se vuoi aggiungere la categoria type a una scheda del 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 di Ricerca nelle vicinanze può restituire fino a 60 risultati, suddivisi in tre pagine. Se un luogo si trova al 22° posto a prominence, verrà visualizzato nella seconda pagina dei risultati, a cui puoi accedere tramite la paginazione. Se un luogo ha un ranking superiore al 60° in prominence, non verrà incluso nel risultato di ricerca, anche se è più vicino al centro della ricerca.

Puoi ordinare i risultati per distance anziché 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 ulteriori informazioni, consulta la voce delle domande frequenti Perché alcuni luoghi non vengono riportati quando filtro per tipo?.

Perché ricevo al massimo due risultati quando filtro in base a un determinato types?

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

Se filtri la richiesta di Ricerca nelle vicinanze 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 tua chiave API nella console Google Cloud.
  • La chiave API non è stata configurata correttamente nella console Google Cloud:
    • Se utilizzi una chiave API limitata al browser, controlla che i referer consentiti siano corretti.
    • Se utilizzi una chiave API limitata al server, verifica che gli IP consentiti siano corretti.
    • Le chiavi API con limitazioni per Android o iOS non sono supportate. Utilizza una chiave API generica (senza restrizioni) o una chiave con limitazioni per browser o server.
  • La richiesta non è stata inviata come richiesta HTTPS, HTTPS è obbligatorio per tutte le richieste dell'API Places.
  • Per inviare la richiesta è stato utilizzato HTTP method errato.