Google Hotel Details
La scheda di un hotel su Google Hotels riunisce indirizzo, telefono, orari di check-in e servizi con ciò che dicono gli ospiti: la quota di ogni voto in stelle, le menzioni positive e negative su temi come la posizione o la colazione e i voti di altri siti di recensioni. Insieme ai prezzi che ogni sito di prenotazione e il sito ufficiale dell’hotel propongono per lo stesso soggiorno, serve per verificare la parità tariffaria, confrontarsi con la concorrenza e arricchire le schede degli hotel.
Funzionalità della Google Hotel Details API
- Prezzi per sito di prenotazioneoffers riporta per ogni venditore il prezzo a notte e il link di prenotazione; is_official, is_sponsored e free_cancellation_until indicano la tariffa diretta, le inserzioni a pagamento e le tariffe con cancellazione gratuita.
- Di cosa parlano gli ospitireview_topics restituisce positive_count, negative_count e mentions_count per temi come Wellness o Breakfast e mostra quali aspetti del soggiorno vengono lodati o criticati.
- Distribuzione dei voti e altri sitirating_distribution indica la quota di ogni voto in stelle, other_reviews il voto, il numero di recensioni e un estratto da siti come Tripadvisor.
- Punteggi della zonalocation_scores valuta da 1 a 5 la posizione complessiva, le attività, i ristoranti, i trasporti e l’accesso all’aeroporto, con il nome del quartiere e le coordinate.
- I dati dell’hotel in una rigaaddress, phone, website, check_in_time, check_out_time, i servizi disponibili, una descrizione e le foto arrivano insieme.
- Prezzi per le tue datecheck_in, check_out e currency stabiliscono il soggiorno a cui si riferiscono i prezzi; senza date si considera una notte a partire da domani.
Parametri della Google Hotel Details API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
hotel_id | Obbligatorio | ID hotel preso dal campo id di un risultato di Google Hotels API. |
check_in | Facoltativo | Data di arrivo (YYYY-MM-DD, oggi o successiva). Va indicata insieme a check_out; senza entrambe le date, i prezzi si riferiscono a una notte a partire da domani. |
check_out | Facoltativo | Data di partenza (YYYY-MM-DD). Deve seguire check_in; al massimo 30 notti. |
currency | Facoltativo | Codice valuta di tre lettere per i prezzi, ad esempio USD o EUR. |
location_code | Facoltativo | Codice località del mercato di ricerca. Il valore predefinito è 2840 (Stati Uniti). |
language_code | Facoltativo | Codice lingua dei dettagli dell’hotel. Il valore predefinito è en. |
Come usare la Google Hotel Details API
Invia un ID ottenuto dalla ricerca di hotel e leggi l’hotel in una sola riga.
- Invia {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} in POST a /v1/google-hotels/hotel-details.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi l’hotel in results.items. has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questo risultato di una sola riga.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Casi d’uso della Google Hotel Details API
- Verifica della parità tariffaria: Confronta la tariffa diretta contrassegnata da is_official con i prezzi delle agenzie di viaggio online per le stesse date e individua i venditori che propongono l’hotel a meno.
- Confronto con la concorrenza: Affianca rating_distribution, review_topics e location_scores di hotel vicini per vedere dove una struttura è in vantaggio e dove resta indietro.
- Schede hotel complete: Recupera con una sola richiesta indirizzo, servizi, orari di check-in, foto e punteggi della zona per arricchire le schede hotel di un servizio di viaggi.
- Analisi delle opinioni degli ospiti: Ordina review_topics per negative_count per far emergere i temi con più lamentele, come il rumore o la colazione.
Consigli degli esperti per la Google Hotel Details API
- Usa ID provenienti da una ricerca recente con Google Hotels API, così ogni richiesta da 2 crediti restituisce l’hotel atteso.
- Riprendi gli stessi check_in, check_out e currency della ricerca, così i prezzi dei venditori corrispondono al prezzo dell’elenco.
- Escludi le inserzioni a pagamento con is_sponsored prima di confrontare i venditori, per un confronto equilibrato.
- Tratta rating_distribution.share come una quota tra 0 e 1 quando rappresenti la distribuzione dei voti in un grafico.
API correlate
Oltre alla Google Hotel Details API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Hotels.
- Google Hotels API — Cerca hotel su Google Hotels per destinazione e ottieni per ciascuno la tariffa a notte per le tue date, le stelle, il voto degli ospiti, il numero di recensioni, le coordinate e l’ID.
- Hotel Price Tracker API — Recupera con un ID hotel il calendario prezzi di Google Hotels, con la tariffa a notte più bassa per ogni data di arrivo nelle prossime 6–8 settimane circa.