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.
- Domande frequenti per gli sviluppatori di Google Maps
- Termini di servizio di Google Maps Platform
- Norme per gli sviluppatori dell'API Places
L'API Places vanta inoltre una vivace community di sviluppatori. Se domande sul tuo codice, ti consigliamo di pubblicare la tua domanda nel community. Puoi trovare ulteriori informazioni su come porre domande nella pagina di assistenza.
Ricerca di 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
" fino a quando Google
dispone di dati sufficienti su un luogo per classificarlo come uno dei
tipi di luogo supportati.
Come soluzione alternativa puoi passare il luogo type
al parametro keyword
. La
Il parametro keyword
corrisponde a nome, tipo, indirizzo e recensioni dei clienti.
Per aggiungere la categoria type
a una scheda di un luogo,
inviare una modifica di luogo. Una volta che la modifica è stata
approvata e pubblicata; 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 di radius
specificato. Una ricerca nelle vicinanze
può restituire fino a 60 risultati, suddivisi in tre pagine. Se un luogo si colloca al 22° posto in 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 tua ricerca.
Puoi ordinare i risultati per distance
anziché per prominence
impostando la
Parametro rankby
nella query su distance
e omette 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 restituiti quando filtro per tipo?.
Perché ricevo al massimo due risultati quando filtro in base a alcuni types
?
L'API Places è progettata per restituire un elenco di
establishments
(qualsiasi impostazione, dalla prima
table nei tipi di luogo supportati) e fino a due località (qualsiasi posizione da
la seconda tabella di
tipi di luoghi supportati) per aiutarti a identificare l'area in cui ti trovi
una richiesta di Ricerca nelle vicinanze.
Se filtri la richiesta di Ricerca nelle vicinanze in base a una località type
, come 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 tue schede 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 lo "status": "REQUEST_DENIED"?
Il valore "status": "REQUEST_DENIED"
viene restituito dal
API Places quando:
- Non hai attivato l'API Places in 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 impostata correttamente in
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 browser o server limitazioni.
- La richiesta non è stata inviata come richiesta
HTTPS
,HTTPS
è obbligatorio per tutte le richieste dell'API Places. - Il
HTTP method
errato è stato utilizzato per inviare la richiesta:- Tutte le richieste devono essere inviate come richieste
GET
, ad eccezione di [Aggiunta di un luogo][place-add]. - Tutte le richieste per [Place Add][place-add] devono essere inviate come richiesta
POST
.
- Tutte le richieste devono essere inviate come richieste